Se você utiliza a Evolution API para automação de WhatsApp no N8N ou outras plataformas, na última semana está ocorrendo um problema bem chato onde; ou a mensagem gerada nunca chega (fica uma mensagem no WhatsApp falando não entregue), ou o problema é não conseguir gerar o QR Code para autenticação, saiba que não está sozinho. Recentemente, muitos usuários relataram que a Evolution parou de funcionar, prejudicando fluxos de atendimento e integrações. Neste artigo, você vai aprender uma solução rápida e prática para resolver esse erro, baseada em relatos da própria comunidade e testada com sucesso.
O Problema: Evolution API Não Gera QR Code
Na noite de 28 de maio de 2025, diversos usuários perceberam que a Evolution API deixou de funcionar corretamente, impedindo a geração do QR Code necessário para conectar o WhatsApp à plataforma. Esse erro afetou fluxos de automação e impactou empresas e profissionais que dependem da ferramenta para atendimento ao cliente1.
Solução Imediata: Atualize o Parâmetro CONFIG_SESSION_PHONE_VERSION
A boa notícia é que a comunidade rapidamente encontrou um modo de resolver o problema, e é relativamente simples. Basta fazer um ajuste que consiste em alterar o valor do parâmetro CONFIG_SESSION_PHONE_VERSION no ambiente da sua instalação Evolution API. Independente do seu ambiente, é bem parecido. No nosso caso, usamos o Portainer, veja como resolver.
Tempo total: 5 minutos
Acesse o seu Portainer
Entre no painel do seu portainer onde sua Evolution API está instalada, então clique no seu Docker (no meu caso primary).
Acesse a Stack da Evolution
Agora, clique em Stacks, depois clique na Stack da Evolution clicando em “evolution”
Acesse o editor
Agora, dentro da Evolution, clique em Editor. Antes de tudo, copie todo o código e faça um backup. Depois disse, clique dentro do código, dê um Ctrl+f na tela e digite no campo de busca “CONFIG_SESSION_PHONE_VERSION.”
CONTINUA DEPOIS DA PUBLICIDADE
Atualize o Valor
Substitua o valor antigo por: 2.3000.1023204200. Feito isso, clique em “Update Stack”.
Caso você use o Easypanel, segue um vídeo abaixo explicando a mesma coisa, porém no Easypanel
Por Que Isso Funciona?
Aparentemente, a falha está relacionada a uma incompatibilidade temporária da versão do WhatsApp utilizada pela Evolution API. Ao atualizar manualmente o parâmetro de versão, você força a API a usar uma configuração compatível, restaurando o funcionamento até que a equipe oficial libere uma correção definitiva1.
Observações Importantes
-
Solução Temporária: Essa é uma medida paliativa. A equipe da Evolution API deve lançar uma atualização oficial em breve para corrigir o problema de forma definitiva.
-
Backup: Sempre faça backup das configurações antes de qualquer alteração.
-
Acompanhe o GitHub: Para novidades e outras soluções, acompanhe o repositório oficial da Evolution API no GitHub, especialmente a seção de issues.
Conclusão
Se você está enfrentando problemas com a Evolution API não gerando QR Code, siga o passo a passo acima para restaurar o funcionamento da sua automação de WhatsApp. Compartilhe este artigo com outros usuários e ajude a comunidade a superar esse obstáculo rapidamente!
