n8n-evolution-combo: Deploy em VPS

Desmistificando o n8n-evolution-combo: Sua Nova Central de Automação em VPS

Para quem busca controle total sobre a automação e a integração do WhatsApp, a combinação de n8n e Evolution API em um ambiente auto-hospedado é imbatível. Este artigo vai direto ao ponto: como você, de forma prática e sem rodeios, pode implantar essa poderosa ferramenta em um servidor VPS e começar a automatizar suas operações. Se você já decidiu que quer o poder do n8n e a conectividade do Evolution API na sua infraestrutura, este guia é para você. Vamos focar nos requisitos, no deploy usando Docker e nas melhores práticas para garantir que sua automação funcione sem falhas.

Veja a infraestrutura: VPS para n8n + Evolution API para colocar este projeto no ar.

O n8n-evolution-combo oferece uma flexibilidade sem precedentes para criar fluxos de trabalho complexos. Com o n8n, você desenha visualmente suas automações, conectando diversas ferramentas e APIs. A Evolution API entra como a ponte para o WhatsApp, permitindo o envio e recebimento de mensagens, gerenciamento de contatos e muito mais, tudo rodando no seu próprio servidor. Para isso, o mínimo recomendado para um ambiente de produção robusto é um VPS com 4GB de RAM, 4 vCPUs e espaço em disco suficiente para os contêineres e logs. Menos que isso pode levar a instabilidades, especialmente com o uso intensivo do WhatsApp.

Requisitos Essenciais para Implantar o n8n-evolution-combo

Antes de colocar a mão na massa, é crucial entender o que seu servidor precisa para rodar essa stack de automação com performance e estabilidade. A boa notícia é que, com a Host You Secure, você encontra planos que atendem perfeitamente a essas necessidades.

Hardware Mínimo e Recomendado para Produção

Rodar o n8n e a Evolution API em produção exige um pouco mais de recursos do que em um ambiente de desenvolvimento. Nossa experiência aponta que:

• RAM: Mínimo de 4GB para produção. Para cenários com muitos fluxos ativos ou alto volume de mensagens no WhatsApp, 8GB ou mais são recomendados. O n8n, por si só, pode consumir cerca de 1GB em uso moderado, e a Evolution API pode demandar mais dependendo da carga de conexões. O banco de dados (PostgreSQL é uma excelente escolha) e o proxy reverso também consomem recursos.
• vCPUs: Mínimo de 4 vCPUs. Mais núcleos significam melhor paralelismo para processar múltiplos fluxos simultaneamente e responder mais rapidamente às requisições da Evolution API.
• Armazenamento: Pelo menos 50GB de espaço em disco. Considere espaço para os contêineres Docker, logs do n8n e da Evolution API, backups do banco de dados e, se necessário, arquivos temporários. SSDs são altamente recomendados para melhor performance de I/O.

Software Necessário

Para um deploy eficiente e moderno, o Docker e o Docker Compose são seus melhores amigos. Eles simplificam a instalação, a gestão das dependências e o isolamento dos serviços. Certifique-se de ter o Docker Engine instalado em seu servidor Linux (Ubuntu é uma escolha popular e bem suportada) e o plugin do Docker Compose.

Banco de Dados: A Espinha Dorsal da Automação

O n8n utiliza um banco de dados para armazenar workflows, credenciais e dados de execução. Embora o SQLite seja suficiente para testes, para produção, recomendamos fortemente o uso de um banco de dados mais robusto, como o PostgreSQL. Ele oferece melhor performance, escalabilidade e confiabilidade. A Evolution API também pode se beneficiar de um banco de dados dedicado para gerenciar conexões e sessões, embora muitas vezes funcione bem com um banco de dados leve para suas configurações.

Tutorial de Deploy: n8n e Evolution API com Docker Compose

Vamos ao que interessa: implantar o n8n e a Evolution API em seu VPS. Usaremos Docker Compose para gerenciar todos os serviços de forma integrada. Este método garante que as dependências sejam resolvidas automaticamente e que o ambiente seja facilmente reproduzível.

Passo 1: Preparando o Ambiente no Servidor VPS

Primeiro, conecte-se ao seu servidor via SSH e certifique-se de que o Docker e o Docker Compose estejam instalados. Se ainda não os tem, siga os passos abaixo:

# Atualiza a lista de pacotes
sudo apt update && sudo apt upgrade -y

# Instala Docker Engine
sudo apt install ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") 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

# Verifica a instalação
docker --version
docker compose version

Se você encontrar dificuldades com a instalação do Docker, nosso artigo sobre Docker em VPS: Deploy Rápido e Eficiente (Passo a Passo) pode ajudar a resolver problemas comuns.

Passo 2: Criando os Arquivos de Configuração

Crie um diretório para o seu projeto e navegue até ele. Dentro deste diretório, crie um arquivo chamado docker-compose.yml. Este arquivo definirá todos os serviços: n8n, Evolution API e PostgreSQL.

Para o n8n, é recomendado usar um banco de dados externo como PostgreSQL. Para a Evolution API, também sugerimos um banco de dados dedicado. Vamos configurar tudo em um único docker-compose.yml para simplificar.

version: '3.8'

services:
  n8n:
    image: n8nio/n8n
    container_name: n8n
    restart: always
    ports:
      - "5678:5678"
    environment:
      - N8N_HOST=n8n.seudominio.com # Substitua pelo seu domínio ou IP
      - N8N_PORT=5678
      - WEBHOOK_URL=https://n8n.seudominio.com/webhook/ # Se usar webhook
      - TZ=America/Sao_Paulo
      - DB_TYPE=postgres
      - DB_HOST=db_n8n
      - DB_PORT=5432
      - DB_USER=n8n_user
      - DB_PASSWORD=minha_senha_forte_n8n
      - DB_DATABASE=n8n_db
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=senha_segura_admin
    volumes:
      - n8n_data:/home/node/.n8n
    networks:
      - automacao_net

  evolution_api:
    image: evolutionswp/evolutionapi
    container_name: evolution_api
    restart: always
    ports:
      - "8080:8080"
    environment:
      - TZ=America/Sao_Paulo
      - WA_PATH=/app/backend/whaticket
      - WA_TOKEN=seu_token_secreto_evolution
      - WA_INSTANCE=default
      - DB_TYPE=postgres
      - DB_HOST=db_evolution
      - DB_PORT=5432
      - DB_USER=evo_user
      - DB_PASSWORD=minha_senha_forte_evo
      - DB_DATABASE=evolution_db
    volumes:
      - evolution_data:/app/backend/whaticket
      - ./certs:/etc/nginx/certs # Para certificados SSL, se necessário
    networks:
      - automacao_net

  db_n8n:
    image: postgres:14
    container_name: db_n8n
    restart: always
    environment:
      - POSTGRES_USER=n8n_user
      - POSTGRES_PASSWORD=minha_senha_forte_n8n
      - POSTGRES_DB=n8n_db
    volumes:
      - n8n_postgres_data:/var/lib/postgresql/data
    networks:
      - automacao_net

  db_evolution:
    image: postgres:14
    container_name: db_evolution
    restart: always
    environment:
      - POSTGRES_USER=evo_user
      - POSTGRES_PASSWORD=minha_senha_forte_evo
      - POSTGRES_DB=evolution_db
    volumes:
      - evolution_postgres_data:/var/lib/postgresql/data
    networks:
      - automacao_net

volumes:
  n8n_data:
  evolution_data:
  n8n_postgres_data:
  evolution_postgres_data:

networks:
  automacao_net:
    driver: bridge

Observações importantes:

• Substitua n8n.seudominio.com pelo seu domínio ou IP público.
• Altere minha_senha_forte_n8n, minha_senha_forte_evo, seu_token_secreto_evolution e as credenciais de admin do n8n por senhas fortes e únicas.
• Para produção, é ALTAMENTE RECOMENDADO configurar um proxy reverso (como Nginx ou Caddy) para gerenciar certificados SSL, rotear as requisições e expor os serviços de forma segura.

Passo 3: Configurando o Proxy Reverso (Nginx como exemplo)

Para acessar o n8n e a Evolution API de forma segura e via domínio, vamos configurar um proxy reverso com Nginx. Instale o Nginx se ainda não o tiver:

sudo apt install nginx -y

Crie um arquivo de configuração para o seu domínio (ex: /etc/nginx/sites-available/n8n-evolution):

server {
    listen 80;
    server_name n8n.seudominio.com evo.seudominio.com;

    location / {
        proxy_pass http://localhost:5678; # Porta do n8n
        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;
    }

    location /api/v1/union/webhook/ {
        proxy_pass http://localhost:8080/api/v1/union/webhook/; # Porta da Evolution API para webhooks
        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_read_timeout 90s;
    }

    location /ws/ {
        proxy_pass http://localhost:8080/ws/; # Porta da Evolution API para WebSockets
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        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;
    }
}

Habilite a configuração e reinicie o Nginx:

sudo ln -s /etc/nginx/sites-available/n8n-evolution /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

Para configurar SSL/TLS com Let's Encrypt, você pode usar o Certbot:

sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d n8n.seudominio.com -d evo.seudominio.com

A configuração de um proxy reverso é vital para a segurança e o bom funcionamento em produção. Se você precisa de mais detalhes sobre como configurar o Nginx, nosso guia sobre Typebot: Resolva Problemas de Deploy e Webhook contém boas práticas que se aplicam aqui.

Passo 4: Iniciando os Contêineres

Navegue de volta ao diretório onde você salvou o arquivo docker-compose.yml e execute o seguinte comando para iniciar os serviços:

docker compose up -d

O comando -d inicia os contêineres em modo detached (em segundo plano). Para verificar o status dos contêineres, use:

docker compose ps

Você deverá ver os contêineres do n8n, Evolution API e os bancos de dados rodando.

Otimizando a Integração com WhatsApp via Evolution API e n8n

Com a infraestrutura pronta, o foco agora é maximizar o potencial da sua automação. A Evolution API, quando bem configurada e integrada ao n8n, torna-se uma ferramenta poderosa para comunicação com clientes.

Automatizar WhatsApp com n8n

O n8n possui nós específicos para interagir com APIs. Você pode usar o nó HTTP Request do n8n para enviar requisições à Evolution API, automatizando o envio de mensagens, atualizações de status, e muito mais. Por exemplo, após um evento em outro sistema (como uma nova venda no seu e-commerce), você pode configurar um workflow no n8n para enviar uma notificação personalizada via WhatsApp usando a Evolution API.

Chatbot WhatsApp com n8n

Para criar um chatbot WhatsApp com n8n, você configuraria a Evolution API para receber mensagens e enviá-las via webhook para o n8n. No n8n, um workflow receberia essa mensagem, processaria a intenção do usuário (talvez consultando um banco de dados ou outra API) e, em seguida, usaria novamente a Evolution API para enviar uma resposta. A chave é o uso eficiente do nó de webhook do n8n e dos nós de requisição HTTP para se comunicar com a Evolution API.

A robustez do seu sistema de automação dependerá da qualidade da sua infraestrutura. Se você encontrar contêineres travados em loop ou com problemas de inicialização, o artigo Debugando Docker: Resolva Containers em Loop Infinito pode oferecer soluções valiosas.

Comparativo: n8n vs. Outras Ferramentas de Automação (com foco em VPS)

É importante entender onde o n8n se encaixa no ecossistema de automação, especialmente quando rodando em seu próprio VPS.

Erros Comuns e Soluções

Ao implantar e gerenciar o n8n-evolution-combo, alguns problemas podem surgir. Estar preparado para eles economiza tempo e evita dores de cabeça.

• Contêineres parando inesperadamente (OOM Killer): Isso geralmente indica falta de RAM. Verifique o consumo de memória com docker compose ps e considere aumentar a RAM do seu VPS. Nossos planos de VPS Brasil Básico já vêm com 4GB, ideal para iniciar.
• Problemas de conexão com a Evolution API: Certifique-se de que as portas (8080, e a porta para WebSockets/webhooks) estejam abertas no firewall do servidor e configuradas corretamente no Nginx. Verifique os logs da Evolution API para mensagens de erro específicas.
• Fluxos do n8n não executando: Verifique se o n8n está se conectando corretamente ao banco de dados PostgreSQL. Logs do n8n e do banco de dados são cruciais aqui.
• WhatsApp desconectado na Evolution API: A conexão do WhatsApp pode cair por diversos motivos (mudanças na rede, instabilidade do serviço, bloqueios temporários). Reiniciar o contêiner da Evolution API geralmente resolve problemas temporários. Para falhas persistentes, consulte os logs e a documentação da Evolution API.
• Configuração de Webhooks incorreta: Tanto no n8n quanto na Evolution API, a configuração de webhooks deve ser precisa. Certifique-se de que as URLs estejam corretas e que o Nginx esteja roteando o tráfego adequadamente.

Perguntas Frequentes sobre n8n-evolution-combo

O que é o n8n-evolution-combo?

O n8n-evolution-combo refere-se à combinação do n8n, uma ferramenta de automação de fluxo de trabalho visual, com a Evolution API, uma solução para integrar o WhatsApp em seus sistemas. Essa união permite criar automações complexas e robustas envolvendo o WhatsApp, tudo rodando em sua própria infraestrutura.

Quais os requisitos de servidor para rodar n8n e Evolution API?

Para produção, recomendamos um VPS com no mínimo 4GB de RAM, 4 vCPUs e 50GB de espaço em disco SSD. A configuração exata pode variar dependendo do volume de uso e da complexidade dos seus fluxos de automação. É essencial ter um sistema operacional Linux estável e Docker instalado.

Posso usar um banco de dados diferente do PostgreSQL?

Sim, o n8n suporta SQLite, MySQL e PostgreSQL. No entanto, para produção, o PostgreSQL é altamente recomendado devido à sua performance, confiabilidade e escalabilidade. A Evolution API também funciona bem com PostgreSQL.

Como faço para que o WhatsApp funcione com o n8n?

Você utiliza a Evolution API para gerenciar a conexão com o WhatsApp. O n8n, por sua vez, se comunica com a Evolution API via requisições HTTP ou webhooks para enviar e receber mensagens, integrando assim o WhatsApp aos seus fluxos de automação.

É seguro rodar n8n e Evolution API em um VPS?

Sim, rodar em um VPS oferece controle total sobre seus dados e a segurança da sua infraestrutura. É crucial implementar práticas de segurança, como usar senhas fortes, configurar um firewall, manter o sistema atualizado e usar um proxy reverso com SSL/TLS para proteger o acesso.

O n8n pode substituir um CRM completo?

O n8n pode se integrar a CRMs existentes ou atuar como um hub de automação para tarefas que um CRM executa, como envio de notificações ou qualificação de leads. No entanto, ele não substitui todas as funcionalidades de um CRM robusto, como gerenciamento avançado de pipeline de vendas ou automações de marketing complexas sem integrações adicionais.

Qual a diferença entre o n8n e a Evolution API?

O n8n é a ferramenta de orquestração e criação de fluxos de trabalho, permitindo conectar diversas aplicações. A Evolution API é uma solução específica para integrar o WhatsApp, fornecendo uma interface para enviar/receber mensagens e gerenciar sessões, que pode ser chamada pelo n8n.

Como faço o deploy sem Docker?

Embora o Docker seja o método recomendado pela sua simplicidade e reprodutibilidade, é possível instalar o n8n e a Evolution API diretamente no servidor. Isso geralmente envolve a instalação do Node.js, dependências e a configuração manual de serviços com `systemd`. O processo é mais complexo e propenso a erros, sendo o Docker a abordagem preferencial para a maioria dos casos de uso em produção.

Conclusão: Potencialize Sua Automação com n8n e Evolution API em Seu VPS

Implantar o n8n e a Evolution API em um VPS é um passo estratégico para empresas que buscam controle, segurança e escalabilidade em suas automações, especialmente na integração com o WhatsApp. Com os requisitos de hardware adequados (como 4GB de RAM e 4 vCPUs) e o uso de Docker Compose, você pode ter sua própria central de automação funcionando em poucas horas.

Na Host You Secure, sabemos que a infraestrutura é tão importante quanto a ferramenta. Por isso, oferecemos planos otimizados para rodar suas aplicações. Acreditamos que um ambiente estável e performático é a base para o sucesso das suas automações. Temos esse mesmo stack em produção em uma VPS Brasil Básico, que oferece 4GB de RAM e 4 vCPUs por apenas R$ 99/mês, ideal para começar ou escalar suas operações de automação com n8n e Evolution API.

Não deixe suas automações limitadas por plataformas externas. Tenha o controle total em suas mãos. Descubra o plano VPS Brasil Básico e potencialize sua automação hoje mesmo!