Base de conhecimentoUtilizar
Alarmes e Mensagens
Regras de alarme nas tags, perda de comunicação e previsões; depois, quem é avisado e como — gateways, contactos, listas de escalada, confirmação por resposta — com o Telegram configurado passo a passo.
Há duas partes que trabalham em conjunto. As regras de alarme decidem quando algo está mal; ficam no equipamento. As Mensagens decidem quem é avisado e como, e continuam a avisar a pessoa seguinte até alguém confirmar. O serviço de alarmes verifica as regras a cada poucos segundos, quer alguém tenha a plataforma aberta, quer não.
Regras de alarme numa tag
Em Equipamento → Monitorização e Alarmes → Alarmes de Tag, cada tag mapeada pode ter várias regras. Cada regra tem:
- Nome e severidade — Crítico, Aviso ou Info, mostrada onde quer que o alarme apareça; e uma categoria de alarme.
- Tipo de valor — Numérico (comparar com um limite), Digital (um flanco ascendente 0→1 ou descendente 1→0) ou Totalizador (a quantidade num período).
- Condição — um operador (
<,<=,=,>,>=,!=) e um limite. - Histerese — depois de ativo, o alarme mantém-se até o valor voltar a passar o limite com esta margem, para que um sinal com ruído encostado ao limite não fique a ligar e desligar.
- Atraso (opcional, regras numéricas, fontes em tempo real) — a condição tem de se manter durante este tempo antes de o alarme ser gerado, por exemplo um valor a 0 durante mais de 10 minutos. Até 7 dias.
O atraso só é oferecido em equipamentos lidos em tempo real (Modbus TCP, OPC UA, IEC 104, MQTT). Um datalogger entrega as leituras em lotes, muitas vezes horas depois; uma condição que começou e terminou dentro de um ficheiro seria invisível para uma verificação que espera que ela se mantenha. Nos equipamentos com ficheiros, use um limite simples, com histerese se oscilar — cada passagem de limite dentro de um ficheiro entregue continua a gerar o seu alarme, com a hora da leitura.
Uma regra nova ou alterada aplica-se aos valores recebidos depois da alteração.
Outros tipos de alarme
- Perda de comunicação. Cada equipamento tem um tempo limite de comunicação (dias, horas, minutos). Com o alarme de perda de comunicação ativo, um equipamento em silêncio gera um alarme que se fecha sozinho quando os dados voltam. O mesmo tempo limite põe o equipamento a cinzento na árvore de ativos e no mapa.
- Curvas de operação. Uma regra de curva vigia a relação entre duas tags — o caudal de uma bomba face à pressão — e gera um alarme quando o ponto sai de uma banda de tolerância em torno da curva esperada: um sinal precoce de desgaste ou colmatação. Uma curva pode ser um modelo partilhado por muitas bombas iguais.
- KPI de site. Uma virtual tag de local com objetivo e tolerância pode gerar um alarme quando sai da sua banda.
- Alarmes de previsão (módulo Previsão). Uma regra sobre a previsão dispara quando a previsão passa um limite dentro de uma janela à frente — antes de o valor medido lá chegar. Indica quando a passagem está prevista e o pico previsto, e vive na mesma lista de alarmes, confirmação e Mensagens que todos os outros.
Confirmar
Confirmar diz ao sistema — e aos colegas — que alguém está a tratar do assunto, e interrompe a escalada. Não fecha o alarme: um alarme mantém-se ativo até o valor voltar ao normal.
- Na plataforma: por alarme, por equipamento (Confirmar todos no equipamento), ou tudo (Confirmar todos no topo da árvore de ativos), e na lista de alarmes do Painel.
- Respondendo no Telegram:
ack,ok,sim,confirmo, ✅ ou 👍 na conversa para onde o alerta foi enviado, ou uma resposta à própria mensagem do alerta. - Respondendo a um alerta do gateway de SMS com o código da mensagem (
ACK-…).
Mensagens: as peças
Está tudo no Centro de Mensagens.
Gateways (separador Configuração)
Os canais por onde o SyncTide envia. Acrescente um com Adicionar gateway, marque-o como ativo (e, se quiser, como predefinido), grave e use o Envio de teste para o verificar.
| Gateway | Canal | O que precisa |
|---|---|---|
| SMTP | Host, porta, TLS, nome de utilizador, palavra-passe, endereço do remetente | |
| Telegram Bot | Telegram | O token do bot dado pelo @BotFather |
| Twilio ou Meta WhatsApp | As credenciais da conta e o número remetente | |
| Router Teltonika RUT | gateway de SMS | O endereço do router, nome de utilizador, palavra-passe e modem |
| HTTP genérico | O seu próprio gateway | URL, método, cabeçalhos e um modelo do corpo |
No Gmail, use uma palavra-passe de aplicação (Conta Google → Segurança → Verificação em dois passos → Palavras-passe de aplicações) com smtp.gmail.com, porta 587 e TLS — não a palavra-passe da conta. Os relatórios agendados também são enviados por email através do gateway SMTP.
Contactos
As pessoas que são avisadas: nome, número de telefone, endereço de email e ID de conversa do Telegram, e um interruptor de ativo — os contactos inativos são ignorados.
Listas de escalada
A ordem pela qual os contactos são avisados. Cada membro tem uma prioridade e um atraso: os membros são avisados por ordem de prioridade, cada um depois do seu atraso, até alguém confirmar. Uma lista pode escalar para outra lista (outra equipa) quando ninguém responde — por exemplo, uma lista do turno da noite que escala para os supervisores.
Regras de alarme (Mensagens)
Uma regra das Mensagens liga os alarmes a uma lista de escalada:
| Definição | O que faz |
|---|---|
| Âmbito | Um equipamento e uma tag, uma categoria de alarme inteira, ou um KPI de site |
| Lista de escalada | Quem é avisado, e por que ordem |
| Tipo de canal | Forçar um canal, ou Qualquer para usar o de cada contacto |
| Período de espera (min) | O tempo mínimo entre duas mensagens do mesmo alarme |
| Máximo de escaladas | Quantos passos percorrer antes de parar |
| Exigir confirmação / Tempo limite de confirmação (s) | Esperar este tempo por uma confirmação antes de avançar (300 s por omissão) |
| Modelo de mensagem | O texto, com $device_name, $tag_name, $value, $unit, $operator, $threshold, $timestamp |
Os alarmes de previsão podem usar também $predicted_for, $lead_time, $predicted_peak e $confidence.
O separador Histórico lista todas as mensagens com o seu estado — pendente, enviada, entregue, falhada, confirmada — e as mensagens que falham são enviadas de novo.
Telegram, passo a passo
O Telegram não tem custo por mensagem e não precisa de cartão SIM.
- Criar o bot (uma vez). No Telegram, abra o @BotFather, envie
/newbot, escolha um nome visível e um nome de utilizador terminado embot. Copie o token que recebe (1234567890:ABC…) — trate-o como uma palavra-passe. - Cada destinatário instala o Telegram, descobre o seu ID de conversa (por exemplo com o
@userinfobot), abre o seu bot e carrega em Start — um bot não pode escrever a quem nunca o iniciou. O guia para destinatários explica cada passo. - Acrescente o gateway: Centro de Mensagens → Configuração → Adicionar gateway, tipo Telegram Bot, cole o token, mantenha o modo de formatação HTML, ativo.
- Acrescente um contacto por destinatário, com o ID de conversa.
- Ligue-os numa lista de escalada e numa regra das Mensagens e envie uma mensagem de teste.
Para um grupo de piquete partilhado: adicione o bot ao grupo, envie lá uma mensagem, abra https://api.telegram.org/bot<TOKEN>/getUpdates e copie o ID de conversa do grupo — os IDs de grupo são negativos, mantenha o sinal menos.
| Erro do Telegram | Causa | Solução |
|---|---|---|
Forbidden: bot can't initiate conversation with a user |
O destinatário nunca iniciou o bot | Peça ao destinatário que abra o bot e carregue em Start. |
Bad Request: chat not found |
ID de conversa errado, ou o ID de uma pessoa usado para um grupo | Confirme o ID com o destinatário |
Unauthorized |
Token do bot errado | Copie-o de novo do @BotFather (/mybots → API Token) |
Bad Request: can't parse entities |
O modelo de mensagem quebra o modo de formatação HTML | Retire do modelo os caracteres problemáticos |
O guia completo do administrador está na transferência Configuração do Telegram (em inglês).