WhatsApp desconectou
Antes de qualquer coisa: o sistema tenta se recuperar sozinho. Vale saber o que ele já fez antes de você mexer.
Comece pelo painel de saúde
Seção intitulada “Comece pelo painel de saúde”
Config. → Pessoas & Canais → Caixas de Entrada. A lista já é o diagnóstico: cada caixa mostra o estado e, quando há problema, o motivo.
Use os filtros do topo:
| Filtro | Mostra |
|---|---|
| Precisam de atenção | O que está fora do ar agora |
| Paradas | Caixas fora do ar (desconectadas, esperando QR ou reautorização) sem movimento há 30 dias ou mais |
| Todas | A lista inteira |
Os estados possíveis:
| Estado | O que quer dizer |
|---|---|
| Conectada | Tudo certo. Se o cliente reclama mesmo assim, veja mensagens não chegam |
| Desconectada | ”Não entra nem sai mensagem” |
| Aguardando QR | O QR foi gerado e ninguém leu |
| Conectando | Em processo |
| Reconexão necessária | ”Autorização expirada — não entra nem sai mensagem”. É o caso do WhatsApp Cloud e do Facebook |
Cada linha traz o botão certo para o caso: Ver QR, Reconectar ou Reautorizar — todos abrem a caixa, onde a ação é feita.
WhatsApp Web: o que o sistema já faz sozinho
Seção intitulada “WhatsApp Web: o que o sistema já faz sozinho”Um monitor roda a cada cinco minutos e cuida de três situações:
- Caixa desconectada — tenta reconectar, respeitando um intervalo de dez minutos entre tentativas da mesma caixa.
- Caixa travada em “Conectando” por mais de cinco minutos — trata como queda e refaz.
- Caixa “conectada” que parou de receber — se nenhum evento chega há 45 minutos numa caixa com mais de uma hora de vida, ela é tratada como zumbi e reconectada.
O terceiro caso é o mais importante, porque é o mais traiçoeiro: a tela diz conectado, o time acha que está tudo bem, e há horas nada entra.
Quando o sistema desiste — mais de cinco tentativas em trinta minutos — ele para de tentar e avisa o administrador, em vez de ficar em laço.
WhatsApp Web: o que fazer na mão
Seção intitulada “WhatsApp Web: o que fazer na mão”
Na aba Configuração, bloco Conexão WhatsApp Web da caixa.
1. Reconectar
Seção intitulada “1. Reconectar”O primeiro botão a tentar. Ele só aparece enquanto o bloco mostra Conectado (com a caixa desconectada, o bloco mostra Solicitar QR Code — veja o passo 2). Ele refaz a sessão sem pedir QR novo.
Dê um ou dois minutos e confira o estado.
2. QR novo
Seção intitulada “2. QR novo”Só quando a sessão expirou de verdade. Sinais: estado Desconectada que não volta com reconectar, ou o celular ficou muito tempo sem abrir o WhatsApp.
- Garanta que o celular está online e o WhatsApp foi aberto recentemente.
- Na aba Configuração, bloco Conexão WhatsApp Web, Solicitar QR Code (com a caixa desconectada é o botão que aparece).
- No celular: WhatsApp → Configurações → Aparelhos conectados → Conectar um aparelho.
- Escaneie. O QR se renova sozinho enquanto a tela está aberta.
3. Conflito de sessão
Seção intitulada “3. Conflito de sessão”Se a caixa cai logo depois de conectar, provavelmente o mesmo número está pareado em outro lugar.
No celular, Aparelhos conectados mostra todas as sessões. Desconecte o que não reconhecer e reconecte aqui.
Envio falhando com a caixa conectada
Seção intitulada “Envio falhando com a caixa conectada”Esse caso tem página própria: WhatsApp Web retorna 5xx.
WhatsApp Cloud
Seção intitulada “WhatsApp Cloud”Aqui não há QR nem celular — o que cai é autorização ou configuração na Meta.
Reconexão necessária
Seção intitulada “Reconexão necessária”O estado diz “autorização expirada”. Use o botão Reautorizar na própria lista de caixas: ele abre a caixa para você refazer a conexão com a Meta.
Se a caixa foi criada pelo fluxo manual, com token de usuário do sistema, o caminho é gerar um token novo na Meta e atualizá-lo na configuração da caixa.
Envia mas não recebe
Seção intitulada “Envia mas não recebe”Sintoma clássico de webhook desconfigurado na Meta — comum depois de mexer no app de lá.
Na configuração da caixa estão a URL de webhook e o token de verificação. Na Meta, em WhatsApp → Configuração → Webhooks, confirme que apontam para lá e que os eventos messages e message_status estão assinados.
Número com problema na Meta
Seção intitulada “Número com problema na Meta”A caixa de WhatsApp Cloud tem uma aba Saúde da conta, e é ali que mora a resposta quando o envio começa a falhar sem erro claro:
| O que ver | Para quê |
|---|---|
| Classificação de qualidade | Qualidade caindo é o aviso antes da restrição |
| Nível de limite de mensagens | Quantos clientes novos por dia você pode alcançar |
| Modo da conta | Sandbox ou em tempo real |
| Status do nome de exibição | Aceito, em revisão ou rejeitado |
Qualidade baixa vem de bloqueio e denúncia — ou seja, de conteúdo, não de configuração. O conserto é o que você manda, não onde você clica. Veja boas práticas de disparo.
Quando falar com a gente
Seção intitulada “Quando falar com a gente”- A caixa volta a cair logo depois de reconectar, repetidamente
- O número foi restringido pela Meta e você precisa de orientação no recurso
- A caixa está conectada, o envio funciona e o recebimento não — com webhook conferido
Mande junto: qual caixa, desde quando, o estado que aparece na lista e o que já tentou.
Dúvidas comuns
Seção intitulada “Dúvidas comuns”Perco o histórico ao reconectar? Não. As conversas ficam no app.smart, independentes da sessão.
Preciso do celular para reconectar? No WhatsApp Web, só se for QR novo. O botão Reconectar não pede celular.
Reconectar derruba quem está atendendo? Não. A conversa continua; o que se refaz é a conexão com o WhatsApp.
Por que a caixa caiu de madrugada? Quase sempre o celular fora do ar ou uma instabilidade da conexão. Com a reconexão automática ligada, o sistema costuma resolver antes de alguém perceber.