Sua empresa recebe dezenas de mensagens por dia no WhatsApp e alguém precisa responder tudo na mão? A combinação Evolution API + n8n virou uma das formas mais populares de montar um atendimento automatizado sem depender de plataformas fechadas: a Evolution API conecta o número de WhatsApp e entrega cada mensagem como um evento, e o n8n decide o que fazer com ela, seja responder com IA, consultar um sistema ou chamar um atendente. Neste guia, você vê a arquitetura, o passo a passo e os cuidados que separam um protótipo de um atendimento que aguenta o dia a dia.
O que é a Evolution API e onde o n8n entra
A Evolution API é um projeto de código aberto que expõe o WhatsApp como uma API REST. Você cria uma "instância" para cada número, conecta pelo QR code (como no WhatsApp Web) ou pela API oficial da Meta, e passa a enviar mensagens por requisições HTTP e a receber eventos por webhook.
O n8n é uma plataforma de automação visual que você pode hospedar no próprio servidor. Ele recebe o webhook da Evolution API, processa a mensagem em uma sequência de nós e devolve a resposta chamando a API de envio. A divisão de papéis é clara:
- Evolution API: transporte. Conecta o número, recebe e envia texto, áudio, imagem e documentos.
- n8n: cérebro e orquestração. Regras de negócio, chamada ao modelo de IA, consulta ao CRM, registro de histórico, transferência para humano.
Essa separação tem uma vantagem prática: se um dia você trocar o canal (por exemplo, migrar para a API oficial), a lógica de atendimento no n8n continua praticamente a mesma.
Arquitetura mínima de um atendimento com Evolution API e n8n
Para sair do zero com segurança, estes são os componentes básicos:
- Servidor (uma VPS com Docker costuma bastar para começar), com domínio e HTTPS.
- Evolution API rodando em contêiner, com banco de dados (PostgreSQL) para guardar instâncias e mensagens e, de preferência, Redis para cache.
- n8n no mesmo servidor ou em outro, também com PostgreSQL em vez do banco padrão de testes.
- Modelo de linguagem acessado por API, para interpretar mensagens e gerar respostas.
- Memória de conversa: uma tabela ou chave no Redis que guarda o histórico recente de cada contato.
- Destino humano: uma caixa de atendimento, como o Chatwoot, ou pelo menos um grupo interno onde a equipe recebe os casos transferidos.
Passo a passo: do QR code à primeira resposta com IA
1. Crie a instância e conecte o número
Com a Evolution API no ar, crie uma instância pela API ou pelo painel e leia o QR code com o celular do número que vai atender. Use um número dedicado à empresa, nunca o pessoal de alguém da equipe.
2. Configure o webhook para o n8n
No n8n, crie um fluxo iniciado por um nó Webhook e copie a URL de produção. Na instância da Evolution API, cadastre essa URL e ative apenas os eventos necessários, principalmente o de mensagens recebidas. Menos eventos significa menos ruído e menos processamento.
3. Filtre antes de processar
As primeiras regras do fluxo evitam os erros mais comuns:
- ignorar mensagens enviadas pelo próprio número (senão o robô responde a si mesmo em loop);
- ignorar grupos, a menos que o atendimento seja justamente em grupos;
- tratar cada tipo de mídia: texto segue direto, áudio passa por transcrição, imagem e documento podem ser descritos pelo modelo ou encaminhados.
4. Agrupe mensagens picadas
Muita gente escreve em três ou quatro mensagens seguidas. Se o fluxo responder cada uma, a conversa fica confusa. A solução comum é um pequeno buffer: guardar as mensagens do contato no Redis, aguardar alguns segundos sem novas mensagens e só então enviar o conjunto para a IA.
5. Monte o agente
Use o nó de agente de IA do n8n com instruções claras (quem ele é, o que pode e o que não pode fazer), memória por número de telefone e ferramentas: consultar produto, verificar pedido, criar lead no CRM. Cada ferramenta é, na prática, outro fluxo ou uma chamada HTTP.
6. Responda e registre
Envie a resposta pelo endpoint de texto da Evolution API e grave a interação. Um detalhe simples melhora muito a experiência: ativar o status "digitando" por alguns segundos antes de enviar.
7. Crie a saída para humanos
Defina gatilhos de transferência (pedido explícito, reclamação, assunto fora do escopo) e uma marcação que pausa o robô para aquele contato enquanto a equipe atende. Sem isso, o agente e o atendente acabam respondendo ao mesmo tempo.
Conexão não oficial ou API oficial: qual escolher
A Evolution API permite os dois caminhos, e a escolha tem consequências:
| Critério | Conexão via QR code (não oficial) | API oficial do WhatsApp (Cloud API) |
|---|---|---|
| Custo por mensagem | Não há cobrança da Meta | Cobrança por mensagens de modelo, conforme a categoria |
| Risco de bloqueio | Existe, principalmente com envios em massa | Baixo, desde que as políticas sejam seguidas |
| Início de conversa pela empresa | Livre, mas arriscado | Só com modelos aprovados e contato que aceitou receber |
| Selo e perfil comercial | Limitado | Recursos completos da plataforma |
| Indicado para | Testes, baixo volume, atendimento receptivo | Operação crítica, volume alto, campanhas |
Para uma operação que depende do WhatsApp para vender, a API oficial é o caminho mais seguro. A conexão por QR code funciona bem para validar a ideia, mas use o número com moderação, evite disparos em massa e tenha um plano de migração. As regras e a tabela de preços da Meta mudam com frequência; confira as condições vigentes antes de decidir.
Cuidados para produção
- Proteja a API com chave forte e não exponha o painel sem autenticação.
- Monitore a conexão da instância e receba alerta quando cair.
- Faça backup dos bancos e versione os fluxos do n8n.
- Trate erros: se o modelo de IA falhar, o cliente recebe uma mensagem de contingência e o caso vai para a equipe.
Quando o atendimento precisa conversar com ERP, CRM ou agenda, o trabalho de integrações passa a ser o que mais pesa no projeto.
Perguntas frequentes
Preciso saber programar para usar Evolution API com n8n?
Para um fluxo simples, conhecimento técnico básico resolve. Para produção, com servidor, segurança, memória e integrações, é recomendável ter alguém com experiência em infraestrutura e APIs.
A Evolution API é gratuita?
O software é de código aberto e pode ser hospedado sem licença. Os custos vêm do servidor, do consumo do modelo de IA e, na API oficial, das mensagens cobradas pela Meta.
Posso usar o mesmo número no celular e na automação?
Na conexão por QR code, o número funciona como um aparelho conectado, parecido com o WhatsApp Web. Ainda assim, separar o número de atendimento do uso pessoal evita confusão e riscos.
Conclusão
Evolution API e n8n formam uma base flexível e de baixo custo para atendimento no WhatsApp. O que define o sucesso é o que vem depois da conexão: filtros, buffer de mensagens, agente bem instruído, integração com os sistemas e uma saída clara para humanos.
A Stratia monta esse tipo de atendimento sob medida, com agentes de IA e automações em n8n integradas ao seu CRM. Veja nossos serviços ou peça um diagnóstico gratuito para desenhar o fluxo certo para a sua operação.