🤖 template n8n + Evolution API · importável

Um atendente de WhatsApp com IA rodando sozinho

Workflow n8n pronto pra importar: o cliente manda mensagem no seu WhatsApp comum (via Evolution API, sem aprovação da Meta), a IA responde em português no seu tom, e cada conversa cai numa planilha. Abaixo, o fluxo completo e o passo a passo do zero — subir, conectar, configurar e testar.

⬇️

Workflow n8n (.json)

Importa no n8n: menu (•••) → Import from File. Os 8 nós já vêm conectados.

Baixar workflow →

📊

Planilha de leads (.csv)

Importa no Google Sheets pra ter as colunas certas. É onde cada conversa é registrada.

Baixar planilha →

O que esse robô faz

Responde no WhatsApp na hora, 24h por dia, no seu tom de voz (você define a persona).
Usa o seu número comum via Evolution API — sem precisar da aprovação da Meta Cloud API.
Ignora as próprias mensagens e mensagens de grupo (não fica respondendo besteira).
Registra cada conversa numa planilha (data, número, nome, mensagem e resposta) — seu funil de leads.
É 100% editável: troca a persona, o modelo de IA (OpenAI ou Claude) e o que faz com o lead.

Como o fluxo funciona

1. Webhook (mensagem chega)→ 2. CONFIG→ 3. Filtro→ 4. Extrair→ 5. IA escreve a resposta→ 6. Responde no WhatsApp→ 7. Registra na planilha

A Evolution API manda cada mensagem recebida pro Webhook do n8n. O nó CONFIG guarda seus dados (URL, instância, persona, planilha) — é o único lugar que você edita de verdade. O Filtro descarta eco e grupos. Extrair pega número, nome e texto. A IA escreve a resposta no seu tom. Responder devolve pelo WhatsApp e Registrar grava a conversa na planilha.

O que você precisa

Passo a passo (do zero)

1. Subir a Evolution API (Docker)

A Evolution API é open-source e roda num servidor seu (uma VPS de R$ 20–40/mês na Hetzner, Contabo, DigitalOcean já dá conta). Com o Docker instalado, crie um arquivo docker-compose.yml:

services:
  evolution-api:
    image: atendai/evolution-api:v2.1.1
    container_name: evolution
    restart: always
    ports:
      - "8080:8080"
    environment:
      - AUTHENTICATION_API_KEY=troque-por-uma-chave-secreta
      - LANGUAGE=pt-BR
    volumes:
      - evolution_instances:/evolution/instances
volumes:
  evolution_instances:

Suba com docker compose up -d. Em segundos a API está em http://SEU-IP:8080 e o painel (Manager) em http://SEU-IP:8080/manager.

Guarde o valor de AUTHENTICATION_API_KEY — é a sua apikey, usada em tudo (login do Manager, criar instância, enviar mensagem). Em produção, coloque um domínio com HTTPS na frente (Cloudflare Tunnel, Caddy ou Nginx) e siga o banco de dados recomendado em doc.evolution-api.com.

2. Conectar o seu WhatsApp (QR Code)

Abra o Manager (http://SEU-IP:8080/manager), faça login com a sua apikey e clique em + Instance. Dê um nome (ex.: atendimento) — é esse nome que vai no CONFIG como instance. Clique pra conectar e leia o QR Code com o WhatsApp do número que vai atender (WhatsApp → Aparelhos conectados → Conectar aparelho).

Prefere por API? Dá no mesmo:

curl -X POST https://SEU-EVOLUTION/instance/create \
  -H "apikey: SUA-CHAVE" -H "Content-Type: application/json" \
  -d '{"instanceName":"atendimento","integration":"WHATSAPP-BAILEYS","qrcode":true}'

Use um número dedicado pro atendimento. Enquanto o robô está ligado, evite usar esse WhatsApp no celular ao mesmo tempo pra não confundir as respostas.

3. Ter o n8n no ar (com HTTPS)

O webhook precisa de uma URL pública HTTPS. Duas opções:
• n8n Cloud (mais fácil): conta em n8n.io, já vem com HTTPS.
• Self-host (Docker), na mesma VPS da Evolution:

docker run -d --restart always --name n8n -p 5678:5678 \
  -e N8N_HOST=seu-n8n.seudominio.com \
  -e WEBHOOK_URL=https://seu-n8n.seudominio.com/ \
  -v ~/.n8n:/home/node/.n8n docker.n8n.io/n8nio/n8n

Exponha com HTTPS (Cloudflare Tunnel/Caddy). Sem HTTPS público, a Evolution não consegue entregar as mensagens no n8n.

4. Importar o workflow

Baixe o workflow .json aqui em cima. No n8n: canto superior direito → (•••) → Import from File → selecione o arquivo. Os 8 nós aparecem conectados. Salve (Ctrl+S). Ainda não ative — primeiro vamos configurar as credenciais e o CONFIG.

5. Criar a planilha de leads

1. Baixe a planilha .csv aqui em cima.
2. No Google Drive: Novo → Planilhas Google → Arquivo → Importar → Upload e suba o CSV (escolha "Substituir planilha").
3. Renomeie a aba (lá embaixo) para exatamente Leads — o workflow grava nessa aba.
4. Copie o ID da planilha: está na URL, entre /d/ e /edit →

docs.google.com/spreadsheets/d/ESTE_PEDAÇO_É_O_ID/edit

Esse ID vai no nó CONFIG (passo 7). As colunas já vêm certas: Data, Numero, Nome, Mensagem, Resposta, Observacoes. Pode apagar a linha de exemplo.

6. Configurar as 3 credenciais no n8n

a) OpenAI — abra o nó IA - OpenAI → Credential → Create New → cole sua API key (platform.openai.com/api-keys). Modelo padrão: gpt-4o-mini (barato).

b) Evolution (apikey) — abra o nó Responder no WhatsApp → Credential → Create New → tipo Header Auth → Name: apikey · Value: a sua AUTHENTICATION_API_KEY.

c) Google Sheets — abra o nó Registrar na planilha → Credential → Create New → Google Sheets OAuth2 → Sign in with Google e autorize. (Detalhe de acesso no bloco abaixo.)

7. Editar o nó CONFIG (a única edição de verdade)

Abra o nó CONFIG e preencha os 4 campos:

evolutionUrl — a URL da sua Evolution (ex.: https://SEU-EVOLUTION), sem barra no fim.
instance — o nome da instância (ex.: atendimento).
sheetId — o ID da planilha (do passo 5).
persona — o cérebro do atendente. Troque os [colchetes] pelos dados do seu negócio: nome, o que vende, horário, pagamento, prazo, endereço. Quanto mais específico, melhor ele responde.

8. Apontar o webhook da Evolution pro n8n

Abra o nó Webhook WhatsApp e copie a Production URL (algo como https://seu-n8n.../webhook/whatsapp-evolution). Agora diga pra Evolution mandar as mensagens pra lá:

curl -X POST https://SEU-EVOLUTION/webhook/set/atendimento \
  -H "apikey: SUA-CHAVE" -H "Content-Type: application/json" \
  -d '{"webhook":{"enabled":true,
       "url":"https://seu-n8n.../webhook/whatsapp-evolution",
       "webhookByEvents":false,
       "events":["MESSAGES_UPSERT"]}}'

Dá pra fazer o mesmo pelo Manager, na aba Webhook/Events da instância: liga, cola a URL e marca só o evento MESSAGES_UPSERT.

9. Ativar e testar

No n8n, clique em Active (canto superior direito). Mande uma mensagem de outro número pro WhatsApp conectado. Em 2–5 segundos você recebe a resposta da IA, e uma linha nova aparece na aba Leads da planilha. Travou? Abra a aba Executions do n8n pra ver onde parou (e veja o bloco "Deu errado?" abaixo).

Como dar acesso à planilha

Duas formas — a primeira é a mais fácil:

OAuth2 (recomendado): na credencial Google Sheets do n8n, clique Sign in with Google e entre com a conta que é dona da planilha. Pronto — o n8n passa a ter acesso a ela. É o caminho de 2 cliques.
Service Account (avançado/servidor): crie uma conta de serviço no Google Cloud, baixe o JSON e use na credencial "Service Account" do n8n. Depois abra a planilha → Compartilhar → cole o e-mail da conta de serviço (algo como nome@projeto.iam.gserviceaccount.com) como Editor. Sem esse compartilhamento, o n8n recebe "permission denied".

Dica: se aparecer erro de permissão, 9 em 10 vezes é a planilha não compartilhada com a conta certa, ou a aba não se chamar exatamente Leads.

Personalizar

Usar o Claude no lugar do GPT: no nó IA, troque a URL por https://api.anthropic.com/v1/messages, ajuste os headers (x-api-key + anthropic-version) e o corpo pro formato da Anthropic. O resto do fluxo continua igual.
Mudar o tom: tudo vive no campo persona do CONFIG. Escreva como você fala com cliente.
Avisar você quando for lead quente: adicione depois da IA um nó de Telegram/Slack/E-mail com uma condição (ex.: quando a mensagem contém "orçamento" ou "preço").
Memória da conversa: pra ele lembrar o histórico, troque o registro simples por uma busca na planilha (ou um banco) por número antes de chamar a IA.