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