# N8N e Evolution API: Automação WhatsApp Robusta em Seu VPS

Publicado em: 2026-08-27T00:06:20.398000

## Resposta rápida

A integração N8N e Evolution API permite automatizar o WhatsApp de forma robusta e self-hosted, criando chatbots e fluxos de comunicação personalizados. Para implantar, é necessário um VPS Linux com no mínimo 4GB de RAM e 2 vCPUs para um ambiente de produção estável, utilizando Docker Compose para facilitar a instalação e gerenciamento.

Vai colocar Evolution API e WhatsApp em produção?
Se você quer uma recomendação objetiva, veja a estrutura indicada para este cenário e compare os planos antes de contratar.
Escolher minha configuração →
Tirar uma dúvida técnica
Introdução: N8N e Evolution API para Automação WhatsApp
A integração do N8N com a Evolution API em um servidor VPS é a solução ideal para quem busca automatizar o WhatsApp de forma robusta e self-hosted. Este combo permite criar fluxos de trabalho complexos, desde o envio de mensagens automáticas até a construção de chatbots interativos, com total controle sobre seus dados e infraestrutura. Para rodar essa solução de forma eficiente em produção, recomendamos um VPS com no mínimo
4GB de RAM e 2 vCPUs
, garantindo estabilidade e desempenho, especialmente para volumes de mensagens consistentes. Este guia detalha o processo de implantação, desde a preparação do ambiente até a configuração inicial da integração, usando Docker Compose para simplificar a gestão.
Por Que Combinar N8N e Evolution API no Seu VPS?
A combinação de N8N e Evolution API oferece uma poderosa plataforma para automação do WhatsApp, trazendo flexibilidade e controle. O N8N, uma ferramenta de automação no-code/low-code, se destaca pela sua capacidade de integrar centenas de serviços. Já a Evolution API fornece uma interface robusta para gerenciar e automatizar as interações no WhatsApp, sendo ideal para criar um chatbot WhatsApp com N8N. Juntos, eles permitem desde respostas automáticas simples até fluxos de atendimento complexos, tudo hospedado em seu próprio servidor.
Controle Total e Segurança dos Dados
Ao rodar a n8n Evolution API integração no seu VPS, você mantém o controle total sobre seus dados e a infraestrutura. Isso é crucial para empresas que lidam com informações sensíveis ou que possuem requisitos de conformidade rigorosos. Diferente de soluções SaaS, onde seus dados ficam em servidores de terceiros, com o self-hosting, você gerencia o ambiente, garantindo maior segurança e privacidade. Isso também oferece flexibilidade para personalizar configurações de rede e segurança conforme suas necessidades específicas.
Escalabilidade e Desempenho Otimizado
A hospedagem em um VPS dedicado oferece a capacidade de escalar recursos conforme a demanda, crucial para a automatizar WhatsApp com N8N. Você pode ajustar a RAM, CPU e armazenamento para lidar com picos de tráfego ou um número crescente de automações e usuários. Em nossa experiência, muitos clientes subestimam a demanda inicial, o que pode levar a gargalos. Um ambiente bem dimensionado, como uma VPS com 4GB de RAM, proporciona a estabilidade necessária para a automação fluir sem interrupções, mesmo com múltiplos fluxos ativos e um volume considerável de mensagens.
Requisitos Mínimos para Implantação Robusta
Para garantir que sua solução de automação N8N e Evolution API funcione sem problemas, é fundamental atender aos requisitos mínimos de hardware e software. Estes requisitos são pensados para um ambiente de produção que precisa de estabilidade e capacidade de resposta.
Hardware e Sistema Operacional Recomendados
Para rodar o N8N e a Evolution API com Docker Compose em um VPS, você precisará de:
Sistema Operacional:
Ubuntu Server 22.04 LTS (ou superior).
Processador (CPU):
Mínimo de 2 vCPUs. Para cargas de trabalho mais pesadas ou muitos fluxos simultâneos, 4 vCPUs são recomendáveis.
Memória RAM:
Mínimo de 4GB. Isso permite que o N8N, a Evolution API, o banco de dados (se for PostgreSQL ou outro) e o sistema operacional coexistam sem sofrer com Out-Of-Memory (OOM) errors. Para ambientes com alto volume de automação WhatsApp com N8N ou múltiplos Webhooks, 8GB de RAM oferecem uma margem de segurança maior.
Armazenamento:
40GB de SSD NVMe. O SSD é crucial para o desempenho do banco de dados e para o carregamento rápido das interfaces.
Na minha experiência, clientes que tentam economizar em RAM acabam gastando mais tempo solucionando problemas de performance do que o valor economizado na hospedagem. Um plano de 4GB de RAM é o piso para uma experiência estável.
Softwares Essenciais
Você precisará ter os seguintes softwares instalados no seu VPS:
Docker:
A plataforma de contêineres que executará o N8N e a Evolution API.
Docker Compose:
Ferramenta para definir e executar aplicações Docker multi-contêineres. Essencial para simplificar a gestão da stack.
Nginx (opcional, mas recomendado):
Como proxy reverso para gerenciar certificados SSL e roteamento de tráfego.
Passo a Passo: Instalação do N8N e Evolution API no VPS
Este tutorial guiará você pela instalação completa do N8N e da Evolution API utilizando Docker Compose em um servidor Ubuntu. Certifique-se de que seu VPS está atualizado e que você tem acesso SSH como usuário com privilégios sudo.
1. Preparação do Ambiente e Instalação do Docker
Primeiro, conecte-se ao seu VPS via SSH e atualize os pacotes do sistema. Em seguida, instale o Docker e o Docker Compose. Lembre-se, o
docker compose
(com espaço) é a versão recomendada.
sudo apt update && sudo apt upgrade -y

sudo apt install apt-transport-https ca-certificates curl software-properties-common -y
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin -y
sudo usermod -aG docker $USER
newgrp docker
Após a instalação, verifique se o Docker está funcionando corretamente com
docker run hello-world
. A inclusão do seu usuário no grupo
docker
permite executar comandos Docker sem
sudo
. Para mais detalhes sobre a configuração inicial do Docker, consulte nosso artigo sobre
Docker em VPS: Seu Deploy Autônomo em Servidor
.
2. Configuração do Docker Compose
Crie um diretório para seus projetos e, dentro dele, um arquivo
docker-compose.yml
e um arquivo
.env
. O arquivo
.env
armazenará variáveis de ambiente sensíveis, como suas credenciais da Evolution API.
Crie o diretório do projeto e os arquivos:
mkdir n8n-evolution && cd n8n-evolution
touch docker-compose.yml .env
Edite o arquivo
.env
(substitua os valores de exemplo):
# N8N
N8N_HOST=sua-url.com.br
GENERIC_TIMEZONE=America/Sao_Paulo
N8N_BASIC_AUTH_ACTIVE=true
N8N_BASIC_AUTH_USER=seu_usuario_n8n
N8N_BASIC_AUTH_PASSWORD=sua_senha_n8n
N8N_EDITOR_BASE_URL=https://sua-url.com.br/
N8N_PROTOCOL=https
N8N_PORT=5678

# PostgreSQL para N8N
POSTGRES_DB=n8n_db
POSTGRES_USER=n8n_user
POSTGRES_PASSWORD=sua_senha_postgres

# Evolution API
EVOLUTION_API_PORT=8080
EVOLUTION_API_TOKEN=seu_token_evolution_api_aqui
Edite o arquivo
docker-compose.yml
:
version: '3.8'

services:
  n8n:
    image: n8n.io/n8n
    restart: always
    ports:
      - "5678:5678"
    environment:
      - N8N_HOST=${N8N_HOST}
      - GENERIC_TIMEZONE=${GENERIC_TIMEZONE}
      - N8N_BASIC_AUTH_ACTIVE=${N8N_BASIC_AUTH_ACTIVE}
      - N8N_BASIC_AUTH_USER=${N8N_BASIC_AUTH_USER}
      - N8N_BASIC_AUTH_PASSWORD=${N8N_BASIC_AUTH_PASSWORD}
      - N8N_EDITOR_BASE_URL=${N8N_EDITOR_BASE_URL}
      - N8N_PROTOCOL=${N8N_PROTOCOL}
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=n8n_postgres
      - DB_POSTGRESDB_DATABASE=${POSTGRES_DB}
      - DB_POSTGRESDB_USER=${POSTGRES_USER}
      - DB_POSTGRESDB_PASSWORD=${POSTGRES_PASSWORD}
    volumes:
      - n8n_data:/home/node/.n8n
    depends_on:
      - n8n_postgres

  n8n_postgres:
    image: postgres:15
    restart: always
    environment:
      - POSTGRES_DB=${POSTGRES_DB}
      - POSTGRES_USER=${POSTGRES_USER}
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
    volumes:
      - postgres_data:/var/lib/postgresql/data

  evolution_api:
    image: evolutionapi/evolution-api:latest
    restart: always
    ports:
      - "${EVOLUTION_API_PORT}:8080"
    environment:
      - TOKEN=${EVOLUTION_API_TOKEN}
      - PORT=8080
      - DATABASE_URL=mongodb://evolution_mongo:27017/evolution
    volumes:
      - evolution_data:/app/data
    depends_on:
      - evolution_mongo

  evolution_mongo:
    image: mongo:latest
    restart: always
    volumes:
      - mongo_data:/data/db

volumes:
  n8n_data:
  postgres_data:
  evolution_data:
  mongo_data:
Este arquivo define quatro serviços:
n8n
(a ferramenta de automação),
n8n_postgres
(o banco de dados para o N8N),
evolution_api
(a API do WhatsApp) e
evolution_mongo
(o banco de dados para a Evolution API). Observe as variáveis de ambiente que pegam seus valores do arquivo
.env
.
3. Inicialização dos Serviços
Após configurar os arquivos
.env
e
docker-compose.yml
, você pode iniciar todos os serviços com um único comando:
docker compose up -d
O
-d
faz com que os contêineres rodem em segundo plano. Levará alguns minutos para as imagens serem baixadas e os serviços iniciarem. Você pode verificar o status dos contêineres com
docker compose ps
. Para gerenciar a Evolution API, você pode consultar nosso guia completo sobre
Evolution API: Instale e Gerencie em seu VPS
.
Configuração de Proxy Reverso com Nginx (Recomendado)
Para acesso seguro via HTTPS e para gerenciar subdomínios, a configuração de um proxy reverso com Nginx é altamente recomendada. Isso permite que você acesse o N8N e a Evolution API via nomes de domínio amigáveis (ex:
n8n.seusite.com.br
e
api.seusite.com.br
) e utilize certificados SSL gratuitos do Let's Encrypt.
Instalação do Nginx e Certbot
Instale o Nginx e o Certbot (para certificados SSL) no seu VPS:
sudo apt install nginx certbot python3-certbot-nginx -y
Configuração do Nginx
Crie um arquivo de configuração para cada serviço (N8N e Evolution API) em
/etc/nginx/sites-available/
. Por exemplo, para o N8N:
server {
    listen 80;
    server_name n8n.seusite.com.br;

    location / {
        proxy_pass http://localhost:5678;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}
Crie um arquivo similar para a Evolution API, apontando para a porta
8080
(ou a porta que você definiu para a Evolution API). Habilite as configurações e reinicie o Nginx:
sudo ln -s /etc/nginx/sites-available/n8n.conf /etc/nginx/sites-enabled/
sudo systemctl restart nginx
Obtenção de Certificados SSL com Certbot
Execute o Certbot para obter certificados SSL gratuitos:
sudo certbot --nginx -d n8n.seusite.com.br -d api.seusite.com.br
Siga as instruções. O Certbot irá configurar o Nginx automaticamente para usar HTTPS. Agora você pode acessar seu N8N e Evolution API de forma segura via seu navegador.
Erros Comuns e Como Evitá-los
A implantação de soluções complexas como N8N e Evolution API pode apresentar alguns desafios. Conhecer os erros comuns ajuda a evitá-los ou a solucioná-los rapidamente.
Problemas de Conectividade e Porta
Um erro frequente é a falha de comunicação entre os contêineres ou o acesso externo. Verifique as portas no
docker-compose.yml
e se não há firewalls bloqueando o acesso (ex: UFW no Ubuntu ou firewall da sua provedora de VPS). Certifique-se de que a Evolution API esteja configurada para a porta correta e que o N8N consiga alcançá-la. Na minha experiência, muitas vezes a Evolution API demora um pouco mais para inicializar, e o N8N pode tentar conectar antes que ela esteja pronta, causando erros temporários.
Configuração Incorreta de Variáveis de Ambiente
Variáveis de ambiente mal configuradas no arquivo
.env
podem causar diversos problemas, desde falhas de autenticação até o N8N não conseguir conectar ao banco de dados. Revise cuidadosamente os valores, prestando atenção especial a senhas, URLs e tokens. Lembre-se que qualquer alteração no
.env
ou
docker-compose.yml
exige que você reinicie os serviços com
docker compose down
e
docker compose up -d
para que as mudanças sejam aplicadas.
Uso Inadequado de Recursos do Servidor
Um VPS subdimensionado é uma fonte comum de problemas de performance. Se sua automação WhatsApp com N8N ou a própria Evolution API apresentar lentidão, travamentos ou contêineres reiniciando inesperadamente, o problema pode ser a falta de RAM ou CPU. Monitore o uso de recursos do seu VPS (com comandos como
htop
ou
docker stats
). Como mencionado, 4GB de RAM é o mínimo para produção; se você notar que a memória está constantemente em uso máximo, considere um upgrade. A
escolha de uma VPS com requisitos mínimos
adequados é crucial.
Comparativo: N8N + Evolution API vs. Outras Soluções de Automação
Entender as diferenças entre as opções disponíveis é fundamental para escolher a melhor solução para sua necessidade de automatizar WhatsApp com N8N. Abaixo, uma comparação de alguns aspectos:
Recurso
N8N + Evolution API (Self-Hosted)
SaaS de Automação (Ex: ManyChat)
Soluções Customizadas (Via API Oficial do WhatsApp)
Controle dos Dados
Completo (no seu VPS)
Parcial (em servidores de terceiros)
Completo (no seu servidor)
Custo Inicial
Médio (VPS + tempo de configuração)
Baixo (assinatura mensal)
Alto (desenvolvimento + infra)
Custo Mensal
Baixo (apenas VPS)
Variável (por volume/recursos)
Variável (infra + manutenção)
Flexibilidade de Automação
Alta (fluxos complexos, integrações customizadas)
Média (limitado aos recursos da plataforma)
Muito Alta (totalmente customizável)
Dificuldade de Configuração
Média (requer conhecimento técnico)
Baixa (interface gráfica)
Alta (requer desenvolvedor)
Escalabilidade
Alta (controlada pelo VPS)
Depende do plano SaaS
Alta (controlada pelo desenvolvedor)
Perguntas Relacionadas
Como o N8N se integra com a Evolution API?
O N8N se integra com a Evolution API usando o nó HTTP Request. Você configura o URL da sua Evolution API (ex:
http://localhost:8080/message/sendText
se estiver no mesmo servidor ou
https://api.seusite.com.br/message/sendText
com proxy reverso), adiciona o token de autenticação no cabeçalho e envia os dados no corpo da requisição JSON, como número de telefone e texto da mensagem.
É possível criar chatbots WhatsApp complexos com essa integração?
Sim, é totalmente possível criar chatbots WhatsApp complexos. O N8N permite criar lógicas condicionais, armazenar dados em bancos de dados ou planilhas, integrar-se a CRMs, e até usar modelos de IA para processamento de linguagem natural, tudo isso orquestrando as respostas via Evolution API para o WhatsApp. A flexibilidade do N8N é o ponto chave aqui, tornando-o ideal para quem busca uma solução robusta para chatbot WhatsApp com N8N.
Qual a diferença entre a Evolution API e a API Oficial do WhatsApp Business?
A Evolution API é uma solução de API não oficial, geralmente mais flexível e com menor custo, mas com riscos de bloqueio se não usada com cautela. A API Oficial do WhatsApp Business é a solução oferecida pelo próprio WhatsApp, com garantia de estabilidade e suporte, mas requer um processo de aprovação e tem custos mais elevados por conversa. A Evolution API é popular para testes, MVPs e pequenos negócios que precisam de agilidade e controle sem os custos e burocracias da API oficial.
Posso migrar minhas automações de um SaaS para N8N + Evolution API?
Sim, a migração é possível, mas geralmente exige a recriação dos fluxos de trabalho no N8N. Embora não haja um botão de migração direta, a lógica dos seus fluxos pode ser replicada usando os
integrações no n8n
para interagir com a Evolution API e outros serviços que você já utiliza. É uma excelente oportunidade para otimizar e refinar suas automações, aproveitando a flexibilidade do N8N.
Conclusão: Sua Plataforma de Automação WhatsApp Robusta em Produção
Implementar a n8n Evolution API integração em um VPS oferece uma solução poderosa e flexível para automatizar WhatsApp com N8N, permitindo a criação de chatbots complexos e fluxos de comunicação eficientes. Com o controle total sobre sua infraestrutura e dados, você garante segurança, escalabilidade e desempenho otimizado. Seguindo este guia, você terá seu ambiente configurado e pronto para operar em produção.
Para garantir a performance e a estabilidade necessárias para essa solução, especialmente em ambientes de produção, recomendamos o uso do
VPS Brasil Básico
da Host You Secure. Com 4GB de RAM e 4 vCPUs, este plano oferece os recursos ideais para rodar o N8N e a Evolution API sem preocupações, com a robustez que suas automações exigem. Esse tutorial foi validado por nós em uma VPS Brasil Básico, assegurando que o plano é perfeitamente adequado para este tipo de carga de trabalho.
Adquira seu
VPS Brasil Básico por R$ 99/mês
e comece hoje mesmo a transformar sua comunicação via WhatsApp!

### O que é N8N e Evolution API?

O N8N é uma ferramenta de automação de fluxo de trabalho no-code/low-code que permite conectar diversas APIs e serviços para automatizar tarefas. A Evolution API é uma API de terceiros que facilita a integração de funcionalidades do WhatsApp em sistemas externos. Juntas, elas formam uma solução robusta para automatizar interações e construir chatbots no WhatsApp, tudo self-hosted em seu servidor.

### Quais são os benefícios de hospedar N8N e Evolution API em um VPS?

Hospedar N8N e Evolution API em um VPS oferece controle total sobre seus dados e infraestrutura, garantindo maior segurança e privacidade. Além disso, permite escalabilidade personalizada, ajustando os recursos (RAM, CPU) conforme a demanda do seu projeto. Você evita custos recorrentes de soluções SaaS e tem a flexibilidade de personalizar o ambiente como desejar, ideal para projetos que exigem um alto grau de customização e performance.

### Quais os requisitos mínimos de servidor para esta integração?

Para uma implantação robusta em produção, a integração N8N e Evolution API requer um VPS com no mínimo 4GB de RAM e 2 vCPUs. Recomenda-se 40GB de armazenamento SSD NVMe e um sistema operacional Ubuntu Server 22.04 LTS. Esses recursos garantem que os múltiplos serviços (N8N, PostgreSQL, Evolution API, MongoDB) rodem de forma estável e eficiente, mesmo sob carga moderada.

### É necessário ter conhecimentos técnicos para configurar esta solução?

Embora o N8N seja uma ferramenta no-code/low-code, a configuração inicial da integração com a Evolution API em um VPS requer conhecimentos básicos de linha de comando Linux, Docker e Docker Compose. Este guia oferece um passo a passo detalhado para facilitar o processo, mas familiaridade com esses conceitos ajudará na solução de problemas e na manutenção do ambiente. A Host You Secure oferece suporte para dúvidas de infraestrutura.

### Como posso garantir a segurança da minha automação WhatsApp self-hosted?

Para garantir a segurança, utilize senhas fortes para acesso ao N8N e ao banco de dados. Configure um proxy reverso (como Nginx) com certificados SSL (Let's Encrypt) para criptografar o tráfego HTTP. Mantenha seu sistema operacional e pacotes Docker atualizados. Além disso, restrinja o acesso às portas dos serviços apenas ao necessário e use um firewall para proteger seu VPS contra acessos não autorizados.

### Posso usar a Evolution API para enviar mensagens em massa no WhatsApp?

A Evolution API permite o envio programático de mensagens, mas o uso para envio em massa sem consentimento pode violar os termos de serviço do WhatsApp e levar ao bloqueio do número. É crucial utilizar a automação de forma ética e consentida, focando em comunicação relevante para o usuário. Recomenda-se sempre seguir as diretrizes do WhatsApp para evitar problemas.

### Qual a melhor forma de fazer backup da minha instalação N8N e Evolution API?

Para backup, você deve salvar os volumes persistentes configurados no Docker Compose. Isso inclui os dados do N8N (<code>n8n_data</code>), do PostgreSQL (<code>postgres_data</code>), da Evolution API (<code>evolution_data</code>) e do MongoDB (<code>mongo_data</code>). Você pode usar ferramentas como <code>docker compose down</code> para parar os serviços, copiar os diretórios dos volumes, e depois <code>docker compose up -d</code> para reiniciar. Backups regulares são essenciais para recuperação em caso de falhas.

### Como monitorar o desempenho da minha automação no VPS?

Monitore o desempenho do seu VPS usando ferramentas como <code>htop</code> para CPU e RAM, <code>docker stats</code> para consumo de recursos dos contêineres e logs dos serviços (<code>docker compose logs -f <service_name></code>) para identificar erros ou gargalos. Você pode configurar alertas para uso excessivo de recursos ou falhas nos serviços, garantindo que sua automação esteja sempre operando de forma otimizada.