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?
| Tipo | Causa típica |
|---|---|
| Baileys | Celular ficou muitos dias offline, WhatsApp foi reinstalado, sessão foi removida em "Aparelhos conectados", ou a Meta forçou desconexão por inatividade. |
| WABA | O Access Token expirou ou foi revogado no Meta Business. Ou a Meta suspendeu temporariamente o número por queda de qualidade. |
Token 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)
- Acesse Canais no painel.
- Localize o canal com status DISCONNECTED.
- 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.
- Para reconectar, o caminho mais limpo é:
- Remover o canal antigo da lista.
- Adicionar um novo canal Baileys.
- Escanear o QR Code novamente.
- 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
- Acesse Canais no painel.
- Olhe o detalhe do erro que aparece junto ao status DISCONNECTED.
- 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.
- 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.
- Acesse o WhatsApp Manager (
Se for Instagram
- Acesse Canais no painel.
- Status TOKEN_EXPIRED significa que o token de 60 dias passou sem renovação.
- Clique em Reconectar — o sistema vai fazer um novo OAuth com o Facebook automaticamente.
- 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.