N8N + WhatsApp + Evolution API: Como Conectar em 30 Minutos

O que você vai construir neste tutorial

Ao final deste guia você terá:

• Evolution API rodando no seu servidor (ou VPS)
• N8N conectado ao WhatsApp via webhook
• Um fluxo básico que responde mensagens automaticamente

Tempo estimado: 30 a 60 minutos

Nível: Intermediário (você precisa saber o básico de N8N)

O que é a Evolution API?

A Evolution API é uma solução open source que permite conectar o WhatsApp ao seu sistema via API REST. Ela emula o WhatsApp Web e expõe endpoints para enviar/receber mensagens.

É a base da maioria das automações de WhatsApp no Brasil.

Pré-requisitos

• VPS com Ubuntu 22.04 (mínimo 2GB RAM)
• Docker e Docker Compose instalados
• N8N rodando (cloud ou self-hosted)
• Número de WhatsApp dedicado (não use seu número pessoal)

Passo 1 — Instalar a Evolution API

# Clone o repositório
git clone https://github.com/EvolutionAPI/evolution-api
cd evolution-api

# Copiar arquivo de configuração
cp .env.example .env

# Editar configurações
nano .env

Configurações importantes no .env:

AUTHENTICATION_API_KEY=sua_chave_secreta_aqui
DATABASE_PROVIDER=postgresql

# Subir os containers
docker compose up -d

# Verificar se está rodando
docker compose logs -f

Passo 2 — Criar uma instância WhatsApp

Após a Evolution API estar rodando, acesse o Swagger:

http://seu-ip:8080/docs

Crie uma nova instância via POST /instance/create:

{
  "instanceName": "meu-negocio",
  "integration": "WHATSAPP-BAILEYS"
}

Escaneie o QR Code com o WhatsApp do seu número comercial.

Passo 3 — Configurar o Webhook no N8N

No N8N, crie um novo workflow com o node Webhook:

1. Adicione um node Webhook
2. HTTP Method: POST
3. Path: /whatsapp
4. Copie a URL gerada

Volte na Evolution API e configure o webhook:

POST /webhook/set/meu-negocio
{
  "url": "https://seu-n8n.com/webhook/whatsapp",
  "events": ["MESSAGES_UPSERT"]
}

Passo 4 — Criar o fluxo de resposta

No N8N, após o Webhook, adicione:

1. IF node → verificar se é mensagem de texto
2. Function node → extrair texto e número do remetente
3. HTTP Request node → chamar sua IA (OpenAI, Claude, etc.)
4. HTTP Request node → enviar resposta via Evolution API

// Function node — extrair dados da mensagem
const message = $input.first().json
return [{
  json: {
    phone: message.data.key.remoteJid.replace('@s.whatsapp.net', ''),
    text: message.data.message?.conversation ?? ''
  }
}]

Passo 5 — Enviar resposta

// HTTP Request para enviar mensagem de volta
// POST https://sua-evolution-api/message/sendText/meu-negocio
{
  "number": "{{ $json.phone }}",
  "text": "{{ $json.resposta_da_ia }}"
}

Resultado final

Após configurar tudo, seu fluxo vai:

1. Receber mensagem do cliente
2. Processar com IA
3. Responder automaticamente em segundos

Com o N8N conectado ao WhatsApp, o próximo passo é adicionar inteligência ao fluxo. O guia N8N + Agente de IA no WhatsApp mostra como integrar o Claude ou Gemini como cérebro do agente. Para escolher o melhor modelo de IA, compare o Claude AI e o Gemini lado a lado. E para ver a automação aplicada em negócios reais, temos casos detalhados para clínicas e imobiliárias.

Alternativa sem configuração técnica

Se você chegou até aqui e achou complexo demais, o Zently faz tudo isso por você — Evolution API, N8N, IA e WhatsApp configurados e rodando em 15 minutos, por R$ 97/mês.