n8n com WhatsApp: como automatizar o atendimento com a Evolution API

Comente! ,

Tempo de leitura: 5 minutos

Juntar o n8n com WhatsApp é uma das automações que mais economiza tempo de uma empresa: mensagem chega, o fluxo lê o que o cliente escreveu, consulta um sistema e responde sozinho, sem ninguém precisar ficar com o celular na mão. Neste guia você vai entender como essa ligação funciona usando a Evolution API, uma das pontes mais usadas entre o WhatsApp e ferramentas de automação. E se quiser pular a parte de instalação, o Cloud VPS n8n da Rubfy já entrega o n8n pré-instalado, com HTTPS configurado e servidor no Brasil.

Como funciona o n8n com WhatsApp

O n8n não conversa diretamente com o WhatsApp. Ele precisa de um intermediário que mantenha o número conectado e transforme cada mensagem em uma chamada HTTP. É esse o papel da Evolution API: ela conecta o número (lendo um QR Code, como no WhatsApp Web) e expõe uma API REST simples para enviar e receber mensagens.

O caminho de uma conversa fica assim:

  1. o cliente manda uma mensagem para o seu número;
  2. a Evolution API recebe e dispara um webhook para uma URL do n8n;
  3. o fluxo do n8n lê o texto, decide o que fazer (consultar planilha, CRM, IA, banco de dados);
  4. o n8n chama a Evolution API de volta pedindo o envio da resposta.

Se o conceito de fluxo ainda é novo para você, vale ler antes o nosso guia de introdução ao n8n.

O que você precisa antes de começar

  • Uma VPS rodando o n8n e a Evolution API. As duas rodam bem em containers Docker (veja como instalar o Docker na VPS).
  • Um domínio ou subdomínio com HTTPS apontando para o n8n, porque a Evolution vai chamar essa URL.
  • Um número de WhatsApp dedicado para a automação. Evite usar o seu número pessoal.

Sobre recursos: para começar, 2 GB de RAM atendem bem o n8n e a Evolution juntos em volume baixo. O nosso artigo sobre requisitos de VPS para bot de WhatsApp detalha quando vale subir de plano.

Passo 1: conectar o número na Evolution API

Com a Evolution rodando, você cria uma instância (cada instância é um número conectado) e gera o QR Code. No celular, abra o WhatsApp, vá em Aparelhos conectados e leia o código. A partir daí, a instância fica com status open, e você já consegue enviar mensagens pela API.

Um teste rápido de envio ajuda a confirmar que está tudo certo antes de montar o fluxo. Monte esta requisição no Postman, no Insomnia ou no próprio nó HTTP Request do n8n:

POST /message/sendText/minha-instancia
Host: evolution.seudominio.com.br
apikey: SUA_CHAVE
Content-Type: application/json

{"number": "5511999999999", "text": "Teste do n8n"}

Passo 2: criar o webhook no n8n

No n8n, crie um fluxo novo e adicione o nó Webhook com o método POST. Ele gera duas URLs: a de teste, que só funciona enquanto você clica em Listen for test event, e a de produção, que funciona com o fluxo ativado. Copie a URL de produção.

Na Evolution, configure o webhook da instância apontando para essa URL e marque o evento MESSAGES_UPSERT, que é disparado a cada mensagem nova. Mande uma mensagem de teste para o número e veja o JSON chegando no n8n: o texto fica em data.message.conversation e o número de quem mandou em data.key.remoteJid.

Passo 3: responder automaticamente pelo n8n com WhatsApp

Depois do webhook, o desenho mais comum é:

  • Nó IF ou Switch: separa o que é mensagem de cliente do que é mensagem enviada pelo próprio número (o campo data.key.fromMe vem como true quando fomos nós que enviamos). Sem esse filtro o fluxo responde a si mesmo e entra em loop.
  • Nó de lógica: pode ser uma busca em planilha, uma consulta ao seu sistema ou um agente de IA. O artigo sobre agente de IA no n8n mostra como montar respostas inteligentes.
  • Nó HTTP Request: faz o POST para /message/sendText/{instancia} com o header apikey e o corpo com número e texto.

Cuidados para não ter o número bloqueado

A Evolution API usa o mesmo protocolo do WhatsApp Web, ou seja, não é a API oficial da Meta. Funciona muito bem para atendimento, mas o WhatsApp monitora comportamento de spam. Na prática, o que mais derruba números é:

  • disparar mensagens em massa para contatos que nunca falaram com você;
  • enviar muitas mensagens em sequência, sem intervalo;
  • números novos já começando com volume alto.

Use a automação principalmente para responder quem chamou, espace os envios ativos (dezenas de segundos entre um e outro) e aqueça números novos aos poucos. Se o seu caso é disparo em grande escala com template aprovado, o caminho certo é a API oficial do WhatsApp Cloud, que tem regras e custos próprios.

Onde hospedar o n8n com WhatsApp

Os dois serviços precisam ficar no ar 24 horas: se a VPS cai, o webhook se perde e o cliente fica sem resposta. Por isso, evite rodar isso no seu computador ou em hospedagem compartilhada. Uma VPS com IP fixo, disco rápido e datacenter no Brasil reduz a latência entre a mensagem chegar e a resposta sair.

Comece a automatizar o seu WhatsApp com a Rubfy

O Cloud VPS n8n já vem com o n8n pré-instalado em Docker, Nginx e HTTPS configurados, Ubuntu 22.04 LTS, acesso root, workflows e execuções ilimitados, IP dedicado e datacenter no Brasil, a partir de R$ 69 por mês. Você sobe a Evolution API no mesmo servidor e começa a montar o fluxo no mesmo dia, com suporte humano pelo WhatsApp se travar em alguma etapa.

Artigos relacionados