Pular para o conteúdo principal

Meu número desconectou — o que fazer

Resumo: Acesse o painel, localize o canal com status DISCONNECTED, clique em "Reconectar". Se for Baileys, vai pedir QR Code de novo. Se for WABA, basta clicar — a conexão volta sozinha.

Quando usar isso​

Você tentou enviar uma mensagem e recebeu o erro "Phone not connected" (PHONE_NOT_CONNECTED). Ou um cliente reclamou que mandou mensagem e não foi entregue. Ou o painel mostra o canal com a tag DISCONNECTED em vermelho.

Isso indica que o canal perdeu a conexão — o gateway não consegue mais enviar nem receber mensagens por ele.

Por que isso acontece?​

TipoCausa típica
BaileysCelular ficou muitos dias offline, WhatsApp foi reinstalado, sessão foi removida em "Aparelhos conectados", ou a Meta forçou desconexão por inatividade.
WABAO Access Token expirou ou foi revogado no Meta Business. Ou a Meta suspendeu temporariamente o número por queda de qualidade.
InstagramToken de 60 dias expirou sem ser renovado (status TOKEN_EXPIRED), ou as permissões foram removidas no Facebook.

Passo a passo​

Se for Baileys (WhatsApp comum)​

  1. Acesse Canais no painel.
  2. Localize o canal com status DISCONNECTED.
  3. Verifique no celular: abra o WhatsApp → Aparelhos conectados. Se o aparelho aparecer ali com a tag "Atividade recente", o problema é temporário (basta esperar reconectar sozinho). Se não aparecer ali, a sessão foi terminada.
  4. Para reconectar, o caminho mais limpo é:
    • Remover o canal antigo da lista.
    • Adicionar um novo canal Baileys.
    • Escanear o QR Code novamente.
  5. Caso o painel ofereça botão "Reconectar" direto, clique nele — vai gerar um QR novo sem perder o canal.

💡 Dica: Antes de remover, anote o nome do canal e quem ele atende. Você precisará recriar com o mesmo nome para manter a continuidade do atendimento.

Se for WABA​

  1. Acesse Canais no painel.
  2. Olhe o detalhe do erro que aparece junto ao status DISCONNECTED.
  3. Se o erro for sobre token expirado:
    • Vá em Meta Business Suite → Business Settings → Users → System Users.
    • Gere um novo Access Token permanente com permissão whatsapp_business_messaging.
    • No painel do gateway, edite o canal e cole o novo token.
  4. Se o erro for sobre número suspenso pela Meta:
    • Acesse o WhatsApp Manager (business.facebook.com/wa/manage).
    • Veja o motivo da suspensão (geralmente queda de qualidade ou reclamações de usuários).
    • Aguarde o período de penalidade ou contate o suporte da Meta.

Se for Instagram​

  1. Acesse Canais no painel.
  2. Status TOKEN_EXPIRED significa que o token de 60 dias passou sem renovação.
  3. Clique em Reconectar — o sistema vai fazer um novo OAuth com o Facebook automaticamente.
  4. Se não houver botão de reconectar, remova o canal e adicione de novo via Instagram OAuth.

Dúvidas comuns​

Quando vou perceber que desconectou? O painel mostra o status DISCONNECTED em tempo real. Além disso, qualquer tentativa de enviar mensagem retorna erro PHONE_NOT_CONNECTED (HTTP 409). Vale cadastrar um alerta no seu sistema para esse erro.

Vou perder as conversas? Não. O canal pode desconectar e reconectar sem perder o histórico no WhatsApp. As mensagens recebidas durante o downtime serão entregues quando reconectar (mas mensagens muito antigas podem se perder, depende do caso).

Mensagens enviadas durante a desconexão são perdidas? Mensagens que estavam na fila ficam com status FAILED com motivo "phone not connected". Você pode reenviá-las após reconectar.

Como evito que desconecte? Para Baileys: mantenha o celular sempre ligado, com bateria razoável e internet boa. Para WABA: use System User token (não temporário) e mantenha o número com boa qualidade. Veja Sessão cai toda hora.

Artigos relacionados​