Descubra a solução definitiva se sua Evolution API parou de enviar ou receber mensagens e não está mais gerando QRCode dentro do Portainer. Aprenda por que esse problema acontece, como resolver de vez e garanta que não volte a acontecer!
Você tentou conectar a Evolution API no Portainer, mas de repente percebeu que ela parou de receber e enviar mensagens, ou até mesmo deixou de gerar o QRCode para autenticação? Calma! Esse é um problema mais comum do que parece e muita gente passa por isso, principalmente depois de alguma atualização ou mudança de infraestrutura. Neste artigo, vamos desvendar a raiz desse erro, mostrar as causas frequentes e apresentar um passo a passo simples para resolver (e evitar) problemas como este. Se você depende do Evolution API para integrações, automações ou bots de WhatsApp, este guia é para você. Vamos lá!
Entendendo o problema: por que a Evolution API parou de enviar/receber mensagens e gerar QRCode
A Evolution API é uma das soluções favoritas para integração de WhatsApp via Portainer, facilitando automações e interações com clientes. Porém, às vezes, usuários relatam que a API simplesmente para de enviar e receber mensagens ou não gera mais o QRCode após reiniciar o container ou atualizar alguma configuração.
Geralmente, o problema surge por falhas de comunicação entre o container Evolution, o servidor onde está hospedado e serviços relacionados ao WhatsApp. Entre as razões principais estão conflitos de DNS, perda de conexão entre o Docker/Portainer e a internet, ou bloqueios temporários que podem ser causados por configurações inadequadas.
Quando o QRCode deixa de aparecer, isso sinaliza que o container Evolution perdeu a capacidade de registrar uma nova sessão no WhatsApp. Ou seja, sem esse código, não é possível fazer login e, por consequência, a API fica inoperante. É comum também que, nesse cenário, a API não consiga mais se comunicar com o WhatsApp, interrompendo envio e recebimento de mensagens.
Identificar o que causou essa parada é fundamental para agir da melhor forma. A seguir, vamos detalhar as causas mais recorrentes e qual o melhor caminho para solucionar — sem mistério, mesmo para quem está começando em Portainer ou automações.
🤖 Conheça a Formação Agentes de IA com n8n
Se você gostou deste conteúdo e quer se aprofundar não só em Evolution API, mas em automações profissionais com bots, integração de APIs e agentes inteligentes, recomendo fortemente conhecer a Formação Agentes de IA da Hora de Codar. Com mais de 8.100 alunos e uma abordagem 100% prática (mesmo para quem não é programador), você aprende desde o básico do n8n até criar soluções completas, prontos para usar ou vender. O melhor? Não precisa codificar — tudo é feito de forma visual. Se seu objetivo é dominar de verdade automações, evitar erros em produção e até transformar isso em uma nova profissão, vale a pena conferir os detalhes neste link.
Principais causas: evolução, DNS resolver e falhas no Portainer
Quando a Evolution API não envia ou recebe mensagens e o QRCode não aparece, as causas normalmente são:
- Alterações ou Atualizações Recentes: Se você atualizou a Evolution API recentemente ou mexeu em configurações do Portainer, pode ter havido algum erro de compatibilidade ou conflito de versões.
- Configuração inadequada de DNS: Containers precisam resolver nomes de domínio para acessar APIs externas, como os servidores do WhatsApp. Se o DNS resolver do Docker não está funcionando bem, sua Evolution API pode ficar “ilhada” e sem comunicação.
- Problemas de rede: Falhas na conexão entre o servidor Docker e a internet, bloqueio por firewall ou regras de segurança na VPS podem barrar a comunicação externa essencial para o funcionamento da API.
- Erro ao reiniciar containers: Às vezes, ao reiniciar containers via Portainer, componentes críticos não inicializam corretamente, incluindo processos de autenticação e geração do QRCode.
Como você pode ver, a raiz do problema geralmente está fora da própria Evolution API — envolve rede, DNS ou configuração do ambiente Docker/Portainer. Saber disso ajuda a guiar melhor a correção, pois simplesmente reinstalar a API sem corrigir essas causas não resolve de forma definitiva.
Vídeo recomendado: Como configurar n8n e WhatsApp na VPS passo a passo
Aprenda a configurar de maneira profissional uma estrutura com: Easy Panel, n8n e Evolution API, para criar automações no WhatsApp. De maneira direta ao ponto você terá o WhatsApp conectado ao n8n, pronto para integrar qualquer automação e Agente de IA, confira:
Como resolver o erro de QRCode e mensagens na Evolution API
Agora que você já entendeu as causas, é hora de aplicar a solução prática para quando a Evolution API para de enviar/receber mensagens ou para de gerar QRCode. Confira este passo a passo rápido e fácil:
Passo 1: Verifique o log do container no Portainer
Acesse seu Portainer, localize o container Evolution e confira o log. Busque por erros relacionados a rede, DNS ou inicialização.Passo 2: Ajuste o DNS resolver do Docker
Se o erro está relacionado a DNS, adicione na configuração do Docker o uso do DNS público (como 8.8.8.8 do Google). Você pode fazer isso via docker-compose adicionando a seguinte configuração na seção do serviço:
“dns”: [“8.8.8.8”, “1.1.1.1”]
Depois, reinicie o container e observe se o QRCode volta a aparecer.
Passo 3: Cheque regras de firewall e rede
Garanta que sua VPS ou servidor não está bloqueando acesso à internet para o container. Em muitos casos, liberar as portas e garantir acesso total à internet resolve.Passo 4: Reinicie o container com as configurações corrigidas
Após ajustes, reinicialize o container Evolution pelo Portainer. Monitore os logs para saber se a conexão com o WhatsApp foi retomada.
Se após estas etapas o QRCode ainda não aparecer, considere remover o container e criar um novo a partir da última imagem estável da Evolution API. Isso limpa possíveis corrupções.
Lembrando: antes de modificar ou atualizar qualquer serviço, sempre faça um backup das suas configurações!
Passo a passo para configurar corretamente a Evolution API e o DNS resolver
Para prevenir os erros mais comuns de comunicação e QRCode na Evolution API, veja um guia simples para configurar tudo do jeito certo:
- Abra o Portainer e acesse o container Evolution.
- No arquivo docker-compose.yml, revise (ou adicione) as linhas de DNS resolver, escolhendo servidores públicos e confiáveis, como 8.8.8.8 e 1.1.1.1.
- Garanta que as portas corretas estejam liberadas na sua VPS para entrada e saída, especialmente aquelas usadas pelo WhatsApp Web (normalmente TCP 80, 443, etc).
- Salve e reinicie o container.
- Acompanhe os logs do container. Eles são essenciais para identificar se está surgindo algum erro recorrente e antecipar problemas.
Dica extra: sempre utilize a versão mais recente e estável da Evolution API para minimizar bugs.
Configurando dessa forma, você evita grande parte dos bloqueios que impedem a geração do QRCode e o envio/recebimento de mensagens.
💻 Hostinger: a melhor VPS para Evolution API, n8n e Portainer
Se você quer evitar problemas de rede, DNS e performance rodando a Evolution API ou qualquer automação no Portainer, usar uma VPS estável faz muita diferença. A Hostinger tem planos de VPS com ótima performance, fácil de gerenciar, já preparados para instalar n8n e outras automações, além de ser super flexível para crescer junto com o seu projeto. Recomendo por experiência própria: painel intuitivo, reembolso de 30 dias se não ficar satisfeito, e suporte rápido.
Você pode conferir os planos (com preços bem acessíveis) neste link: https://www.hostinger.com.br/horadecodar e ainda usar o cupom HORADECODAR para garantir um descontão especial. Assim você foge de dores de cabeça técnicas e foca só na sua solução!
Dicas para evitar que a Evolution API pare de funcionar novamente
Após resolver o problema, é importante garantir que ele não volte a acontecer. Confira algumas dicas práticas para manter a sua Evolution API rodando sem surpresas:
- Mantenha sempre o docker, Portainer e Evolution API atualizados. Mas evite atualizações em produção sem testar antes.
- Faça backups regulares das configurações e volumes do container. Isso salva tempo em caso de eventuais problemas ou rollback.
- Monitore seus containers: Use a função de logs do Portainer e configure alertas para falhas — assim você antecipa qualquer queda.
- Rotina de checagem: Uma vez por semana, revise se tudo está atualizado e funcionando (principalmente após atualizações no sistema ou firewall da VPS).
- Utilize servidores VPS estáveis e com suporte confiável, como a Hostinger, que além da performance permite acesso fácil ao painel para manutenção.
Estas ações simples aumentam bastante a chance de seu bot funcionar de forma constante e sem dor de cabeça. No final, prevenção é a melhor solução — principalmente em projetos que dependem de comunicação automatizada como bots de WhatsApp.
Por que o Evolution parou de receber ou enviar mensagens e não gera mais QRCode?
Esse problema geralmente ocorre devido a falhas na comunicação entre os containers no Portainer ou por instabilidades no serviço responsável pelo gerenciamento de mensagens e geração de QRCode dentro do Evolution. Isso impede que novas conexões sejam validadas ou que mensagens sejam enviadas/recebidas corretamente.
Como resolver o problema do Evolution que parou de receber/enviar mensagens e de gerar QRCode no Portainer?
A solução mais eficaz é reiniciar o serviço/container do Evolution diretamente pelo Portainer. Acesse seu painel, localize o container correspondente ao Evolution, pare-o e reinicie. Aguarde o serviço voltar ao ar; normalmente, o envio/recebimento de mensagens e a geração de QRCode voltam ao normal.
Se reiniciar o container não resolver, o que mais posso fazer para o Evolution voltar a funcionar?
Caso o problema persista após reiniciar o container, verifique se há atualizações pendentes no Evolution ou no Portainer, cheque as configurações de rede e permissões, e revise os logs do sistema para identificar erros específicos. Se necessário, entre em contato com o suporte técnico especializado para assistência avançada.
Conclusão
Quando a Evolution API para de enviar ou receber mensagens e o QRCode não aparece no Portainer, o transtorno pode ser grande — mas como vimos, as principais causas estão em configurações do ambiente, DNS e rede. Seguindo os passos e dicas do artigo, você aumenta bastante a chance de resolver rápido e evitar que isso se repita. Priorize sempre um ambiente estável e faça manutenções preventivas. Pense também em evoluir no mundo da automação, pois dominar ferramentas como n8n, Portainer e Evolution API abre portas para automações poderosas em WhatsApp, vendas, atendimento e muito mais. E se precisar de uma VPS confiável, a Hostinger é recomendação certa. Bons testes e até a próxima automação!