Pular para o conteúdo

WhatsApp desconectou

Antes de qualquer coisa: o sistema tenta se recuperar sozinho. Vale saber o que ele já fez antes de você mexer.

WhatsApp desconectou: Config. → Pessoas & Canais → Caixas de Entrada, o resumo no topo (caixas, Conectada, Precisa de você, paradas), os filtros "Todas", "Precisam de atenção" e "Paradas" e a lista de caixas agrupada por canal, com o estado de cada uma

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:

FiltroMostra
Precisam de atençãoO que está fora do ar agora
ParadasCaixas fora do ar (desconectadas, esperando QR ou reautorização) sem movimento há 30 dias ou mais
TodasA lista inteira

Os estados possíveis:

EstadoO que quer dizer
ConectadaTudo certo. Se o cliente reclama mesmo assim, veja mensagens não chegam
Desconectada”Não entra nem sai mensagem”
Aguardando QRO QR foi gerado e ninguém leu
ConectandoEm 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.

Um monitor roda a cada cinco minutos e cuida de três situações:

  1. Caixa desconectada — tenta reconectar, respeitando um intervalo de dez minutos entre tentativas da mesma caixa.
  2. Caixa travada em “Conectando” por mais de cinco minutos — trata como queda e refaz.
  3. 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 desconectou: o bloco Conexão WhatsApp Web da caixa, com o estado Desconectado e o botão Solicitar QR Code: o bloco Conexão WhatsApp Web da caixa desconectada, com o botão Solicitar QR Code

Na aba Configuração, bloco Conexão WhatsApp Web da caixa.

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.

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.

  1. Garanta que o celular está online e o WhatsApp foi aberto recentemente.
  2. Na aba Configuração, bloco Conexão WhatsApp Web, Solicitar QR Code (com a caixa desconectada é o botão que aparece).
  3. No celular: WhatsApp → Configurações → Aparelhos conectados → Conectar um aparelho.
  4. Escaneie. O QR se renova sozinho enquanto a tela está aberta.

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.

Esse caso tem página própria: WhatsApp Web retorna 5xx.

Aqui não há QR nem celular — o que cai é autorização ou configuração na Meta.

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.

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.

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 verPara quê
Classificação de qualidadeQualidade caindo é o aviso antes da restrição
Nível de limite de mensagensQuantos clientes novos por dia você pode alcançar
Modo da contaSandbox ou em tempo real
Status do nome de exibiçãoAceito, 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.

  • 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.

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.