Por que a Evolution API não gera QR Code?
Quando a Evolution API falha em mostrar o QR Code, raramente é bug da biblioteca. Os motivos mais frequentes são:
- Container desatualizado: versões antigas do Docker ou do próprio container podem ter quebras de compatibilidade.
- Webhook mal configurado: se o endpoint de callback está errado ou inacessível, a API trava ao tentar autenticar.
- Porta de rede bloqueada: firewall ou ambiente cloud sem redirecionamento correto impede a renderização do QR.
Menos comum, mas possível: falha em dependências do Node.js ou ambiente sem suporte gráfico.
Abaixo, um guia prático para identificar e corrigir cada causa.
Passo a passo para resolver QR Code travado na Evolution API
| Causa provável | Como checar | Como corrigir |
|---|---|---|
| Container desatualizado | Verifique a versão do container com 'docker ps' e logs de inicialização. | Atualize o container com a imagem mais recente recomendada pela documentação. |
| Webhook incorreto | Confira a variável de ambiente do webhook e se o endpoint responde com 200. | Ajuste a URL do webhook e teste o endpoint com ferramentas tipo Postman. |
| Porta bloqueada | Teste a conexão localmente e externamente para as portas usadas (normalmente 8080 ou 3000). | Libere as portas no firewall/segurança do provedor ou altere a porta de binding. |
| Dependências ausentes | Verifique logs de erro ao iniciar o container. | Instale dependências obrigatórias citadas na documentação, valide ambiente Node compatível. |
Banimento na Evolution API: por que acontece?
A maioria dos banimentos de número usando Evolution API não vem de bugs, mas de padrões de uso incompatíveis com as políticas do WhatsApp.
Quem trata a Evolution API como "WhatsApp ilimitado de graça" quase sempre perde o número cedo ou tarde: disparos em massa, mensagens idênticas, ausência de opt-in e uso em volume são rastreados automaticamente pelo sistema do WhatsApp.
A API oficial do WhatsApp existe justamente para casos de uso de escala. Tentar burlar restrições com Evolution API só aumenta o risco de bloqueio definitivo.
Para evitar banimento:
- Use apenas para comunicações pontuais, com opt-in claro.
- Varie o conteúdo das mensagens.
- Não conecte o mesmo número em múltiplas instâncias.
- Respeite limites de envio (sem automações de massa).
Perguntas frequentes
A Evolution API parou de mostrar o QR Code do nada. Preciso reinstalar tudo?
Posso usar Evolution API para enviar mensagens em massa no WhatsApp?
O QR Code pode não aparecer por bloqueio do provedor de hospedagem?
Existe alguma forma 100% segura de evitar banimento usando Evolution API?
Termos relacionados
Evolution API e banimento no WhatsApp: riscos reais e como reduzir em 2026
Entenda por que a Evolution API leva ao banimento no WhatsApp, o que mudou na detecção da Meta em 2026 e qual é a rota mais segura para automações de alto volume.
Ler →
Como enviar mensagem automática no WhatsApp sem ser bloqueado (guia 2026)
O passo a passo para automatizar mensagens no WhatsApp sem tomar bloqueio em 2026: API oficial, aquecimento de número, taxa de denúncia e os erros que derrubam a conta.
Ler →
Z-API com n8n: conectar WhatsApp por webhook sem tomar ban
Guia direto: como conectar Z-API ao n8n por webhook, enviar WhatsApp e evitar banimento. Explicamos o passo a passo do setup e, principalmente, como driblar bloqueios com rotação de texto, espaçamento e limites diários.
Ler →
Como automatizar pedidos do WooCommerce com notificação no WhatsApp (n8n, passo a passo)
Conecte o WooCommerce ao WhatsApp com n8n: webhook de pedido criado, mensagem automática para o cliente e alerta para a equipe. Passo a passo com custos e cuidados.
Ler →