Como automatizar o WhatsApp com n8n e Evolution API (passo a passo, com fluxo pronto)

Por João Paulo·Publicado em

Instalar o n8n é a parte fácil. O que faz ele valer a pena é ligar o WhatsApp nele: a partir daí, toda mensagem que chega vira um evento que você pode responder, registrar, classificar ou encaminhar sem ninguém tocar no celular. Este tutorial mostra como fazer isso com a Evolution API, a ponte de código aberto mais usada no Brasil entre o WhatsApp e o n8n.

Ao final você terá um fluxo que:

  1. recebe qualquer mensagem enviada ao número da empresa;
  2. responde na hora com uma saudação e as opções de atendimento;
  3. salva nome, número e mensagem numa planilha do Google;
  4. avisa um grupo ou número da equipe quando alguém pede “falar com atendente”.

Tudo com software livre, rodando na sua própria VPS. Os valores citados são aproximados.

Antes de começar: oficial ou não oficial?

A Evolution API trabalha de dois jeitos:

Modo Como conecta Vantagem Risco
Baileys (não oficial) Lê QR Code como o WhatsApp Web Gratuito, qualquer número, sem cadastro na Meta O número pode ser banido se mandar mensagem em massa ou agir como spam
Cloud API (oficial da Meta) Conta no WhatsApp Business Platform Sem risco de ban, selo de verificação possível Cadastro na Meta, custo por conversa iniciada pela empresa

Para testar e para automações internas (responder quem escreveu, registrar contatos, avisar a equipe), o modo Baileys resolve e é por onde este tutorial começa. Para enviar mensagens a quem não escreveu primeiro (lembretes, campanhas, cobrança), use a API oficial. É assim que fazemos em cliente, e a troca de um modo para o outro no n8n é só mudar a credencial.

O que você vai precisar

Tempo estimado: 40 minutos.

Passo 1: subir a Evolution API com Docker

Na VPS, crie uma pasta e o arquivo de configuração:

mkdir -p ~/evolution && cd ~/evolution
nano docker-compose.yml

Cole:

services:
  evolution:
    image: atendai/evolution-api:v2.2.3
    container_name: evolution
    restart: always
    ports:
      - "127.0.0.1:8080:8080"
    environment:
      - SERVER_URL=https://evo.seudominio.com.br
      - AUTHENTICATION_API_KEY=troque-por-uma-chave-longa-e-aleatoria
      - DATABASE_ENABLED=true
      - DATABASE_PROVIDER=postgresql
      - DATABASE_CONNECTION_URI=postgresql://evolution:senha-forte@postgres:5432/evolution
      - CACHE_REDIS_ENABLED=true
      - CACHE_REDIS_URI=redis://redis:6379/6
      - CACHE_REDIS_PREFIX_KEY=evolution
      - LANGUAGE=pt-BR
    volumes:
      - evolution_instances:/evolution/instances
    depends_on:
      - postgres
      - redis

  postgres:
    image: postgres:16-alpine
    restart: always
    environment:
      - POSTGRES_USER=evolution
      - POSTGRES_PASSWORD=senha-forte
      - POSTGRES_DB=evolution
    volumes:
      - evolution_pg:/var/lib/postgresql/data

  redis:
    image: redis:7-alpine
    restart: always

volumes:
  evolution_instances:
  evolution_pg:

Troque seudominio.com.br, a AUTHENTICATION_API_KEY (use algo como a saída de openssl rand -hex 32) e senha-forte. Depois:

docker compose up -d
docker compose logs -f evolution

Quando aparecer HTTP - ON: 8080, a API está no ar. Pressione Ctrl+C para sair dos logs.

Passo 2: colocar HTTPS no subdomínio

A API ficou escutando só em 127.0.0.1:8080. Para o WhatsApp e o n8n chegarem nela, é preciso um proxy com SSL. Se a VPS tem CyberPanel, crie o site evo.seudominio.com.br, emita o SSL e, em vHost Conf, adicione um context que repasse tudo para 127.0.0.1:8080, exatamente como feito no tutorial do n8n, passo 3. Se usa Nginx ou Traefik, o bloco é o mesmo que você já tem para o n8n, trocando a porta.

Teste no navegador: https://evo.seudominio.com.br deve mostrar um JSON com "status": 200 e a versão da API.

Passo 3: criar a instância e ler o QR Code

Acesse o gerenciador em https://evo.seudominio.com.br/manager, informe a URL e a API KEY do passo 1 e clique em Instance +. Dê o nome empresa, deixe o canal como Baileys e salve.

Abra a instância e clique em Get QR Code. No celular com o chip da empresa: WhatsApp → Mais opções → Dispositivos conectados → Conectar dispositivo → aponte para o QR. Em alguns segundos o status muda para open. Pronto, o número está conectado.

Duas configurações importantes na instância, na aba Settings:

Passo 4: criar o webhook no n8n

No n8n, crie um fluxo novo e adicione um nó Webhook:

Copie a Production URL (algo como https://n8n.seudominio.com.br/webhook/whatsapp-entrada). Clique em Listen for test event para deixá-lo esperando.

Volte à Evolution API, na instância empresa, aba Webhook:

Salve. Mande uma mensagem de outro celular para o número da empresa. O n8n deve receber um JSON parecido com este:

{
  "event": "messages.upsert",
  "instance": "empresa",
  "data": {
    "key": { "remoteJid": "5562999990000@s.whatsapp.net", "fromMe": false },
    "pushName": "Maria",
    "message": { "conversation": "Oi, queria saber o preço" },
    "messageType": "conversation"
  }
}

Os campos que importam: data.key.remoteJid (quem mandou), data.pushName (nome no WhatsApp), data.message.conversation (texto) e data.key.fromMe (se foi você que enviou, para o fluxo ignorar).

Passo 5: filtrar e responder

Adicione um nó IF depois do webhook com duas condições (ambas verdadeiras):

No ramo true, adicione um nó HTTP Request para responder:

{
  "number": "{{ $('Webhook').item.json.body.data.key.remoteJid }}",
  "text": "Oi, {{ $('Webhook').item.json.body.data.pushName }}! Aqui é o atendimento da Empresa X. Responda com o número da opção:\n\n1 - Preços e serviços\n2 - Horário e endereço\n3 - Falar com atendente"
}

Ative o fluxo e mande “oi” do outro celular. A resposta deve chegar em um ou dois segundos.

Para tratar as opções, troque o nó IF por um Switch sobre {{ $json.body.data.message.conversation }} com as regras 1, 2, 3 e um ramo padrão. Cada ramo tem seu próprio HTTP Request com o texto certo. O ramo padrão manda o menu de novo.

Passo 6: salvar o contato numa planilha

Crie uma planilha no Google Sheets com as colunas data, nome, numero, mensagem. No n8n, depois do IF, adicione um nó Google Sheets (operação Append row) ligado à planilha, mapeando:

A credencial do Google Sheets no n8n é OAuth; o próprio n8n explica como criar o app no Google Cloud na tela de credencial. Leva uns 10 minutos na primeira vez.

Com isso, toda conversa vira linha na planilha. É o CRM mais barato que existe, e dá para ligar depois a qualquer outro sistema.

Passo 7: avisar a equipe quando alguém pede atendente

No ramo 3 do Switch, adicione mais um HTTP Request igual ao de resposta, mas com number fixo no WhatsApp da pessoa responsável (ou o ID de um grupo, no formato 1203630000000000@g.us, que você pega chamando GET /group/fetchAllGroups/empresa?getParticipants=false) e o texto:

Novo pedido de atendimento
Nome: {{ $('Webhook').item.json.body.data.pushName }}
Número: {{ $('Webhook').item.json.body.data.key.remoteJid.split('@')[0] }}
Mensagem: {{ $('Webhook').item.json.body.data.message.conversation }}

E, para o cliente, responda “Já avisei a equipe, alguém fala com você em instantes”. A partir daí quem atende continua a conversa pelo WhatsApp Web normal, porque a Evolution não bloqueia o uso manual do número.

Onde a IA entra

Com o fluxo acima funcionando, trocar o menu de números por uma resposta inteligente é adicionar um nó entre o IF e o HTTP Request de resposta: o nó OpenAI ou Anthropic do n8n, com um prompt de sistema contendo os serviços, preços, horário e o tom da empresa, e a mensagem do cliente como entrada. A resposta do modelo vai para o campo text. Para guardar o histórico da conversa e não repetir perguntas, use o nó Window Buffer Memory com remoteJid como chave de sessão.

É exatamente essa arquitetura que descrevemos, do ponto de vista do dono do negócio, em chatbot de WhatsApp com IA: como funciona e quanto custa e nos guias para clínicas e salões de beleza.

Problemas comuns

Quanto custa manter isso

Item Custo aproximado
VPS (a mesma do n8n, 4 GB de RAM aguenta n8n + Evolution + Postgres) R$ 40 a R$ 80/mês
Evolution API e n8n R$ 0 (código aberto)
Chip da empresa R$ 20 a R$ 40/mês
API oficial da Meta, se migrar R$ 0 para responder quem escreveu; alguns centavos por conversa que a empresa inicia
IA, se ligar R$ 30 a R$ 150/mês conforme o volume

Ou seja: por menos de R$ 100 por mês uma pequena empresa tem atendimento automático, registro de contatos e aviso para a equipe, sem mensalidade de plataforma de chatbot.

Na prática, na WebMedula

Na WebMedula este é o esqueleto de boa parte dos projetos de atendimento. A gente instala o n8n e a Evolution API na VPS do cliente com domínio, SSL e backup diário, conecta o número (oficial quando o cliente precisa disparar mensagens), monta o fluxo com IA treinada no negócio e liga à agenda ou ao CRM que a empresa já usa. O cliente recebe os acessos e um vídeo curto mostrando onde mexer para trocar textos e horários.

Quem quer só a base pronta para montar os próprios fluxos contrata a instalação do n8n na VPS, por R$ 297, e segue este tutorial. Quem quer o atendimento inteiro funcionando, com IA e integração, contrata o atendimento no WhatsApp com IA. E quem ainda não sabe o que automatizar primeiro começa pelo diagnóstico gratuito.

Perguntas frequentes

Preciso deixar o celular ligado? No modo Baileys, o celular precisa se conectar à internet de vez em quando, como no WhatsApp Web, mas não precisa ficar ligado o tempo todo. Na API oficial, não existe celular: o número fica só na nuvem.

Posso usar meu número atual da empresa? Pode, mas se ele já tem muito histórico e grupos, prefira um chip novo para a automação e mantenha o antigo para a equipe. Menos risco e menos confusão.

A Evolution API é segura? Ela roda na sua VPS, só você tem a chave e as mensagens não passam por terceiros. O cuidado é o mesmo de qualquer serviço: HTTPS, chave longa, porta não exposta na internet (por isso o 127.0.0.1 no Docker).

Dá para conectar mais de um número? Sim. Cada número é uma instância na mesma Evolution API, e cada instância aponta para o webhook que você quiser no n8n.

Funciona com Typebot, Chatwoot ou Dify? Funciona. A Evolution tem integração nativa com os três. Mas para começar, o n8n sozinho já cobre quase tudo, e você entende o que está acontecendo.

Material gratuito

Grátis: 50 prompts para ganhar dinheiro com IA

Prompts prontos para copiar no ChatGPT, Gemini ou Claude: achar sua ideia, conseguir clientes, criar conteúdo, vender e cobrar o preço certo. Receba o PDF agora.

Leia também

WhatsApp