Manual do Usuário

1Visão geral

O SIGEEDU Comunica (mensagem.semecol.com.br) envia mensagens pelo número de um celular do local: por RCS (o "chat" do Mensagens do Google, com confirmação de leitura e sem custo de SMS), por SMS ou pelo WhatsApp.

2Acesso e níveis

Entre em mensagem.semecol.com.br com o seu usuário do SIGEEDU. A permissão é do módulo persms, por local (as instituições da sua permissão):

Quem não tem o módulo ou tem nível 5 vê a tela Sem permissão. Sem nenhum local na permissão aparece o aviso "Seu usuário não tem nenhum local no módulo persms".

3Conhecendo a tela

• Menu lateral: Painel, Enviar mensagens, Fila e histórico, Modelos, Celulares, App no celular, API e chaves (nível 3+), Atividade e log e o Manual. Minimizar deixa só os ícones (o sistema lembra).
• Local: no alto de todas as telas. Tudo o que você vê e faz é do local escolhido; o sistema lembra o último.
• Tema claro/escuro: o botão sol/lua no menu. Sem escolher, segue o tema do aparelho.
• No celular: a barra de cima tem Painel, Enviar, Fila e App; o resto fica no ⋮.

4Painel

Mostra as mensagens de hoje (enviadas, na fila, com erro, puladas), quantos celulares estão online e um cartão para cada celular: último sinal, o que ele consegue enviar (acessibilidade, Mensagens/RCS, SMS direto, WhatsApp) e quantas enviou hoje do limite. Atualiza sozinho a cada 15 segundos.

5Enviar mensagens

1. Para quem: cole a lista (um contato por linha) ou Importar planilha (Excel ou CSV). A 1ª coluna é o número. Se a 1ª linha tiver os nomes das colunas (numero;nome;data_reuniao), cada coluna vira uma variável. Sem cabeçalho: número; nome; mensagem própria.
2. Tipo: SMS + RCS (tenta RCS; quem não tem recebe SMS), Só RCS (quem não tem é pulado), Só SMS (direto pelo chip) ou WhatsApp.
3. Modelo (opcional): com modelo, Baixar planilha deste modelo traz um Excel com as colunas certas para preencher e importar. Abaixo da mensagem aparece o tamanho (caracteres e partes de SMS: 160 por parte, ou 70 com acento/emoji).
4. Dispositivo: Automático ou um celular/canal específico. Se não conseguir, tentar também: SMS, WhatsApp ou e-mail, nessa ordem. Tipo E-mail precisa de uma coluna email.
5. Modelo (opcional) ou Mensagem. Variáveis automáticas: {{data}}, {{hora}}, {{telefone}}. A Prévia mostra como fica para o primeiro contato; variável em vermelho = falta a coluna.
6. Pôr na fila. As linhas com problema (número inválido, variável faltando) aparecem numa janela, com o motivo; as outras entram na fila.

6Fila e histórico

Todas as mensagens do local, de qualquer origem (Gestão, API ou URL). Filtros: busca (número, nome, texto, lote), situação, tipo e período. ao vivo atualiza a cada 10 s. Clique na linha para ver tudo da mensagem.

Marque e use Cancelar (só pendentes) ou Reenviar (erro, pulada ou cancelada voltam para a fila). Excel exporta até 5.000 linhas do filtro.

7Modelos

Textos prontos do local. Código (ex.: aviso_reuniao, usado na API), nome, tipo padrão e o texto com variáveis entre chaves duplas: Olá {{nome}}, a reunião será em {{data_reuniao}}. A janela mostra as variáveis e um exemplo pronto de chamada da API. Modelo inativo não é aceito pela API.

8Celulares

Os celulares vinculados ao local. Nível 3+ edita (edit): nome, intervalo entre mensagens (sorteado entre o mínimo e o máximo; padrão 20–45 s), limite por dia (padrão 300), espera do RCS, os tipos que ele envia e se está ativo. Excluir: a mensagem que ele estiver enviando volta para a fila.

9Configurações (intervalo, pausas, horário)

Aba Configurações (altera: nível 3 ou 4). Vale para todos os celulares do local; em Celulares cada um pode mudar só o que precisar (campo vazio = segue o local; o valor do local aparece apagado no campo).

O topo da aba diz se agora está dentro ou fora do horário. Os celulares recebem a configuração nova no próximo contato (segundos).

10App no celular (instalar e configurar)

Baixar

Na aba App no celular (no computador) há o botão Baixar o APK e o QR Code. Android 8 ou mais novo.

Configurar

1. Abra o app SIGEEDU Comunica e entre com o seu usuário.
2. Na aba App no celular aparece a lista do que falta, com um botão para cada item: Mensagens do Google instalado e como app de SMS padrão; Recursos de chat (RCS) ativos; acessibilidade do SIGEEDU Comunica ligada (se a chave estiver cinza: Configurações › Apps › SIGEEDU Comunica › ⋮ › Permitir configurações restritas); bateria sem restrições; notificações; tela sem senha; e, se for usar, permissão de SMS e WhatsApp.
3. Escolha o Local, dê um nome e toque em Vincular este celular (nível 3+).
4. Deixe o celular na tomada, com bloqueio de tela "Nenhum": ele busca e envia sozinho (funciona no Wi-Fi ou no 4G). Uma notificação fixa mostra o que ele está fazendo.
5. Segundo plano: não precisa deixar o app aberto. Ele volta sozinho ao ligar o celular. Depois de cada envio ele não abre a própria tela: volta à tela inicial ou apaga a tela (veja Configurações). RCS e WhatsApp abrem a conversa por alguns segundos; o tipo Só SMS não abre nada.

Pausar para de pegar mensagens; Desvincular desliga este celular (o cadastro continua em Celulares). Diagnóstico: abre a conversa com um número, escreve um teste e apaga sem enviar, mostrando o que o app enxergou (útil quando o RCS não é reconhecido).

11API e chaves (outros sistemas)

Na aba API e chaves (nível 3+) crie uma chave para cada sistema (ex.: "n8n da Secretaria"). A chave aparece uma vez só: copie e guarde. Marque aceitar na URL só para quem não consegue mandar cabeçalho.

Endereço: https://mensagem.semecol.com.br/api/enviar (também por http://). Campos: numero, tipo (sms, whatsapp, rcs, sms_puro), mensagem ou modelo e as variáveis. A aba traz exemplos prontos (JSON, tabela, URL, curl) e as rotas para acompanhar (/api/status/{id}, /api/lote/{lote}, /api/cancelar, /api/modelos, /api/saude). Com callback_url, o celular avisa o seu sistema quando a mensagem terminar.

12Quem vê as mensagens e mensagens sigilosas

• Níveis 3 e 4 veem todas as mensagens do local e mudam as Configurações.
• Níveis 1 e 2 veem só as mensagens que eles mesmos puseram na fila (aviso no alto da Fila). Em Configurações, o nível 3/4 pode ligar "Níveis 1 e 2 veem todas as mensagens do local". A regra é conferida no banco, não só na tela.
• Sigilosa (códigos, senhas): marque Mensagem sigilosa em Enviar, ou use a API /api/sigilosa/enviar. O texto aparece como *** para todos (inclusive níveis 3 e 4 e a API de status) e é apagado do banco quando a mensagem termina. Sigilosa não pode ser reenviada. A conversa no celular/WhatsApp que enviou continua tendo o texto.

13Celulares e canais (WhatsApp por QR, API externa, e-mail)

Celulares › Incluir (nível 3 ou 4):

Em cada celular/canal: Envia mensagens da API e Envia da tela Enviar mensagens (liga/desliga cada origem) e Ritmo e limite por tipo (intervalo e limite por dia de SMS, RCS, WhatsApp e e-mail; vazio = segue as Configurações).

14Esqueci minha senha (código)

O código do "Esqueci minha senha" do login passa pelo SIGEEDU Comunica: sigiloso e prioritário, tentando WhatsApp → RCS → SMS → e-mail (se um não conseguir em 45 s, vai o próximo). O telefone vem do cadastro (user_telefone) e o e-mail, do usuário.

15Botão Ajuda

O botão Ajuda (canto de baixo, à direita) abre um passo a passo animado da tela em que você está: App no celular, Enviar mensagens, Modelos, Celulares e API e chaves. Nas outras telas ele some.

16Atividade e log

Online agora (todos os níveis): quem está com a gestão aberta, em que tela e fazendo o quê. Registro de atividades (só níveis 3 e 4): quem fez o quê e quando — entrar/sair, mensagens postas na fila pela gestão (uma linha por lote, com a quantidade), cancelar/reenviar, celulares vinculados/alterados/excluídos, modelos e chaves criados/alterados/excluídos, APK baixado, diagnóstico e Excel. Filtros por período, pessoa, ação e texto; Excel exporta até 5.000 linhas.

17Mensagens do sistema

18Perguntas frequentes

A mensagem sai do meu número? Sai do número do chip (ou do WhatsApp) do celular vinculado ao local.

Preciso deixar o celular desbloqueado? Ele precisa estar sem senha (bloqueio "Nenhum" ou "Deslizar"); o app acende a tela sozinho. Use um celular só para isso.

Posso usar dois celulares no mesmo local? Sim: o que estiver livre pega a próxima mensagem, e as mensagens de WhatsApp só vão para quem tem WhatsApp.

O RCS é grátis? RCS usa a internet do celular. Quando o contato não tem RCS e o tipo é SMS + RCS, sai SMS (custo do plano do chip).

19Glossário

RCS: o "chat" do Mensagens do Google (texto pela internet, com confirmação de leitura). Lote: o grupo de mensagens postas de uma vez. Chave da API: a senha que um sistema usa para mandar mensagens de um local. Vincular: ligar um celular a um local.