técnico

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

06 de julho de 2026

⚠️ Correção importante — atualizado em 14/08/2026

Não use a Evolution API no número de WhatsApp do seu negócio.

Este guia foi publicado em 06/07/2026. Depois disso nós mudamos de posição, e a mudança é séria o bastante para ficar aqui no topo em vez de sumir numa nota de rodapé: a Evolution API é um gateway não oficial. Ela funciona conversando com o WhatsApp por um caminho que não é autorizado pela Meta — e a Meta bane números que fazem isso, sem aviso e sem recurso.

Para a maioria dos negócios pequenos, o número de WhatsApp é o negócio: é a agenda, o histórico do cliente, o canal de venda. Perder o número não é um contratempo técnico, é perder a operação. O risco não vale a economia.

O que fazer em vez disso: use a WhatsApp Business Cloud API oficial, da própria Meta. Exige verificação da sua empresa no Meta Business e cobra por conversa, então dá mais trabalho para começar e tem um custo por mensagem que o caminho não oficial não tinha — mas o número não corre risco de ban. O resto deste guia (a lógica do fluxo, a qualificação em 2 perguntas, o encaminhamento para um humano) continua valendo: troque a camada de conexão, mantenha o desenho.

Nós mesmos removemos a Evolution API da nossa infraestrutura em 12/08/2026 pelo mesmo motivo. Deixamos este artigo no ar, corrigido em vez de apagado, porque quem já seguiu o passo a passo precisa saber que precisa migrar — apagar a página esconderia o problema de exatamente quem mais precisa dele.

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.