Índice do artigo
n8n Evolution Combo: Seu Centro de Automação em um VPS
O n8n Evolution Combo oferece uma poderosa suíte de automação que você pode hospedar diretamente em seu servidor. Ao contrário de soluções SaaS, ter o n8n e a Evolution API rodando em um VPS dedicado garante controle total sobre seus dados, maior segurança e personalização. Este guia prático mostra como implantar essa stack em um servidor Linux, transformando seu VPS em um hub de automação robusto e confiável.
Veja a infraestrutura: VPS para n8n + Evolution API para colocar este projeto no ar.
Para uma operação fluida em produção, recomendamos um VPS com no mínimo 4GB de RAM e 2 vCPUs. Essa configuração é capaz de suportar o n8n, a Evolution API e outros serviços essenciais, como um banco de dados e um proxy reverso, com folga para picos de tráfego. Testamos cada comando deste artigo em uma VPS Brasil Básico (R$ 99/mês, 4GB RAM, 4 vCPUs), garantindo a viabilidade da instalação e operação.
Por que hospedar o n8n Evolution Combo em um VPS?
Hospedar o n8n e a Evolution API em um VPS particular traz vantagens significativas:
- Controle de Dados e Segurança: Seus fluxos de trabalho e dados sensíveis permanecem em seu ambiente, sob seu controle direto.
- Custo-Benefício: Especialmente para volumes médios a altos de automação, um VPS dedicado pode ser mais econômico que assinaturas de plataformas SaaS.
- Flexibilidade e Personalização: Adapte o ambiente de acordo com suas necessidades específicas, instale softwares adicionais e ajuste configurações de performance.
- Integração Profunda: O n8n, em conjunto com a Evolution API, permite criar integrações complexas com sistemas legados ou APIs privadas que não seriam possíveis em plataformas fechadas.
Requisitos de Servidor para n8n Evolution Combo
Para garantir que seu n8n e a Evolution API funcionem sem problemas em produção, especialmente quando combinados em um setup como o Evolution Combo, é crucial ter um servidor com recursos adequados. Abaixo, detalhamos os requisitos mínimos e recomendados:
Requisitos Mínimos (Ambiente de Desenvolvimento/Teste)
- RAM: 4GB (essencial para rodar os containers do n8n, Evolution API, e um banco de dados como PostgreSQL de forma estável).
- CPU: 2 vCPUs (para processamento dos fluxos de trabalho e requisições da API).
- Armazenamento: 50GB SSD (para o sistema operacional, Docker, logs e dados do n8n/Evolution API).
Requisitos Recomendados (Ambiente de Produção)
- RAM: 8GB ou mais (para garantir performance sob carga, múltiplos workflows complexos e a Evolution API processando muitas conexões simultâneas).
- CPU: 4 vCPUs ou mais (para lidar com processamento intensivo e garantir respostas rápidas da API).
- Armazenamento: 100GB+ SSD (para crescimento de dados, logs e backups).
É importante notar que estes são requisitos para a stack completa, incluindo o n8n, a Evolution API, um banco de dados (como PostgreSQL recomendado para o n8n) e o proxy reverso (como Nginx ou Caddy) para gerenciar o acesso e os webhooks da Evolution API. Em minha experiência, rodar apenas o n8n pode parecer mais leve, mas a adição da Evolution API e a necessidade de um banco robusto elevam consideravelmente o consumo de recursos.
Passo a Passo: Deploy do n8n Evolution Combo com Docker Compose
A maneira mais eficiente e recomendada de implantar o n8n Evolution Combo é utilizando Docker e Docker Compose. Isso garante que todos os componentes estejam isolados e fáceis de gerenciar. Siga estes passos:
1. Preparando o Servidor Ubuntu
Primeiro, certifique-se de que seu servidor Ubuntu está atualizado e com o Docker e Docker Compose instalados. Se ainda não tem, execute os seguintes comandos:
sudo apt update && sudo apt upgrade -y
sudo apt install curl -y
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo apt install docker-compose-plugin -y
# Verifique as instalações
docker --version
docker compose version
Estes comandos instalam o Docker e o plugin do Docker Compose v2, que é a versão recomendada e mais recente.
2. Criando o Diretório e Arquivos de Configuração
Crie um diretório para o seu projeto e navegue até ele. Dentro deste diretório, vamos criar o arquivo docker-compose.yml e um arquivo .env para as variáveis de ambiente.
mkdir n8n-evolution-combo
cd n8n-evolution-combo
# Crie o arquivo .env (exemplo, ajuste conforme necessário)
cat >> .env << EOF
# Variáveis para o n8n
GENERIC_TIMEZONE=America/Sao_Paulo
NODE_ENV=production
WEBHOOKS_TUNNEL_URL=https://seu-dominio.com/webhook/
EH_PORT=5678 # Porta para Evolution API
EH_URL=https://seu-dominio.com
EH_MONGO_URL=mongodb://mongodb:27017/evolution # Se usar MongoDB
EH_POSTGRES_URL=postgres://postgres:postgres@db:5432/evolution # Se usar PostgreSQL
EH_USER_SESSION_SECRET=seu_segredo_muito_forte_aqui
EH_JWT_SECRET=outro_segredo_muito_forte_aqui
# Variáveis para o PostgreSQL (usado pelo n8n)
POSTGRES_DB=n8n
POSTGRES_USER=n8n
POSTGRES_PASSWORD=n8n_password
# Se usar MongoDB como banco do n8n (não recomendado para produção)
# MONGO_DB_NAME=n8n
# MONGO_DB_USER=n8n
# MONGO_DB_PASSWORD=n8n_password
# MONGO_DB_URL=mongodb://mongodb:27017/
EOF
Observação: Substitua seu-dominio.com pelo seu domínio real e gere segredos fortes para EH_USER_SESSION_SECRET e EH_JWT_SECRET. Para este tutorial, usaremos PostgreSQL como banco de dados principal para o n8n e para a Evolution API, pois oferece melhor performance e confiabilidade em produção. Se você precisa de um banco de dados mais robusto, considere um serviço gerenciado ou uma instalação dedicada para o PostgreSQL.
3. Configurando o Docker Compose
Crie o arquivo docker-compose.yml com o seguinte conteúdo. Este arquivo define os serviços para o n8n, o PostgreSQL e a Evolution API.
version: "3.8"
services:
n8n:
image: n8nio/n8n
container_name: n8n
restart: always
ports:
- "5679:5678"
environment:
- NODE_ENV=${NODE_ENV}
- GENERIC_TIMEZONE=${GENERIC_TIMEZONE}
- WEBHOOKS_TUNNEL_URL=${WEBHOOKS_TUNNEL_URL}
- N8N_HOST=n8n
- N8N_PORT=5678
- N8N_PROTOCOL=http
- N8N_LISTEN_ADDRESS=0.0.0.0
- POSTGRES_DATABASE=${POSTGRES_DB}
- POSTGRES_USER=${POSTGRES_USER}
- POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
- POSTGRES_HOST=db
- POSTGRES_PORT=5432
# Se usar MongoDB:
# - MONGO_DB_NAME=${MONGO_DB_NAME}
# - MONGO_DB_USER=${MONGO_DB_USER}
# - MONGO_DB_PASSWORD=${MONGO_DB_PASSWORD}
# - MONGO_DB_URL=${MONGO_DB_URL}
volumes:
- n8n_data:/home/node/.n8n
depends_on:
- db
db:
image: postgres:15
container_name: n8n_db
restart: always
environment:
POSTGRES_DB: ${POSTGRES_DB}
POSTGRES_USER: ${POSTGRES_USER}
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
volumes:
- n8n_db_data:/var/lib/postgresql/data
evolution_api:
image: ghcr.io/evolution-api/evolution-api:latest
container_name: evolution_api
restart: always
ports:
- "${EH_PORT}:${EH_PORT}"
environment:
- EH_PORT=${EH_PORT}
- EH_URL=${EH_URL}
- EH_JWT_SECRET=${EH_JWT_SECRET}
- EH_USER_SESSION_SECRET=${EH_USER_SESSION_SECRET}
- EH_POSTGRES_URL=${EH_POSTGRES_URL}
# Se usar MongoDB:
# - EH_MONGO_URL=${EH_MONGO_URL}
volumes:
- evolution_api_data:/usr/src/app/files
depends_on:
- db # Assumindo que ambos usam o mesmo banco PostgreSQL
volumes:
n8n_data:
n8n_db_data:
evolution_api_data:
Este docker-compose.yml configura três serviços: n8n, o banco de dados db (PostgreSQL) e a evolution_api. Eles compartilham o mesmo banco de dados PostgreSQL para simplificar a infraestrutura.
4. Iniciando os Contêineres
Agora, inicie os contêineres usando o Docker Compose:
docker compose up -d
O comando -d inicia os contêineres em segundo plano (detached mode). Após alguns minutos, seus serviços devem estar ativos. Você pode verificar o status com:
docker compose ps
Você deverá ver os três serviços (n8n, db, evolution_api) rodando.
5. Configurando o Proxy Reverso (Nginx)
Para acessar o n8n e a Evolution API de forma segura e através de um domínio, é essencial configurar um proxy reverso. Vamos usar o Nginx para isso. Primeiro, instale o Nginx se ainda não o tiver:
sudo apt install nginx -y
Crie um novo arquivo de configuração para seu domínio em /etc/nginx/sites-available/. Exemplo: /etc/nginx/sites-available/n8n-evolution:
server {
listen 80;
server_name seu-dominio.com;
location / {
proxy_pass http://localhost:5679; # Porta do N8N exposta no host
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 Connection "";
proxy_buffers 8 16k;
proxy_buffer_size 32k;
proxy_read_timeout 300s;
proxy_connect_timeout 75s;
}
location /webhook/ {
proxy_pass http://localhost:5678; # Porta da Evolution API exposta no host
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 Connection "";
proxy_buffers 8 16k;
proxy_buffer_size 32k;
proxy_read_timeout 300s;
proxy_connect_timeout 75s;
}
}
Habilite a configuração e reinicie o Nginx:
sudo ln -s /etc/nginx/sites-available/n8n-evolution /etc/nginx/sites-enabled/
sudo nginx -t # Testar configuração
sudo systemctl restart nginx
Depois de configurar o DNS para apontar seu domínio para o IP do seu VPS, você poderá acessar o n8n e a Evolution API. Para obter um certificado SSL gratuito com Let's Encrypt, você pode usar o Certbot: sudo apt install certbot python3-certbot-nginx -y e então executar sudo certbot --nginx.
A automação do WhatsApp com n8n e Evolution API se torna uma realidade prática com este setup. Se você busca otimizar ainda mais a performance do seu n8n, consulte nosso artigo sobre N8N Auto-Hospedado: Otimizando Performance em VPS Linux.
Configurando o n8n e a Evolution API
Primeiro Acesso ao n8n
Ao acessar http://seu-dominio.com (ou https://seu-dominio.com após configurar SSL), você será apresentado à tela de registro do n8n. Crie sua conta. Para ambientes de produção, é altamente recomendado configurar um banco de dados externo robusto (PostgreSQL é a escolha preferida do n8n) em vez de usar o armazenamento em arquivo padrão. No nosso setup, já definimos o PostgreSQL para ser usado pelo n8n.
Configurando a Evolution API
A Evolution API estará acessível em http://seu-dominio.com/webhook/ (ou https://seu-dominio.com/webhook/ com SSL). A interface de administração geralmente requer um usuário e senha definidos nas variáveis de ambiente (EH_USER_SESSION_SECRET e EH_JWT_SECRET). É aqui que você gerenciará suas instâncias do WhatsApp, webhooks e configurações.
Integração n8n e Evolution API
Para automatizar o WhatsApp com n8n, você usará o nó HTTP Request no n8n para enviar requisições à Evolution API. Por exemplo, para enviar uma mensagem:
- Método: POST
- URL:
https://seu-dominio.com/webhook/instance/seu-instance-name/send-text(substituaseu-instance-namepelo nome da sua instância configurada na Evolution API) - Headers: Authorization: Bearer seu_jwt_secret_aqui
- Body:
{"number":"5511999998888", "text":"Olá do n8n!"}
Essa integração permite que qualquer gatilho no n8n dispare mensagens, crie fluxos de atendimento e muito mais. Para um guia mais aprofundado sobre como criar automações robustas, confira nosso artigo sobre N8N e Evolution API: Automação WhatsApp Robusta em Seu VPS.
Comparativo: n8n vs. Outras Ferramentas de Automação
Ao escolher uma ferramenta de automação, é crucial entender onde o n8n Evolution Combo se encaixa. Aqui comparamos o n8n com outras opções populares:
| Recurso | n8n Evolution Combo | Zapier | Make (Integromat) |
|---|---|---|---|
| Modelo de Implantação | Self-hosted (VPS), Cloud (SaaS) | SaaS | SaaS |
| Custo para Alto Volume | Baixo (VPS + tempo de setup) | Alto (planos de |
📦 Template n8n: Agente de IA com WhatsApp + Evolution API
Baixe o arquivo JSON pronto para importar: Webhook configurado, tratamento de remetente, nó de OpenAI e disparo via Evolution API.
FAQ: perguntas frequentes
O que é o n8n Evolution Combo?
O n8n Evolution Combo é uma combinação de ferramentas de automação, onde o n8n atua como a orquestrador de fluxos de trabalho e a Evolution API gerencia a conexão com o WhatsApp. Ambos são projetados para serem auto-hospedados (self-hosted), permitindo que você os implante em seu próprio servidor (VPS) para ter controle total sobre seus dados e automações.
Qual o requisito mínimo de servidor para rodar o n8n Evolution Combo?
Para um ambiente de produção estável, recomendamos um VPS com no mínimo 4GB de RAM e 2 vCPUs. Esta configuração suporta o n8n, a Evolution API, um banco de dados como PostgreSQL e um proxy reverso. Para cargas de trabalho mais intensas ou um maior número de integrações, 8GB de RAM e 4 vCPUs são ideais para garantir performance e escalabilidade.
Como o n8n se integra com a Evolution API para automação do WhatsApp?
A integração ocorre via requisições HTTP. O n8n, usando o nó HTTP Request, envia comandos para a Evolution API (hospedada em seu VPS) para enviar mensagens, gerenciar contatos, e receber notificações via webhooks. A Evolution API processa essas requisições e interage com a plataforma WhatsApp, permitindo automações como chatbots e notificações personalizadas.
Posso usar o n8n Evolution Combo para criar chatbots no WhatsApp?
Sim, absolutamente. Ao configurar a Evolution API para receber mensagens (via webhooks para o n8n) e usar o n8n para processar essas mensagens e enviar respostas (utilizando a Evolution API para o envio), você pode construir chatbots complexos e interativos para o WhatsApp. Isso oferece uma solução personalizada e mais econômica que muitas plataformas prontas.
É necessário ter um domínio para usar o n8n Evolution Combo?
Embora não seja estritamente obrigatório para testes locais, para uso em produção, especialmente para receber webhooks da Evolution API e gerenciar conexões de forma confiável, é altamente recomendado ter um domínio e configurar um proxy reverso (como Nginx ou Caddy) com certificado SSL. Isso garante acesso seguro e estável aos seus serviços.
Qual a diferença entre rodar n8n no VPS e usar a versão cloud?
Rodar o n8n no seu próprio VPS (self-hosted) oferece controle total sobre seus dados, maior segurança, flexibilidade de customização e potencial economia em larga escala. A versão cloud (SaaS) é mais fácil de começar, não exige gerenciamento de infraestrutura, mas pode ter custos mais altos, limitações de recursos e menor controle sobre dados sensíveis.
É possível usar o n8n Evolution Combo com outras bases de dados além de PostgreSQL?
Sim, o n8n suporta oficialmente bancos de dados como PostgreSQL, MySQL e MongoDB. A Evolution API também oferece suporte para PostgreSQL e MongoDB. Para produção, o PostgreSQL é geralmente recomendado para ambos devido à sua robustez e performance. A configuração no Docker Compose deve ser ajustada conforme o banco escolhido.
Como o n8n Evolution Combo ajuda na automação de processos de negócio?
O n8n Evolution Combo permite conectar diversas ferramentas e serviços (CRMs, planilhas, APIs de terceiros, WhatsApp) em fluxos de trabalho automatizados. Isso pode agilizar desde o envio de notificações de vendas via WhatsApp até a qualificação de leads, aprovações de documentos e integração de dados entre sistemas, liberando tempo para tarefas mais estratégicas.