WhatsApp Business com n8n e Evolution API: Guia 2026

Introdução

Automatizar o WhatsApp Business com n8n e Evolution API resolve a dor de perder leads por falta de resposta rápida e escalar atendimento sem contratar mais pessoas. Com essa integração, você envia mensagens em lote, filtra palavras-chave para respostas automáticas e mantém o WhatsApp funcionando 24/7, mesmo de madrugada. O n8n age como um "canivete suíço" de automação low-code, enquanto a Evolution API conecta seu número ao WhatsApp sem depender das limitações oficiais da Meta.

A combinação custa menos que R$ 50/mês (VPS + automação) e substitui ferramentas pagas como ManyChat ou Chatfuel. Funciona tanto para um e-commerce pequeno quanto para um prestador de serviços que recebe 50 mensagens por dia. O segredo está em usar webhooks para receber mensagens em tempo real e HTTP Requests para enviar respostas ou disparos, tudo sem uma linha de código.

Por que automatizar o WhatsApp Business é estratégico para pequenos negócios

Atender manualmente no WhatsApp Business vira um pesadelo quando você recebe mais de 20 mensagens por dia: resposta lenta afasta clientes, erros humanos são comuns e você perde vendas para concorrentes que respondem em 2 minutos. Um estudo da HubSpot mostra que 82% dos consumidores brasileiros esperam resposta em menos de 1 hora — e 57% desistem se não forem atendidos no primeiro contato.

Imagine um e-commerce de roupas que recebe 100 pedidos por mês: com automação, você filtra "pedido", "frete" e "troca" para responder automaticamente, envia confirmações de pagamento e até lembra de cobrar avaliação. Um prestador de serviços, como um encanador, pode usar um bot para agendar visitas via WhatsApp, enviar orçamentos e confirmar presença, aumentando a produtividade em 40%. Sem automação, você gasta 4 horas/dia só respondendo mensagens.

O guia completo do n8n explica como criar esses fluxos do zero. A vantagem é escalar sem aumentar custos: sua equipe de 1 pessoa atende 200 clientes como se fossem 10, com a mesma infraestrutura.

O que é necessário para começar: requisitos técnicos e ferramentas

Você precisa de 4 coisas para colocar a automação no ar: um número WhatsApp Business verificado, um servidor (VPS ou nuvem), o n8n instalado e a Evolution API rodando. A lista abaixo detalha cada item com custos e requisitos mínimos.

Item	Requisitos	Custo (2024)	Onde obter
WhatsApp Business	Número verificado (CNPJ ou CPF), perfil completo, política de privacidade no site	R$ 0 (custo da verificação)	WhatsApp Business
Servidor (VPS ou nuvem)	1 vCPU, 2GB RAM, 20GB SSD, sistema operacional Ubuntu 22.04	R$ 30–R$ 80/mês	DigitalOcean, Linode, ou AWS EC2
n8n	Instância Docker ou n8n.io (gratuito para até 1 usuário)	R$ 0 (self-hosted) ou R$ 20/mês (nuvem)	n8n.io
Evolution API	Node.js 18+, banco Redis (opcional), porta 3000 aberta	R$ 0 (open source)	GitHub da Evolution API

Self-hosted vs nuvem: qual escolher?

A tabela abaixo compara as duas opções para você decidir onde rodar o n8n e a Evolution API.

Critério	Self-hosted (VPS)	Nuvem (n8n.io)
Custo inicial	R$ 30–R$ 80/mês (VPS)	R$ 20/mês (plano básico)
Controle total	Sim (acesso root, personalização)	Limitado (depende da nuvem)
Desempenho	Depende da VPS (evite VPS baratos com 1GB RAM)	Estável e escalável
Segurança	Você gerencia (firewall, backups)	Segurança gerenciada pela nuvem
Instalação	Requer Docker e configuração manual	1 clique no painel da nuvem

Para começar, recomendo usar uma VPS de R$ 40/mês (ex: DigitalOcean) com Docker instalado. Se preferir praticidade, use o plano gratuito do n8n.io por 14 dias e migre depois. Os links abaixo ajudam na instalação:

Evolution API: o que é e como funciona para WhatsApp Business

A Evolution API é um fork do Baileys (cliente oficial não-oficial do WhatsApp) que adiciona uma camada de API REST para controlar números do WhatsApp sem usar o app oficial. Ela surgiu em 2022 como alternativa ao ChatAPI e à WhatsApp Cloud API, que exigem pagamento ou aprovação da Meta.

A Evolution API se diferencia por ser 100% open source, fácil de instalar em um VPS e compatível com n8n via webhooks. Enquanto a WhatsApp Cloud API custa US$ 0.005 por mensagem e exige aprovação de 30 dias, a Evolution roda no seu servidor com custo zero — ideal para pequenos negócios que não querem depender de terceiros.

No Brasil, ela é popular porque não tem limite de mensagens (apenas do WhatsApp oficial) e permite usar números comuns (não precisa ser número comercial). A comunidade brasileira contribui ativamente com templates e tutoriais, o que facilita a configuração.

Documentação oficial da Evolution API

Instalando a Evolution API: passo a passo para conectar ao WhatsApp Business

Você vai instalar a Evolution API em um VPS com Ubuntu 22.04, autenticar o número via QR Code e testar a API com Insomnia/Postman antes de integrar com o n8n. Siga os comandos abaixo em ordem — cada passo é obrigatório para evitar erros de autenticação ou bloqueio.

Passo 1: Preparar o servidor

Conecte-se ao seu VPS via SSH e execute:

  sudo apt update && sudo apt upgrade -y

sudo apt install -y curl git nodejs npm redis-server

sudo systemctl enable redis-server --now

curl -fsSL https://get.docker.com | sh

sudo usermod -aG docker $USER

newgrp docker

Resultado esperado: Docker instalado, Node.js 18+ e Redis opcional (caso queira usar filas). Reinicie o terminal ou faça logout/login para aplicar as permissões do Docker.

Passo 2: Clonar e configurar a Evolution API

Clone o repositório, instale dependências e configure as variáveis de ambiente (.env):

  git clone https://github.com/EvolutionAPI/evolution-api.git

cd evolution-api

npm install

cp .env.example .env

Edite o arquivo .env com:

  DATABASE_ENABLED=false

TYPEORM_CONNECTION=sqlite

JWT_SECRET=sua_senha_secreta_aqui

Resultado esperado: Arquivo .env configurado com JWT_SECRET definido (use uma senha forte).

Passo 3: Iniciar a Evolution API e autenticar o número

Suba a API em segundo plano e abra a porta 3000 no firewall:

  npm run start:prod &

Abra o firewall (se usar UFW):

  sudo ufw allow 3000

sudo ufw enable

Agora, use o Insomnia ou Postman para chamar o endpoint de autenticação:

Método: POST
URL: http://SEU_IP_VPS:3000/instance/create
Body (JSON): { "instanceName": "meu_whatsapp" }

Resultado esperado: Um QR Code aparece no terminal do servidor. Abra o WhatsApp no celular, vá em Dispositivos conectados > Conectar dispositivo > Scan QR Code e escaneie. Após 10 segundos, o número estará autenticado e aparecerá como "connected" no terminal.

Passo 4: Testar a API com Insomnia/Postman

Envie uma mensagem de teste para confirmar que tudo funciona:

Método: POST
URL: http://SEU_IP_VPS:3000/message/sendText
Headers:
- Authorization: Bearer sua_jwt_secret_aqui
- Content-Type: application/json
Body (JSON): { "number": "5511999999999@c.us", "text": "Teste de automação via Evolution API" }

Resultado esperado: A mensagem chega no número de destino em menos de 5 segundos. Se der erro 401, verifique o JWT_SECRET no .env e no header.

Dica de quem usa há 1 ano

Evite usar números pessoais para automação — o WhatsApp pode bloquear o número se detectar comportamento suspeito. Sempre use um número dedicado para business e configure um captcha no primeiro acesso (a Evolution API já inclui isso automaticamente).

Conectando n8n à Evolution API: passo a passo com webhook e HTTP Request

Use o nó Webhook no n8n para receber mensagens do WhatsApp em tempo real e o nó HTTP Request para enviar respostas ou disparos. Configure o webhook com um secret para validar requisições e evite expor sua API.

O segredo está no endpoint de recebimento (webhook) e no cabeçalho Authorization para autenticar chamadas na Evolution API. Configure a URL do webhook no painel da Evolution API com o formato https://seu-n8n.com/webhook/whatsapp.

Passo 1: Criar o fluxo de recebimento de mensagens no n8n

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

Configure o Webhook:
- HTTP Method: POST
- Path: whatsapp
- Response Mode: Last Node
- Options > Respond to Webhook: Immediately
Adicione um nó Set logo após o Webhook para extrair dados da mensagem:

{ "json": { "remetente": $json["from"], "mensagem": $json["body"], "timestamp": $json["timestamp"] } }
Resultado esperado: O Webhook ficará disponível em https://SEU_N8N.com/webhook/whatsapp e retornará 200 OK após o processamento.

Passo 2: Registrar o webhook na Evolution API

No terminal do VPS, envie uma requisição para registrar o webhook na Evolution API:

  curl -X POST "http://localhost:3000/webhook/set" \
  -H "Authorization: Bearer SUA_JWT_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://SEU_N8N.com/webhook/whatsapp",
    "events": ["message_upsert"],
    "secret": "SEU_WEBHOOK_SECRET"
  }'

Resultado esperado: O webhook é registrado na Evolution API e passa a enviar eventos de mensagens recebidas para o n8n.

Passo 3: Enviar resposta automática com HTTP Request

Adicione um nó HTTP Request após o Set para responder automaticamente:

Method: POST
URL: http://SEU_IP_VPS:3000/message/sendText
Headers:
- Authorization: Bearer SUA_JWT_SECRET
- Content-Type: application/json
Body (JSON):
{ "number": "{{ $json.remetente }}", "text": "Olá! Recebemos sua mensagem: {{ $json.mensagem }}. Em breve, retornaremos com uma resposta." }

Resultado esperado: O remetente recebe a resposta automática em menos de 10 segundos após enviar a mensagem.

Dica técnica

Use o nó IF no n8n para filtrar mensagens por palavras-chave (ex: "orcamento", "troca", "cancelar") e direcionar para fluxos específicos. Isso reduz o uso de HTTP Requests desnecessários e melhora a performance.

Criando automações prontas: respostas automáticas, filtros e fluxos avançados

Automações prontas incluem resposta para perguntas frequentes, encaminhamento por setor, disparo de mensagens em lote e lembrete de pagamento. Use nós IF, Switch e Delay para criar lógica avançada sem código.

Um fluxo comum para e-commerce: recebe mensagem, identifica palavra-chave ("pedido"), envia status do pedido via HTTP Request, e agenda lembrete de avaliação para 7 dias depois usando nó Schedule Trigger.

Exemplo 1: Resposta automática para perguntas frequentes

Adicione um nó IF após o Set:

IF {{ $json.mensagem.includes("horario") || $json.mensagem.includes("funcionamento") }}
No "true", adicione um nó HTTP Request com:

{ "number": "{{ $json.remetente }}", "text": "Atendemos de segunda a sexta, das 9h às 18h. Nos sábados, das 9h às 14h." }
Resultado esperado: Qualquer mensagem com "horario" ou "funcionamento" recebe a resposta automática em segundos.

Exemplo 2: Encaminhamento para setor correto com Switch

Adicione um nó Switch após o Set:

Switch {{ $json.mensagem.toLowerCase() }}

Configure as condições:

Condição	Fluxo
Contém "orcamento"	Enviar para setor de vendas
Contém "suporte" ou "ajuda"	Enviar para suporte técnico
Contém "cancelar"	Chamar nó de cancelamento
Default	Enviar para atendimento geral

Resultado esperado: Mensagens são direcionadas para o setor correto automaticamente, sem intervenção humana.

Exemplo 3: Disparo de mensagens em lote para pós-venda

Use um nó Schedule Trigger para agendar disparos (ex: 2 dias após compra):
Adicione um nó Read Binary File para ler uma lista de clientes em CSV:

{ "fileName": "/caminho/para/clientes.csv", "options": { "header": true } }
Itere com nó Loop Over Items e envie mensagem com HTTP Request:

{ "number": "{{ $item["telefone"] }}", "text": "Olá {{ $item["nome"] }}! Como foi sua experiência com nosso produto? Avalie em 5 minutos e ganhe 10% de desconto na próxima compra!" }
Resultado esperado: 100 clientes recebem a mensagem no mesmo horário, com personalização de nome e telefone.

Tabela: Tipos de automação e nós recomendados

Tipo de automação	Nós do n8n	Exemplo de uso
Saudação	Webhook + Set	Responder "Olá!" para primeira mensagem
Resposta automática	IF + HTTP Request	Responder "Em estoque" para "tem produto X?"
Pós-venda	Schedule Trigger + Loop	Enviar pesquisa de satisfação 3 dias após compra
Lembrete	Delay + HTTP Request	Lembrar de pagar fatura 1 dia antes do vencimento
Encaminhamento	Switch + HTTP Request	Direcionar pedido para setor financeiro

Evite banimentos: melhores práticas para usar Evolution API com segurança

O WhatsApp bloqueia números que enviam spam, usam mensagens em massa sem consentimento ou não respeitam intervalos entre mensagens. Para evitar isso, limite a 30 mensagens por número por hora, use captcha na primeira autenticação e nunca envie mensagens não solicitadas.

Monitore logs da Evolution API diariamente e configure alertas no n8n para pausar automações caso detecte atividade suspeita (ex: muitas mensagens em pouco tempo).

Regras oficiais do WhatsApp Business que você deve seguir

Consentimento: Só envie mensagem para quem iniciou o contato ou deu permissão explícita.
Intervalo: Aguarde pelo menos 24 horas para enviar nova mensagem após a última interação.
Conteúdo: Evite linguagem promocional excessiva ou links suspeitos.
Número verificado: Use número Business verificado (CNPJ ou CPF) para reduzir bloqueios.

Políticas oficiais do WhatsApp Business API

Dicas de segurança para Evolution API

Ative o captcha na Evolution API editando o .env:

AUTHENTICATION_API_KEY=SUA_CHAVE_API CAPTCHA_ENABLED=true
Limite requisições por IP no firewall (ex: UFW):

sudo ufw limit 3000/tcp
Monitore logs da Evolution API com:

tail -f /var/log/evolution-api.log

Caso real de bloqueio (e como evitar)

Um cliente usou a Evolution API para enviar 500 mensagens em 1 hora para uma lista comprada. O número foi banido em 2 dias. Solução: reduziu para 20 mensagens/hora, usou lista de opt-in e adicionou "Responda STOP para cancelar" nas mensagens. O número voltou a funcionar após 7 dias.

Escalando sua automação: n8n self-hosted vs nuvem e templates prontos

Self-hosted (VPS) é ideal para quem quer controle total e baixo custo (< R$ 50/mês), enquanto nuvem (n8n.io) oferece praticidade e escalabilidade automática (R$ 20–R$ 500/mês). Templates prontos aceleram a implementação e incluem fluxos para e-commerce, prestadores de serviços e imobiliárias.

Para e-commerce, use o template WhatsApp Order Bot (GitHub n8n) que automatiza confirmação de pedidos, envio de tracking e pós-venda. Para prestadores de serviços, o template Agendamento WhatsApp já inclui lembrete de consultas e confirmação de presença.

Comparação: self-hosted vs nuvem no n8n

Critério	Self-hosted (VPS)	Nuvem (n8n.io)
Custo mensal	R$ 30–R$ 80 (VPS)	R$ 20–R$ 500
Escalabilidade	Manual (upgrades de VPS)	Automática (planos pagos)
Backup	Você gerencia (rsync, cron)	Automático (n8n.io)
Performance	Depende da VPS (evite 1GB RAM)	Estável e otimizado
Templates prontos	Baixar do GitHub	Disponível no painel
Segurança	Você configura (firewall, SSL)	Segurança gerenciada

Como escolher?

Self-hosted: Escolha se você tem conhecimento técnico, precisa de personalização extrema ou tem orçamento limitado. Ideal para negócios com mais de 200 mensagens/dia.
Nuvem: Escolha se prefere praticidade, não quer gerenciar servidores ou tem menos de 50 mensagens/dia. Os primeiros 14 dias são gratuitos.

Templates prontos para baixar

Baixe templates específicos para WhatsApp Business no GitHub do n8n ou na comunidade brasileira:

Para instalar um template no n8n self-hosted:

Baixe o arquivo .json do template.
No n8n, clique em Import > From File.
Edite as variáveis de ambiente (ex: JWT_SECRET, número WhatsApp) no arquivo .env do n8n.
Ative o fluxo e teste com uma mensagem de exemplo.

Curiosidade de quem escala

Empresas que usam n8n self-hosted com VPS de 2 vCPU/4GB RAM conseguem processar até 1.000 mensagens/hora sem queda de performance. O segredo é usar filas com Redis (opcional na Evolution API) e limitar requisições simultâneas no n8n com o nó Wait.

Erros comuns e como resolvê-los: troubleshooting na prática

Problemas frequentes incluem webhooks que não chegam, mensagens não enviadas, autenticação falhando ou bloqueios por rate limit. Nesta seção, você encontra soluções passo a passo com comandos, logs e ajustes de configuração.

O erro mais comum é o 401 Unauthorized na Evolution API — geralmente causado por JWT_SECRET inválido ou número não autenticado. Sempre verifique o terminal da Evolution API após iniciar para confirmar se o número está como "connected".

Erro 1: Webhook não chega no n8n

Causa provável	Solução
Webhook não registrado na Evolution API	Execute novamente o comando de registro com a URL correta do n8n.
Firewall bloqueando a porta 3000	Verifique com `sudo ufw status` e abra a porta: `sudo ufw allow 3000`.
Número não autenticado na Evolution API	Confira o terminal da Evolution API — se não estiver "connected", escaneie o QR Code novamente.
URL do webhook com erro (ex: http em vez de https)	Use HTTPS sempre. Configure um domínio (ex: whatsapp.seudominio.com) com certificado SSL gratuito via Let's Encrypt.

Erro 2: Mensagens não enviadas (400 Bad Request)

Causa provável	Solução
Número no formato errado (ex: 5511999999999 em vez de 5511999999999@c.us)	Sempre use o formato com `@c.us` no final.
Número bloqueado pelo WhatsApp	Verifique logs da Evolution API: `tail -f evolution-api.log`. Se bloqueado, troque de número.
Mensagem muito longa (> 4096 caracteres)	Divida em múltiplas mensagens ou use mídia (imagens, PDFs) para longos textos.
Intervalo entre mensagens menor que 24h para mesmo contato	Aguarde 24h ou use a permissão "business hours" na Evolution API.

Erro 3: Autenticação falhando (401 Unauthorized)

Verifique se o JWT_SECRET no .env da Evolution API está correto no nó HTTP Request:

Authorization: Bearer JWT_SECRET_DO_ENV
Confira se o número está conectado na Evolution API:

curl -X GET "http://localhost:3000/instance/list" \ -H "Authorization: Bearer JWT_SECRET_DO_ENV"
Se o número não estiver conectado, escaneie o QR Code novamente e aguarde 10 segundos.

Erro 4: Rate limit ou bloqueio por spam

Sintoma	Solução imediata
Mensagens não chegam depois de 1 hora enviando	Pare todas as automações por 24h e tente novamente com intervalos maiores.
Número banido (aparece "blocked" na Evolution API)	Troque de número, use um número novo dedicado para automação e configure captcha.
Logs mostram "Too Many Requests"	Adicione um nó Wait no n8n para pausar 1 segundo entre cada HTTP Request.

Como debugar logs da Evolution API

Para visualizar logs em tempo real:

  journalctl -u evolution-api -f --no-pager

Logs importantes para verificar:

Authentication successful → Número conectado.
Message sent to [número] → Mensagem enviada com sucesso.
Error: Too Many Requests → Reduza a velocidade de disparos.
Error: Instance not found → Número não autenticado.

Checklist rápido antes de pedir ajuda

O número está conectado na Evolution API? (verifique com curl localhost:3000/instance/list)
O JWT_SECRET está correto em todos os nós HTTP Request?
O webhook está registrado com a URL correta e HTTPS?
O firewall está aberto para a porta 3000?
As mensagens estão no formato correto (ex: 5511999999999@c.us)?

Recurso extra: Comunidade brasileira

Se o erro persistir, poste no GitHub da Evolution API ou no grupo de automação com n8n no Telegram. Inclua logs, versão da Evolution API e print do erro.

Perguntas frequentes sobre como automatizar o WhatsApp Business com n8n e Evolution API

Preciso saber programar para usar n8n com WhatsApp Business?

Não! O n8n é uma ferramenta low-code, então você configura fluxos com nós visuais (arrastar e soltar) e conecta APIs como a Evolution API sem escrever código. Apenas para ajustes avançados (como logs personalizados) pode ser útil ter noções básicas de JavaScript ou JSON.

A Evolution API é gratuita ou tem custos?

A Evolution API é 100% open source e gratuita para uso básico. Os únicos custos são do servidor (VPS ou nuvem) onde você a instala e do plano do n8n (gratuito para self-hosted ou R$20/mês na nuvem). Não há taxas por mensagem ou limite de uso além das regras do WhatsApp.

Como evitar que meu número seja banido pelo WhatsApp ao usar automação?

Use um número Business verificado, ative o captcha na Evolution API, limite a 30 mensagens/hora por número e sempre peça consentimento antes de enviar mensagens. Evite disparos em massa para listas frias e respeite o intervalo de 24h entre interações com o mesmo contato.

Posso usar n8n na nuvem ou preciso de um servidor próprio?

Você pode usar ambos! O n8n na nuvem (n8n.io) é mais prático para iniciantes (plano gratuito por 14 dias), enquanto o self-hosted (VPS) oferece controle total e custo menor (R$30–R$80/mês). A escolha depende da sua necessidade de personalização e orçamento.

Qual a diferença entre usar webhook e polling no n8n?

Webhook é mais eficiente: a Evolution API envia eventos em tempo real para o n8n, sem gastar recursos com requisições constantes. Polling (verificar manualmente a API) consome mais CPU e pode atrasar respostas. Sempre prefira webhook para automações críticas.

Como testar se meu webhook está funcionando antes de colocar em produção?

Use ferramentas como webhook.site para simular eventos do WhatsApp e verificar se o n8n recebe os dados corretamente. Também teste com o nó Webhook do n8n em modo de desenvolvimento antes de ativar em produção.

Quais são os principais erros comuns ao configurar a Evolution API no n8n?

Os erros mais frequentes são: JWT_SECRET incorreto, número não autenticado (sem QR Code escaneado), firewall bloqueando a porta 3000 e URLs de webhook sem HTTPS. Sempre verifique os logs da Evolution API e do n8n para diagnosticar rapidamente.

Posso usar múltiplos números de WhatsApp na mesma automação?

Sim! A Evolution API permite gerenciar várias instâncias de números no mesmo servidor. No n8n, você configura nós HTTP Request separados para cada número ou usa um loop para iterar entre eles. Cada número precisa de autenticação individual via QR Code.

Automação no WhatsApp: o futuro do atendimento sem limites

Automatizar o WhatsApp Business com n8n e Evolution API não é apenas sobre economizar tempo — é sobre transformar seu atendimento em uma máquina de vendas escalável, disponível 24/7 e capaz de atender centenas de clientes sem perder qualidade. Com esse guia, você aprendeu desde a instalação técnica até fluxos avançados como respostas automáticas, encaminhamento por setor e disparos em lote, tudo sem depender de desenvolvedores ou ferramentas caras.

O segredo para o sucesso está em começar pequeno: configure um fluxo básico de resposta automática, teste com amigos e só então escale para automações complexas. Monitore sempre os logs e respeite as regras do WhatsApp para evitar bloqueios — assim, seu número durará anos sem problemas.

Resumo rápido para colocar em prática hoje:

Instale a Evolution API em um VPS de R$40/mês e autentique seu número via QR Code.
Configure um webhook no n8n para receber mensagens em tempo real e responda automaticamente com nós HTTP Request.
Use filtros (IF/Switch) para direcionar mensagens por palavras-chave e crie fluxos para pós-venda ou agendamentos.
Monitore logs diariamente e limite a 30 mensagens/hora por número para evitar bloqueios.
Escolha entre self-hosted (controle total) ou nuvem (praticidade) com base no seu orçamento e necessidade.

Pronto para dar o primeiro passo? Explore nossa categoria de automação no WhatsApp para templates prontos e tutoriais avançados. E se tiver dúvidas, nossa comunidade no Telegram está sempre pronta para ajudar!

Quer mais sobre o assunto? Veja todos os artigos de n8n ou a lista completa de artigos.