Evolution API + n8n: Como Conectar seu Agente de IA ao WhatsApp

Atualizado em setembro 19, 2026

Ilustração: Evolution API + n8n: Como Conectar seu Agente de IA ao WhatsApp
Recomendamos a HostGator Somos parceiros afiliados oficiais — servidores Oracle Cloud no Brasil, com até 70% OFF e 30 dias de garantia.

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

  1. Uma mensagem chega no WhatsApp conectado à sua instância da Evolution API
  2. A Evolution API dispara um webhook para o n8n com o conteúdo da mensagem
  3. O workflow do n8n processa a mensagem (podendo chamar um modelo de IA para gerar a resposta)
  4. 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.

Foto de Rodrigo Mendes de Oliveira
Escrito por

Rodrigo Mendes de Oliveira — Fundador do Ecossistema MR

Mais de 14 anos de experiência em SEO, formado em Sistemas de Informação (UNINOVE) e especialista em IA pelo MIT. Fundador da MR Tecnologia e vencedor do Silicon Valley Startup Award 2023 (StartSE).

Ver planos de VPS para começar
Conteúdo recente