Todos os guias

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 Email 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 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.

  1. Criar o bot (uma vez). No Telegram, abra o @BotFather, envie /newbot, escolha um nome visível e um nome de utilizador terminado em bot. Copie o token que recebe (1234567890:ABC…) — trate-o como uma palavra-passe.
  2. 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.
  3. Acrescente o gateway: Centro de Mensagens → Configuração → Adicionar gateway, tipo Telegram Bot, cole o token, mantenha o modo de formatação HTML, ativo.
  4. Acrescente um contacto por destinatário, com o ID de conversa.
  5. 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).