Desconexões e como continuar online

Resumo

O Wazzap conecta no WhatsApp da mesma forma que o WhatsApp Web. Seu celular pareia um slot de "dispositivo conectado" com a gente, e dali em diante o canal vive na nossa nuvem. O celular pode ficar na gaveta, os chats continuam fluindo. Mas alguns eventos específicos quebram esse pareamento:

Por que os números desconectam

• Celular desligado por 14+ dias. O WhatsApp exige que o celular pareado fique online pelo menos uma vez a cada duas semanas. Se não ficar, a sessão do dispositivo conectado expira e o Wazzap vai para "Desconectado".
• Slot de dispositivo conectado reusado. O WhatsApp permite até 4 dispositivos conectados por número. Se alguém abre o WhatsApp Web no navegador e o teto enche, o slot do Wazzap é o que cai.
• O número foi banido. A Meta bloqueou a conta por violação de políticas ou triggers anti-spam. Veja reconectar após banimento para a recuperação.
• O usuário deslogou manualmente em WhatsApp → Aparelhos conectados → Sair de todos os aparelhos.
• Troca de chip ou de celular. Se o usuário muda para um aparelho novo e restaura o WhatsApp, a sessão conectada antiga é invalidada.
• Atualização do WhatsApp ou janela de manutenção. Raro, mas updates grandes às vezes derrubam sessões conectadas.

Configurar webhook de desconexão

O Wazzap expõe um webhook em tempo real que dispara no instante em que qualquer um desses eventos acontece. Configura por número, então dá para mandar alertas de sub-contas diferentes para destinos diferentes.

1. Abra o Painel de sub-contas no Wazzap.
2. Clique em Números do WhatsApp e selecione o número específico.
3. Abra Configurações → Disconnection Settings.
4. Ative o evento Disconnected.
5. Cole a URL do Webhook da sua plataforma de automação (inbound webhook do HighLevel, Zapier, Pabbly, n8n, ou seu próprio endpoint).
6. Salve.

Cada número precisa ser configurado de forma independente. Se você tem 10 números, monte 10 webhooks.

Payload do webhook

Cada request carrega identificação suficiente para rotear o alerta:

{
  "phone": "+5511912345678",
  "country": "BR",
  "event": "disconnected",
  "timestamp": "2026-05-14T18:42:11Z"
}

Os campos exatos variam um pouco entre versões, então desenhe a automação a jusante para tolerar payloads mínimos.

Fluxo recomendado no HighLevel

O padrão mais limpo para usuários do HighLevel:

1. Gatilho: Inbound Webhook dispara quando o Wazzap manda a desconexão.
2. Identifique a conta. Cruze o telefone recebido contra as suas sub-contas.
3. Atualize o status:
   • Marque o contato ou sub-conta com a tag WA_Disconnected.
   • Opcional: flipe um custom field whatsapp_status = offline.
4. Avise o operador:
   • Mensagem interna no Slack, e-mail, ou SMS para o dono da agência.
   • Crie uma tarefa de reconexão na fila do usuário responsável.
   • Se o número roda uma campanha, pause a campanha automaticamente.

Solução de problemas

O webhook não dispara ao deslogar manualmente

O webhook só dispara em um evento real de desconexão pelo lado do WhatsApp. Teste deslogando em WhatsApp → Aparelhos conectados → Sair no celular pareado, não mexendo no painel do Wazzap.

O número aparece "Desconectado" mas eu nunca deslogeu

Abra o WhatsApp no celular pareado e veja Aparelhos conectados. Se a nossa sessão sumiu, alguém reusou o slot via WhatsApp Web. Re-escaneie o QR no Wazzap e peça para o time nunca abrir o WhatsApp Web no navegador para esse número.

A reconexão fica falhando

Provavelmente o número está banido. Tente mandar uma mensagem direto do app do WhatsApp. Se você ver "Você não pode enviar mensagens no WhatsApp", o número está bloqueado. Siga o protocolo de reconectar após banimento.