Pré-requisitos obrigatórios
Antes de criar a instância e gerar o QR Code, valide obrigatoriamente os pontos abaixo:
1️⃣ Versão do Evolution
O Evolution precisa estar atualizado para versões acima da 2.3.6.
Versões anteriores não suportam corretamente o fluxo de geração de QR Code e podem apresentar falhas na autenticação do WhatsApp.
✅ Recomendação: sempre manter o Evolution atualizado para evitar incompatibilidades e retrabalho.
2️⃣ Channel correto na criação da instância
No momento de criar a instância, o Channel deve ser selecionado como baileys.
⚠️ Caso outro channel seja escolhido, o QR Code não será gerado corretamente.
Esse padrão já é consolidado e segue a forma como a integração sempre funcionou de maneira estável.
Passo a passo para gerar o QR Code no Evolution
1️⃣ Crie uma nova instância
No painel do Evolution:
Acesse a área de Instâncias
Clique em Criar instância
Defina um nome para a instância (NÃO USE ESPAÇOS NEM CARACTERES ESPECIAIS)
Durante a criação:
✅ Verifique se a versão do Evolution é > 2.3.6 ou superior.
✅ Selecione o Channel: baileys
2️⃣ Inicie a instância
Após a criação:
Inicie a instância criada
Aguarde alguns segundos para que o Evolution prepare a sessão
3️⃣ Gere o QR Code
Com a instância ativa:
Acesse os detalhes da instância
Clique na opção para gerar ou visualizar o QR Code
O QR Code será exibido na tela.
4️⃣ Conecte o WhatsApp
No celular:
Abra o WhatsApp
Vá em Aparelhos conectados
Selecione Conectar um aparelho
Escaneie o QR Code exibido no Evolution
Após a leitura, a instância será autenticada automaticamente.
Observações importantes
🔹 O QR Code possui tempo limitado de validade; se expirar, gere um novo
🔹 Apenas um WhatsApp por instância pode ser conectado
🔹 Evite tentar múltiplas leituras simultâneas para não invalidar a sessão
Manter esse processo organizado é o que sempre garantiu conexões confiáveis em produção.
Problemas comuns e como evitar
Se o QR Code não aparecer ou a conexão falhar:
Confirme a versão do Evolution (> 2.3.6)
Verifique se o Channel está como baileys
Reinicie a instância
Atualize a página do navegador
Na maioria dos casos, o problema está diretamente ligado a um desses pontos.
Precisa de ajuda?
Caso tenha qualquer dúvida ou dificuldade:
👉 Nossa central de ajuda está disponível em: https://ajuda.cloudfy.cloud/pt-BR/
Estamos prontos para apoiar e garantir que sua integração funcione de forma estável e previsível.