Pular para o conteúdo principal

Sessão cai toda hora

Resumo: Conexões Baileys são sensíveis. As causas mais comuns de quedas: celular fica offline, WhatsApp Web atinge limite de aparelhos, atualização do app, ou bloqueios da Meta por suspeita de uso automatizado.

Quando usar isso​

Você está conectando WhatsApp via Baileys (QR ou pareamento) e:

  • A sessão desconecta a cada poucas horas/dias.
  • Sempre que reconecta, cai de novo logo depois.
  • Aparece status DISCONNECTED no painel várias vezes ao dia.

(WABA e Instagram não caem — esse problema é específico de Baileys.)

Causas mais comuns​

1. Celular fica offline por muito tempo​

Por quê: Baileys atua como "aparelho secundário" do WhatsApp Web. Se o celular principal fica muitos dias sem internet ou desligado, a Meta encerra automaticamente os aparelhos secundários (proteção contra contas inativas).

Como evitar:

  • Mantenha o celular sempre ligado e online (mesmo que com bateria baixa).
  • Se o celular for de uso pessoal e ficar sem internet ocasionalmente, considere migrar para WABA que é estável.

2. Limite de 4 aparelhos secundários​

Por quê: O WhatsApp permite só 4 aparelhos secundários por número (além do celular principal). Se você passar disso, o WhatsApp desconecta o mais antigo para abrir espaço.

Como verificar: Abra o WhatsApp do celular → Aparelhos conectados. Veja quantos estão na lista.

Como evitar:

  • Mantenha menos de 4 aparelhos secundários ativos.
  • Desconecte WhatsApp Web do navegador que você não usa.

3. WhatsApp do celular foi atualizado​

Por quê: Em algumas atualizações maiores do WhatsApp, todas as sessões secundárias são terminadas como medida de segurança/migração.

Como evitar: Pouco a fazer — quando isso acontece, basta reconectar pelo gateway.

4. Múltiplas reconexões em sequência​

Por quê: Se o gateway tenta reconectar muitas vezes seguidas (porque a sessão keep-alive falhou repetidas vezes), a Meta pode bloquear temporariamente o número de tentar novas conexões (anti-abuso). Resultado: ciclo de "conecta → cai → tenta de novo → bloqueia".

O gateway tem proteção: Reconexões são feitas com backoff exponencial (espera cada vez mais entre tentativas) para evitar esse bloqueio. Mas em casos extremos, ainda pode acontecer.

Como resolver:

  • Pare de tentar por 1-2 horas.
  • Verifique se o celular está saudável (carregado, com internet, com WhatsApp aberto).
  • Reconecte normalmente.

5. Suspeita de uso automatizado / disparo em massa​

Por quê: A Meta tem heurísticas que detectam comportamento "robotizado": envios em sequência muito rápida, padrões de texto repetidos, vários disparos para números que nunca te respondem, alta taxa de bloqueios pelos clientes.

Quando a Meta suspeita, ela desconecta sua sessão Baileys e pode até banir o número se persistir.

Como evitar:

  • Use Baileys para atendimento humanizado, não para campanhas.
  • Para envios em volume, use WABA com templates aprovados.
  • Espace envios (não dispare 100 mensagens em 1 minuto).
  • Personalize: evite enviar exatamente o mesmo texto para muitos números.

6. Bateria fraca no celular ou modo de economia agressivo​

Por quê: Alguns celulares Android com modo "economia de bateria" muito agressivo (especialmente Xiaomi, Huawei) matam o WhatsApp em background. Sem o celular online, a sessão secundária cai.

Como evitar:

  • Adicione WhatsApp à lista de exceções do modo bateria.
  • Para iPhone: geralmente não é problema, iOS gerencia melhor.

7. Mudança de WiFi / IP​

Por quê: Algumas redes corporativas / VPNs podem instabilizar a conexão WebSocket que o Baileys usa.

Como evitar:

  • Use conexão estável (fibra residencial, 4G/5G).
  • Evite VPNs corporativas se possível para o servidor do gateway.

Diagnóstico rápido​

Se está caindo muito, responda:

  • Quantas vezes cai por dia? (>3 = problema; 1 a cada poucos dias = aceitável)
  • O celular fica online o tempo todo?
  • Quantos aparelhos secundários estão conectados além do gateway? (>2 = pode ser o limite)
  • Você está disparando muitas mensagens em pouco tempo? (>30/min = risco)
  • Cai sempre no mesmo horário? (talvez tem rotina/script causando)
  • Outros canais Baileys da mesma conta também caem? (sim = problema no gateway; não = problema no número específico)

"Já tentei tudo e continua caindo"​

Migrar para WABA. É mais trabalho na configuração (precisa cadastro Meta, custo por mensagem), mas:

  • Não cai (vive na infraestrutura Meta, não no celular).
  • Suporta templates para mensagens proativas.
  • Aguenta alto volume sem bloqueio.

Veja Conectar WhatsApp Business (Meta).

Logs que ajudam a diagnosticar​

Se precisar reportar para o suporte, anote:

  1. Quando caiu (horário e fuso).
  2. Status final que apareceu (DISCONNECTED, FAILED, etc.).
  3. Último log de evento do canal (visível em Canais → detalhe do canal → Logs).
  4. Última mensagem enviada antes de cair (talvez tenha disparo problemático).

Dúvidas comuns​

O cliente fala que mandou mensagem e não respondi. Foi durante a desconexão? Pode ser. Mensagens recebidas durante a desconexão podem ficar na fila do WhatsApp (e chegam quando reconecta), ou se ficar muito tempo, são perdidas no aparelho secundário. O celular principal sempre recebe — mas o gateway só "vê" o que chega na sessão dele.

Tem como receber alerta quando cai? Sim. Configure um webhook ouvindo o evento channel:disconnected. Seu sistema dispara alerta (e-mail, Slack, SMS) e você atua rápido.

Quantas mensagens por minuto posso mandar com Baileys sem cair? Não há número oficial. Recomenda-se menos de 10 mensagens por minuto para o mesmo canal, e personalizar conteúdo. Acima disso, risco aumenta.

Cai e reconecta sozinho ou tenho que escanear de novo? O gateway tenta reconectar automaticamente com a sessão salva. Se a sessão ainda for válida, volta sem QR. Se a Meta invalidou completamente, vai precisar de QR novo.

Artigos relacionados​