Evolution API + n8n: Como Conectar seu Agente de IA ao WhatsApp
Ter a Evolution API rodando conecta seu servidor ao WhatsApp — mas o valor real aparece quando você liga isso a um agente de IA no n8n, capaz de responder, qualificar leads ou atender clientes automaticamente. Veja como fazer essa ponte.
Como as duas peças se encaixam
- Uma mensagem chega no WhatsApp conectado à sua instância da Evolution API
- A Evolution API dispara um webhook para o n8n com o conteúdo da mensagem
- O workflow do n8n processa a mensagem (podendo chamar um modelo de IA para gerar a resposta)
- O n8n chama de volta a Evolution API para enviar a resposta ao mesmo contato
Passo 1: Configurar o webhook na instância
No Manager da Evolution API, edite a instância e defina a URL do webhook apontando para o endpoint do seu workflow no n8n (um nó “Webhook” configurado como gatilho). Ative pelo menos o evento MESSAGES_UPSERT, que dispara a cada mensagem recebida.
Passo 2: Receber e processar no n8n
O nó de Webhook do n8n recebe o payload da Evolution API, que inclui o número do remetente e o texto da mensagem. A partir daí, um nó de IA (OpenAI, Anthropic ou outro) processa o conteúdo e gera a resposta.
Dica de arquitetura: use um nó de memória (Redis ou banco de dados) para manter o histórico da conversa por número de telefone — isso permite que o agente de IA “lembre” do contexto entre mensagens, em vez de tratar cada uma isoladamente.
Passo 3: Enviar a resposta de volta
Finalize o workflow com uma chamada HTTP para o endpoint /message/sendText da Evolution API, passando o número do destinatário e o texto gerado pela IA. A chamada precisa incluir a apikey configurada na instância.
Erros comuns nessa integração
- Webhook não dispara: confirme que a URL do n8n é acessível publicamente (não é
localhost) e que o workflow está ativo, não só salvo - Resposta duplicada: geralmente causado por retry do webhook — adicione um controle de idempotência pelo ID da mensagem
- Demora nas respostas: normalmente é o tempo de resposta do modelo de IA, não da Evolution API — considere um modelo mais rápido para atendimento em tempo real
Ainda não tem a Evolution API no ar? Comece pelo guia completo de como hospedar a Evolution API em VPS. Se o seu agente de n8n já existe mas ainda não está hospedado, veja também como hospedar um agente de IA em n8n.