Status de Integridade do Canal
O campo de Integridade funciona como um monitor de saúde em tempo real para a sua conexão de WhatsApp. Ele permite que os administradores saibam rapidamente se o canal está operando de forma correta ou se o sistema está lidando com alguma instabilidade técnica.
Para consultar o status atual, acesse o menu Ajustes > Conta > Canais de atendimento e clique em "Detalhes" no canal desejado.
Abaixo, explicamos o significado de cada um dos 4 níveis de integridade e como a plataforma reage em cada cenário para proteger a sua operação:
🟢 Estável
É o melhor cenário possível. Significa que a conexão entre a plataforma e o WhatsApp (ou o seu provedor) está funcionando perfeitamente, sem interrupções. O envio e o recebimento de mensagens estão ocorrendo em tempo real.
🟡 Verificando Conexão
O sistema atua de forma preventiva. Nesta fase, a nossa infraestrutura detectou uma potencial falha, atraso ou queda de conexão com o canal e iniciou uma verificação automática.
- Impacto na operação: Para evitar alarmismo desnecessário devido a pequenas oscilações de rede, nenhum aviso é exibido para o atendente na tela de atendimento. A operação segue normalmente enquanto o sistema tenta resolver a falha em segundo plano.
🟠 Em Alerta
O problema foi confirmado e persiste. Como a verificação inicial não resolveu a instabilidade, a plataforma entra em modo de proteção de dados e começa a tentar ativamente reconectar o canal.
- Impacto na operação: Os usuários passam a ver um aviso na interface informando que o sistema está tentando uma reconexão.
- Fila de Segurança: Para garantir que nenhuma informação se perca, todas as mensagens enviadas pela equipe a partir deste momento são direcionadas para uma fila de espera protegida. Elas serão disparadas automaticamente assim que a conexão for restabelecida.
🔴 Crítico
A conexão falhou de forma severa ou prolongada. Este status indica que o canal está inoperante há algum tempo.
- Impacto na operação: Os usuários recebem um alerta claro de que existe uma instabilidade grave no canal. As mensagens de saída continuam sendo retidas na fila de segurança.
- Ação necessária: Neste estágio, geralmente é necessária a intervenção de um administrador. Pode ser preciso verificar se o número sofreu algum bloqueio na Meta ou reconectar o QR Code (no caso de canais não oficiais).
🛡️ Resumo da Proteção de Mensagens
A transição automática entre estes status foi desenhada para garantir que a sua equipe nunca perca o trabalho realizado.
Mesmo que o canal entre em estado de "Alerta" ou "Crítico", o atendente pode continuar digitando e enviando as mensagens no chat; a plataforma irá guardá-las em segurança e entregá-las aos clientes na ordem correta assim que o status retornar para "Estável".
Detalhes Técnicos
Esta seção descreve como o sistema de integridade funciona internamente.
Enum de Status
Internamente, o campo HealthStatus do canal utiliza o enum ChannelHealthStatus com os seguintes valores:
| Valor interno | Exibição na UI | Descrição |
|---|---|---|
OK | 🟢 Estável | Canal operacional |
CHECK | 🟡 Verificando conexão | Verificação inicial em curso |
ALERT | 🟠 Em alerta | Falha confirmada, tentando reconectar |
CRITICAL | 🔴 Crítico | Falha prolongada, reboot acionado |
DISCONNECTED | — | Desconexão permanente detectada |
DISABLED | — | Canal desabilitado manualmente |
Mecanismo de Health Check (Circuit Breaker)
O health check é controlado por um job do Hangfire que roda com retentativas automáticas. O número de tentativas (RetryCount) determina o status atual:
Faixa de RetryCount | Status resultante | Tempo acumulado aproximado |
|---|---|---|
| 0 – 7 | CHECK | Até ~2 minutos |
| 8 – 23 | ALERT | Até ~6 minutos |
| ≥ 24 | CRITICAL | A partir de ~6 minutos |
A cada tentativa, o sistema aguarda a resposta do gateway por até 15 segundos (na primeira tentativa) ou 10 segundos (nas subsequentes).
Critério de saúde (canal ZAPI): o canal é considerado saudável quando:
- Existe uma mensagem enviada com sucesso nos últimos 2 minutos
- A instância do gateway está com status
Connected - Todos os webhooks necessários estão inscritos
Recuperação automática
Quando o gateway responde com sucesso em qualquer tentativa:
- O status é alterado para
OK - As mensagens retidas na fila de segurança são reenfileiradas automaticamente para envio
- A interface do utilizador é notificada em tempo real via WebSocket
Pausa automática de campanhas
Quando o status muda para ALERT, CRITICAL ou DISCONNECTED, todas as campanhas ativas associadas ao canal são pausadas automaticamente com a seguinte mensagem de motivo:
ALERT/CRITICAL: "O número [X] está com a conexão instável"DISCONNECTED: "O número [X] está desconectado"
As campanhas permanecem pausadas até que um administrador as retome manualmente após a estabilização do canal.