🧭 Introdução
O campo Integridade funciona como um monitor de saúde em tempo real para a conexão do seu canal de WhatsApp. Ele permite que os administradores identifiquem rapidamente se o canal está operando corretamente ou se há alguma instabilidade técnica.
Para consultar o status atual, acesse Ajustes > Conta > Canais de atendimento e clique em Detalhes no canal desejado.
A seguir, conheça os quatro níveis de integridade, entenda o que cada um significa e saiba como a plataforma se comporta em cada situação para proteger sua operação.
⚙️ Pré-requisitos
- Ter acesso à plataforma com permissão para consultar os canais de atendimento.
- Conhecer o caminho Ajustes > Conta > Canais de atendimento para localizar os detalhes do canal.
🔢 Passo a Passo
- Acesse os canais de atendimento.No menu da plataforma, acesse Ajustes > Conta > Canais de atendimento.
- Consulte os detalhes do canal.Localize o canal de WhatsApp que deseja verificar e clique em Detalhes.
- Verifique o status de integridade.Identifique o status exibido e consulte abaixo o significado de cada nível e seus impactos na operação.
- 🟢 Estável: indica que a conexão entre a plataforma e o WhatsApp ou provedor está funcionando corretamente, sem interrupções. O envio e o recebimento de mensagens ocorrem em tempo real.
- 🟡 Verificando Conexão: a infraestrutura identificou uma possível falha, atraso ou queda de conexão e iniciou uma verificação automática. Nesse estágio, nenhum aviso é exibido ao atendente, e a operação segue normalmente enquanto o sistema tenta resolver a situação em segundo plano.
- 🟠 Em Alerta: a instabilidade foi confirmada e persiste. A plataforma tenta reconectar o canal e exibe um aviso aos usuários. As mensagens enviadas pela equipe passam a ser direcionadas para uma fila de segurança, aguardando o restabelecimento da conexão para serem enviadas automaticamente.
- 🔴 Crítico: indica uma falha grave ou prolongada. Os usuários recebem um alerta sobre a instabilidade, e as mensagens de saída continuam retidas na fila de segurança. Geralmente, é necessária a intervenção de um administrador.
- Entenda como funciona a proteção de mensagens.Mesmo quando o canal está em estado de Alerta ou Crítico, o atendente pode continuar digitando e enviando mensagens pelo chat. A plataforma armazena essas mensagens na fila de segurança e, quando a conexão é restabelecida, realiza o envio na ordem correta.
- Verifique se é necessária alguma ação administrativa.Se o canal permanecer em estado crítico, verifique a conexão. Pode ser necessário confirmar se o número sofreu algum bloqueio na Meta ou reconectar o QR Code, no caso de canais não oficiais.
💻 Exemplos Práticos
Exemplo 1 — Canal estável: o canal apresenta o status Estável, indicando que a conexão está funcionando corretamente e que o envio e o recebimento de mensagens ocorrem em tempo real.
Exemplo 2 — Instabilidade temporária: o canal passa para Verificando Conexão. O sistema realiza verificações automáticas em segundo plano, sem exibir um aviso ao atendente nesse estágio.
Exemplo 3 — Conexão instável: o canal passa para Em Alerta. Os usuários recebem um aviso, e as mensagens enviadas pela equipe são armazenadas na fila de segurança até que a conexão seja restabelecida.
Exemplo 4 — Falha prolongada: o canal passa para Crítico. A equipe é informada sobre a instabilidade, as mensagens continuam retidas na fila e um administrador pode precisar intervir para recuperar a conexão.
🔍 Detalhes Técnicos
Como funciona cada status?
A plataforma monitora a conexão automaticamente e atualiza o status conforme identifica uma falha ou consegue restabelecer a comunicação.
| Status interno | O que significa |
|---|---|
| 🟢 OK | A conexão está funcionando normalmente. |
| 🟡 CHECK | O sistema identificou uma possível instabilidade e está verificando a conexão. |
| 🟠 ALERT | O problema foi confirmado, e o sistema está tentando restabelecer a conexão. |
| 🔴 CRITICAL | A falha persiste por mais tempo, indicando uma instabilidade mais grave. |
| DISCONNECTED | O sistema identificou que o canal está desconectado. |
| DISABLED | O canal foi desativado manualmente. |
Quanto tempo leva para o status mudar?
Quando identifica uma falha, a plataforma realiza tentativas automáticas de verificar e recuperar a conexão. Se o problema continuar, o status evolui de acordo com a quantidade de tentativas realizadas.
| Status | Tempo aproximado | O que acontece |
|---|---|---|
| 🟡 Verificando Conexão | Até 2 minutos | O sistema verifica se a conexão está funcionando corretamente. |
| 🟠 Em Alerta | Até aproximadamente 6 minutos | A falha persiste, e o sistema intensifica as tentativas de reconexão. |
| 🔴 Crítico | A partir de aproximadamente 6 minutos | A falha continua, podendo ser necessária a intervenção de um administrador. |
Esses tempos são aproximados e dependem das tentativas de verificação realizadas pelo sistema. Em cada tentativa, a plataforma aguarda a resposta da conexão por até 15 segundos na primeira verificação e até 10 segundos nas seguintes.
Como o sistema identifica se a conexão está funcionando?
Nos canais ZAPI, a plataforma considera três condições para avaliar se a conexão está saudável:
- Uma mensagem precisa ter sido enviada com sucesso nos últimos 2 minutos.
- A conexão com o gateway, responsável pela comunicação com o serviço, deve estar ativa.
- As integrações necessárias para receber e processar eventos, chamadas de webhooks, devem estar configuradas e funcionando.
O que acontece quando a conexão é recuperada?
Quando o sistema consegue se comunicar novamente com o gateway, a plataforma realiza automaticamente as seguintes ações:
- Atualiza o status do canal para Estável.
- Retoma o envio das mensagens que estavam aguardando na fila de segurança.
- Atualiza a interface da plataforma em tempo real para informar a recuperação da conexão.
O que acontece com as campanhas durante uma instabilidade?
Para evitar que campanhas continuem sendo executadas enquanto o canal apresenta problemas de conexão, a plataforma pausa automaticamente as campanhas ativas associadas a ele quando o status muda para Em Alerta, Crítico ou Desconectado.
- Em Alerta ou Crítico: o motivo da pausa informa que o número está com a conexão instável.
- Desconectado: o motivo da pausa informa que o número está desconectado.
Após a estabilização do canal, um administrador deverá retomar manualmente as campanhas pausadas.
💡 Dicas e Boas Práticas
- Consulte o status de integridade do canal sempre que identificar dificuldades no envio ou no recebimento de mensagens.
- Se o status estiver em Verificando Conexão, aguarde a verificação automática antes de tomar outras medidas.
- Se o canal estiver em Alerta ou Crítico, acompanhe os avisos exibidos na plataforma e considere a necessidade de intervenção administrativa.
- Em canais não oficiais, verifique a conexão do QR Code quando houver uma falha prolongada.
- Após a estabilização do canal, lembre-se de retomar manualmente as campanhas que foram pausadas automaticamente.
✅ Conclusão
O status de integridade permite acompanhar a saúde da conexão do canal de WhatsApp e entender como a plataforma reage a possíveis instabilidades. Ao monitorar os níveis de integridade, sua equipe poderá identificar problemas, acompanhar a recuperação da conexão e compreender como as mensagens e campanhas são protegidas durante uma falha.
Em caso de dúvidas, conte com nossa equipe abrindo um ticket em nossa Central do Usuário CLIQUE AQUI.