Notificações

Para que serve

Esta tela define para onde e como o Sentinela avisa quando um sensor dispara um alerta. Você organiza os avisos em Grupos de alerta e, dentro de cada grupo, ativa um ou mais canais de envio (Telegram, e depois WhatsApp, E-mail e SMS). Cada sensor com gatilho escolhe qual grupo será notificado, então um mesmo alerta pode ir para times diferentes (ex.: um grupo "NOC", outro "Plantão").

A tela tem três áreas: a coluna da esquerda lista os grupos; o topo do painel mostra o nome do grupo selecionado e seus botões; e as abas de canais abrem a configuração de cada meio de envio.

Grupos de alerta (coluna esquerda)

• Lista de grupos — cada 🔔 é um grupo. Clique para selecioná-lo e editar seus canais.
• ＋ Novo grupo — cria um grupo. Pede o nome e já abre na aba Telegram.
• O grupo Padrão (id 1) não pode ser excluído — ele é o destino de reserva.

Cabeçalho do grupo

• ✏️ (Renomear) — troca o nome do grupo selecionado.
• 🗑 (Excluir grupo) — apaga o grupo. Aparece só quando não é o Padrão. Aviso: os sensores que usavam esse grupo voltam automaticamente para o grupo Padrão.

Abas de canais

Logo abaixo do nome ficam as abas dos canais: 📱 Telegram, 💬 WhatsApp, ✉️ E-mail e 📲 SMS. Só o Telegram está com envio ativo; os demais aparecem marcados como em breve. Um canal já configurado mostra o selo ativo na aba.

Configuração de um canal

Ao abrir uma aba, o painel mostra:

• Ativar (interruptor) — liga/desliga o envio por aquele canal, naquele grupo.
• 🔔 Testar — dispara uma mensagem de teste imediata para todos os destinatários do canal. O resultado aparece ao lado do botão Salvar (ex.: Enviado para 3 destinatário(s)).
• Alertar sobre — três caixas de nível: 🟢 Normal, 🟠 Aviso e 🔴 Crítico. Marque os níveis que devem gerar mensagem neste canal (ex.: deixar só Crítico no SMS e tudo no Telegram).
• Template de mensagem — escolhe qual modelo de texto será usado. O botão ✏️ Editar templates abre o editor (veja abaixo).

Bot do Telegram (só na aba Telegram)

Um único bot atende todos os grupos. Configure-o uma vez:

• Token do bot — abra o @BotFather no Telegram, envie /newbot, siga os passos e cole aqui o token (formato 123456789:ABCdef...). Depois de salvo, o campo mostra pontinhos (o token fica guardado, não é reexibido).
• Código de vínculo (deste grupo) — código único do grupo (ex.: SENT-ABC123) usado pelas pessoas para se vincularem. O botão 🎲 gera um código novo aleatório.
• Após salvar o token, aparece o link do seu bot (@seubot) para compartilhar.

Destinatários

Para o Telegram os destinatários se cadastram sozinhos usando o código de vínculo:

• No privado: a pessoa abre o bot, aperta Start e manda apenas o código do grupo.
• Em um grupo do Telegram: adicione o bot ao grupo e envie /vincular SENT-XXXX (dentro de grupos o bot só responde a comandos).

Para os canais que digitam o destino (e-mail/SMS, quando liberados) há um campo para ＋ Adicionar o endereço/telefone. Cada destinatário vinculado aparece em lista com o botão 🗑 para remover.

Editor de templates de mensagem

Abre em janela sobreposta a partir de ✏️ Editar templates. À esquerda ficam os modelos existentes e ＋ Novo template; no centro, os campos Nome e Corpo da mensagem; à direita, as Variáveis clicáveis.

• Variáveis — clique em uma para inserir no ponto do cursor. Disponíveis: icone, estado, dispositivo, ip, descricao, sensor, valor, limite, mensagem, datahora, grupo (escritas entre chaves duplas no corpo).
• Formatação — negrito com <b>texto</b>. Condições com blocos #if / else / /if usando as flags recuperado e disponibilidade (ex.: mensagem diferente quando o alerta é de recuperação).
• 💾 Salvar grava o template; 👁 Pré-visualizar renderiza o texto com dados de exemplo; 🗑 Excluir remove (o template padrão id 1 não pode ser excluído).

Passo a passo típico

1. Na aba Telegram, cole o token do @BotFather e clique em Salvar.
2. Ative o interruptor do canal e marque os níveis desejados.
3. Gere/mostre o código de vínculo e peça às pessoas para vincularem no bot.
4. Use 🔔 Testar para confirmar que a mensagem chega.
5. Nos sensores, aponte o gatilho para este grupo de alerta.

Dicas

• Crie grupos por finalidade (NOC, Plantão, Gerência) e ajuste os níveis por canal para evitar excesso de mensagens.
• Se ninguém recebe o teste, confira se o token foi salvo, se o canal está ativo e se há destinatários vinculados com o código correto.