N8N + Agente de IA no WhatsApp: Como Criar do Zero em 2026 (Guia Completo)

O que é N8N e por que está explodindo em 2026?

O N8N é a ferramenta de automação que mais cresce no mundo — e no Brasil não é diferente. Com crescimento de +200% nas buscas em 2026, o N8N se tornou a escolha número 1 de desenvolvedores e empreendedores que querem automatizar processos sem depender de ferramentas caras como Zapier ou Make.

Mas o que realmente mudou o jogo foi a combinação do N8N com Agentes de IA — e é exatamente isso que vamos construir neste tutorial.

O que você vai aprender

Neste guia completo você vai aprender a criar um agente de IA no WhatsApp usando N8N que:

• Recebe mensagens dos seus clientes automaticamente
• Processa com Gemini (IA do Google) ou OpenAI
• Responde de forma inteligente com base no contexto do negócio
• Mantém memória da conversa entre mensagens
• Encaminha para humano quando necessário

O que é um Agente de IA no N8N?

Diferente de um fluxo de automação simples, um agente de IA no N8N tem capacidade de:

• Raciocinar sobre o que o cliente precisa
• Usar ferramentas (buscar informações, acessar banco de dados, enviar emails)
• Tomar decisões baseadas no contexto
• Manter memória entre turnos da conversa

O N8N lançou o node nativo de AI Agent que torna tudo isso muito mais simples de configurar.

Pré-requisitos

Antes de começar você precisa:

• N8N instalado (self-hosted ou cloud)
• Evolution API rodando (para conectar ao WhatsApp)
• Conta na Google AI Studio (para usar Gemini gratuitamente)
• Conhecimento básico de N8N (saber criar workflows)

Passo 1 — Configurar o Webhook do WhatsApp

No N8N, crie um novo workflow e adicione um node Webhook: Método: POST Path: /whatsapp-agent Resposta: Immediately

Na Evolution API, configure o webhook para apontar para essa URL:

POST /webhook/set/{sua-instancia}
{
  "url": "https://seu-n8n.com/webhook/whatsapp-agent",
  "events": ["MESSAGES_UPSERT"],
  "webhook_by_events": true
}

Passo 2 — Filtrar apenas mensagens de texto

Após o Webhook, adicione um node IF para filtrar:

// Condição — só processar mensagens de texto reais
{{ $json.data.message?.conversation !== undefined 
   && !$json.data.key.fromMe }}

Isso evita processar mensagens enviadas por você mesmo ou notificações do sistema.

Passo 3 — Configurar o Agente de IA com Gemini

Adicione o node AI Agent do N8N:

Configurações do Agent:

• Model: Google Gemini (adicionar credencial com sua API Key do Google AI Studio)
• Memory: Window Buffer Memory (últimas 10 mensagens)

System Prompt: Você é um assistente virtual da [Nome da Empresa]. Seu nome é [Nome do Agente]. Informações sobre a empresa:

[Descreva seu negócio aqui] Horário: [seus horários] Serviços: [seus serviços] Preços: [suas condições]

Regras:

Responda sempre em português brasileiro Seja cordial e profissional Se não souber a resposta, diga que vai verificar Para emergências, passe o número: [seu telefone]

Passo 4 — Extrair dados da mensagem

Antes do AI Agent, adicione um Code node para estruturar os dados:

const data = $input.first().json.data

return [{
  json: {
    phone: data.key.remoteJid.replace('@s.whatsapp.net', ''),
    message: data.message?.conversation 
              ?? data.message?.extendedTextMessage?.text 
              ?? '',
    pushName: data.pushName ?? 'Cliente',
    sessionId: data.key.remoteJid, // para memória individual
  }
}]

Passo 5 — Enviar resposta para o WhatsApp

Após o AI Agent, adicione um HTTP Request node: Método: POST URL: https://sua-evolution-api/message/sendText/{instancia} Header: apikey: sua-chave-secreta

Body:

{
  "number": "{{ $('Code').item.json.phone }}",
  "text": "{{ $json.output }}"
}

Passo 6 — Adicionar memória de conversação

O segredo para um agente realmente inteligente é a memória.

No node AI Agent, configure:

• Memory Type: Window Buffer Memory
• Session ID: {{ $('Code').item.json.sessionId }}
• Window Size: 10 (lembra as últimas 10 mensagens)

Isso garante que o agente lembra o contexto de cada cliente individualmente.

N8N vs Gemini vs OpenAI — Qual IA usar?

Em 2026, as principais opções para o agente são:

Para começar, Gemini 2.5 Flash é a melhor escolha — é gratuito para volumes médios e tem qualidade excelente para atendimento.

Problemas comuns e como resolver

Agente não responde: → Verificar se o webhook está ativo no N8N → Confirmar que a Evolution API está enviando para a URL correta

Respostas muito longas: → Adicionar no System Prompt: "Responda sempre de forma concisa, máximo 3 parágrafos"

Agente esquece a conversa: → Verificar se o Session ID está sendo passado corretamente → Conferir se o Memory node está configurado

Mensagens duplicadas: → Adicionar verificação !$json.data.key.fromMe no filtro IF

Alternativa sem configuração técnica

Se você chegou até aqui e quer o resultado sem todo esse processo técnico, o Zently já tem tudo isso pronto — N8N, Evolution API, Gemini e memória de conversação configurados e funcionando em 15 minutos, por R$ 97/mês.

Para escolher o modelo de IA do seu agente N8N, você tem duas opções principais: o Claude AI da Anthropic, ideal pela confiabilidade em produção e contexto de 200k tokens, ou o Gemini do Google, com contexto de 1M tokens e integração nativa com o Google Workspace. A conexão do N8N com o WhatsApp usa a Evolution API — veja o tutorial completo em N8N + WhatsApp + Evolution API. Para empresas de nichos específicos, temos guias dedicados para clínicas e imobiliárias.

Conclusão

Criar um agente de IA no WhatsApp com N8N é totalmente possível — mas exige tempo de configuração, manutenção e conhecimento técnico.

Para quem quer aprender e tem tempo para configurar, este tutorial dá todo o necessário. Para quem quer resultado rápido, soluções prontas como o Zently são a melhor escolha.

Tem dúvidas sobre o tutorial? Deixa nos comentários!