técnico

Como automatizar o atendimento de WhatsApp com n8n e Evolution API (guia prático)

06 de julho de 2026

Este guia monta um fluxo simples e real: receber mensagem no WhatsApp → qualificar o lead com 2 perguntas → encaminhar para um humano se for um lead quente. É a base de qualquer automação de atendimento decente.

Pré-requisitos

• Instância da Evolution API rodando (Docker, qualquer VM com 1GB de RAM resolve para um único cliente)
• n8n rodando (self-hosted ou n8n cloud — para dado sensível, recomendamos self-hosted)
• Um número de WhatsApp dedicado para testes

1. Conectar o WhatsApp à Evolution API

curl -X POST http://localhost:8080/instance/create \
  -H "apikey: $EVOLUTION_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"instanceName": "atendimento-cliente-x"}'

Escaneie o QR code retornado pelo endpoint /instance/connect com o WhatsApp da empresa.

2. Webhook recebendo mensagens

Configure o webhook da instância para apontar para o n8n:

curl -X POST http://localhost:8080/webhook/set/atendimento-cliente-x \
  -H "apikey: $EVOLUTION_API_KEY" \
  -d '{"url": "https://seu-n8n.com/webhook/whatsapp-in", "events": ["MESSAGES_UPSERT"]}'

3. Fluxo no n8n

Estrutura mínima do workflow:

1. Webhook node — recebe o payload da Evolution API
2. IF node — filtra apenas mensagens de texto recebidas (ignora fromMe: true)
3. Set node — extrai número e texto da mensagem
4. Switch node — se é a primeira mensagem do contato, envia a pergunta de qualificação; se já está em conversa, avalia a resposta
5. HTTP Request node — chama de volta a Evolution API para enviar a resposta

{
  "number": "{{ $json.from }}",
  "text": "Oi! Pra te direcionar certo: você já é cliente ou quer conhecer nossos serviços?"
}

6. Postgres/Turso node — grava o lead e o estágio da conversa, para não perguntar de novo

4. Lead quente → humano

Quando a resposta indicar interesse real (“quero conhecer”, “quanto custa”), o fluxo dispara uma notificação (Ntfy, e-mail, ou mensagem direta no WhatsApp do vendedor) com o contexto da conversa anexado — o humano entra só quando o lead já está qualificado.

O que isso evita

Esse mesmo resultado é vendido por dezenas de SaaS de automação por R$ 300–800/mês, com seus dados de conversa passando pelo servidor deles. Rodando você mesmo (ou com infraestrutura dedicada do seu provedor), o custo de infraestrutura é uma fração disso, e o dado nunca sai do ambiente que você controla.