Instância da Evolution API presa em «connecting»: as causas habituais

Uma instância presa em «connecting» quer dizer que a Evolution API tenta ligar-se ao WhatsApp e não consegue, ou que o serviço reinicia antes de acabar. A causa mais frequente, segundo quem instala, é a versão do Baileys estar incompatível com o WhatsApp do momento. Mas há outras, e os registos dizem qual é. Comece sempre por lê-los.

Ler os registos primeiro

1 Veja se o serviço está de pé. docker compose ps mostra se a API está a correr ou a reiniciar sem parar. Reinícios em série são a pista mais clara.
2 Siga os registos. docker compose logs -f, na pasta do projecto, enquanto pede a ligação. Procure a primeira linha de erro e não a última: as seguintes são consequência.
3 Anote a versão da imagem que está a usar. Vai precisar dela para ver as notas de versão e os problemas conhecidos do projecto.

As causas, por ordem de probabilidade

Causa Como se reconhece O que fazer
Versão do Baileys incompatível A ligação fecha logo depois de o QR ser lido, ou o serviço reinicia em ciclo, sem erro de rede. Consulte as notas de versão e os problemas abertos no repositório do projecto. Passe para a versão que lá indicam como correcta, ou volte à última que funcionava. Fixe a versão da imagem.
Sessão antiga ou estragada A instância existia, deixou de ligar, e o QR não aparece ou não resulta. Apague a instância e crie-a de novo, lendo um QR novo. Veja ligar com o QR e reconectar.
O servidor não chega ao WhatsApp Há erros de rede ou de resolução de nomes nos registos. Teste a saída do servidor, por exemplo com curl -I https://web.whatsapp.com, e veja a firewall de saída e o DNS.
Relógio do servidor errado Erros de certificado ou de ligação segura sem outra causa. Veja a data e a hora do servidor com timedatectl e active a sincronização.
Falta de memória O contentor desaparece sem erro da aplicação. Veja erros comuns do VPS. Reduza o que corre ao lado, ou aumente a memória.
Base de dados ou Redis inacessíveis A API queixa-se da ligação à base de dados e reinicia. Confirme palavras-passe e nomes de serviço. Veja PostgreSQL e Redis.
O número foi limitado ou bloqueado O telemóvel mostra um aviso do WhatsApp. Nenhum QR resulta. É o risco do Baileys. Veja o risco e as regras. Não insista a repetir.
Não actualize às cegas. Passar para a imagem mais recente pode resolver o problema, mas também pode trazer outro e mexer nos dados. Faça primeiro uma cópia (veja actualizar e fazer cópias) e mude uma coisa de cada vez.

Uma sequência que poupa tempo

1 Registos e estado do serviço, como acima.
2 Rede e relógio do servidor, que são rápidos de excluir.
3 Versão da imagem contra as notas do projecto.
4 Instância nova com um QR novo, para excluir uma sessão estragada.
5 Outro número de teste, para saber se o problema é do servidor ou do número.
Se pediu ajuda a uma comunidade ou ao projecto, leve a versão da imagem, as linhas de registo do primeiro erro e o que já tentou. Apague o que seja segredo (a chave da API, tokens, números). O suporte da Interweb acompanha o VPS e a rede, mas não instala nem repara a Evolution API: veja Política de Suporte.

O servidor está sem memória ou sem disco? Veja que VPS lhe dá folga.

Ver servidores VPS

VEJA TAMBÉM

Ligar uma instância com o QR e reconectar

Actualizar e fazer cópias da Evolution API

Erros comuns do VPS

PRODUTO RECOMENDADO

Alojamento de sites com cPanel

Domínio e SSL incluídos, cópias diárias e o painel que já conhece. desde 321,75 MT/mês (plano de 3 anos, com cupão)

Ver planos
  • 0 Utilizadores acharam útil
Esta resposta foi útil?