Notificações (WhatsApp)¶
Alertas da rede por WhatsApp, por Evolution API ou WAHA: os dois ficam num servidor externo, e o NOC FTTH só se conecta. Um provedor fica ativo de cada vez; se um der problema, troca-se o outro na tela, sem mexer em código.
Configurar¶
Admin → Notificações → WhatsApp: configuração
| Campo | Evolution API | WAHA |
|---|---|---|
| Endereço | https://servidor-da-evolution |
https://servidor-do-waha |
| Chave | apikey (cifrada no banco; em branco mantém) |
X-Api-Key (cifrada; em branco mantém) |
| Instância / sessão | nome da instância | nome da sessão (padrão default) |
Endereço do NOC (ex.: https://noc.exemplo.com.br): vira link nas mensagens. No aviso de
pendente, o link abre o mapa já no Provisionar; no de rompimento, abre a caixa. Vazio = sem link.
Provedor ativo: Evolution API, WAHA ou Desligado. O botão Testar conexão confere os
dois que tiverem endereço: a instância da Evolution precisa estar open; a sessão do WAHA,
WORKING.
Destinos (Admin → Notificações → Destinos): para quem vão os alertas.
- Número ou grupo: pessoa = DDI+DDD+número só com dígitos (
5567999990000); grupo = o ID do grupo (termina em@g.us). - VLANs: vazio = equipe (recebe tudo). Com VLANs, o destino só recebe alertas dos clientes delas, e a mensagem só lista esses clientes. É assim que um parceiro recebe só o que é dele.
- O que recebe: ONU pedindo autorização (só destinos da equipe), rompimento, queda individual, cliente ativado (desmarcado por padrão).
- Enviar mensagem de teste (botão na ficha do destino).
Envios: histórico de cada mensagem, com sucesso ou o erro do provedor.
Alertas¶
A rotina WhatsApp: enviar alertas roda a cada minuto (Admin → Rotinas agendadas).
| Alerta | Quando | Para quem |
|---|---|---|
| 🔔 ONU pedindo autorização | a OLT acusa uma ONU nova; repete a cada N minutos (padrão 30) até M avisos (padrão 3) enquanto ninguém autoriza | destinos da equipe |
| ⚠️ Possível rompimento | N ou mais ONUs da mesma caixa (padrão 3) caem na mesma leitura das OLTs; uma mensagem só, com os clientes | equipe e parceiros (cada um vê os seus) |
| ✅ Normalizou | o mesmo número de ONUs da caixa volta junto | idem |
| 🔴 ONU caiu (desligado por padrão) | as demais quedas, uma mensagem cada | destinos que marcarem |
| 🟢 Cliente ativado (desmarcado por padrão) | ONU autorizada no Provisionar, ou vinculada a um cliente quando estava sem descrição; edições depois disso não avisam | destinos que marcarem (com VLANs: só os clientes delas) |
Modelo do Cliente ativado (serve de registro das instalações):
🟢 *Cliente ativado*
*Maria Silva*
VLAN 3030 (Parceiro A)
CTO-01 · porta 4 — Rua das Flores, 120
OLT-01 · PON 1/3 · 80:14:A8:00:00:01
Sinal: -19,52 dBm
Autorizada em 10/11/2026 14:05
A linha do sinal só aparece se a ONU já tiver leitura; quem ativou fica no histórico da ONU.
Com o provedor Desligado, nada é enviado e os eventos não se acumulam: ao ligar, só os alertas novos saem.
As quedas vêm da leitura completa das OLTs (a cada 15 minutos); a ONU pendente aparece em até 1 minuto (ou na hora, com trap).