Evolution API no n8n: automatizando WhatsApp fora do canal oficial

Evolution API é um projeto não-oficial que conecta o WhatsApp comum — o mesmo do seu celular — a automações como o n8n, usando engenharia reversa do protocolo do WhatsApp Web. É a forma mais popular de automatizar WhatsApp fora do canal oficial da Meta, e também a mais arriscada.

Como funciona

A Evolution API roda como um serviço próprio — normalmente num container Docker, na mesma VPS onde já está o n8n —, conectada a um número de WhatsApp real via QR code, do mesmo jeito que você conecta o WhatsApp Web no navegador. A partir daí, ela expõe uma API que o n8n consome para enviar e receber mensagens.

Instalação com Docker

version: "3.7"
services:
  evolution-api:
    image: atendai/evolution-api:latest
    restart: always
    ports:
      - "127.0.0.1:8080:8080"
    environment:
      - AUTHENTICATION_API_KEY=sua_chave_secreta
    volumes:
      - evolution_data:/evolution/instances

volumes:
  evolution_data:

Depois de subir o container, você cria uma "instância" pela API, escaneia o QR code gerado com o WhatsApp do celular, e a instância fica conectada — pronta para receber webhooks de mensagens novas e enviar respostas.

Conectando ao n8n

1. No n8n, use um node Webhook para receber as mensagens que a Evolution API encaminha automaticamente a cada mensagem nova.

2. Para enviar respostas, use um node HTTP Request apontando para o endpoint de envio da Evolution API, com o número de destino e o texto da mensagem.

3. Trate o payload recebido — a Evolution API manda o texto, o remetente e metadados da conversa, que você usa para decidir a resposta no fluxo.

O risco real: banimento

A Evolution API não é reconhecida pela Meta — ela simula o comportamento de um app de WhatsApp comum. Números usados para automação em volume, principalmente disparando muitas mensagens ou mensagens para quem nunca iniciou a conversa, correm risco real de banimento pelo próprio sistema antifraude do WhatsApp. Não é uma possibilidade remota: é um risco conhecido e recorrente entre quem usa essa via.

Reduza o risco: use um número dedicado só para automação (nunca o pessoal), mantenha o volume de disparo baixo e espaçado, e evite mandar mensagem para quem nunca conversou com o número antes — esse último ponto é o gatilho mais comum de bloqueio.

A Evolution API é gratuita, flexível e não exige aprovação da Meta — mas o preço é o risco de banimento. Para quem depende do WhatsApp para o negócio funcionar, vale conhecer a alternativa oficial antes de decidir.

Perguntas frequentes