- O Que É o n8n e Por Que Usá-lo em 2026
- Requisitos Antes de Começar
- Como Instalar o n8n no Servidor
- Entendendo a Interface do n8n
- Construindo Seu Primeiro Workflow
- Casos de Uso Práticos para Agências e Desenvolvedores
- Onde Hospedar Sua Instância n8n
- Dicas para Workflows Mais Robustos
- Erros Comuns de Iniciantes
- FAQs
- Conclusão
Se você já perdeu horas repetindo tarefas manuais entre sistemas que deveriam se integrar automaticamente, este tutorial foi escrito para você. O n8n é uma ferramenta de automação de workflows open source que conecta APIs, bancos de dados, serviços de e-mail, CRMs e dezenas de outras ferramentas — sem exigir que você escreva integrações do zero. Em 2026, ele se consolidou como uma das escolhas mais práticas para desenvolvedores e agências digitais brasileiras que precisam de automação real sem depender de plataformas SaaS caras cheias de limites de execução.
Este guia cobre tudo: o que é o n8n, como instalá-lo, como construir seu primeiro fluxo funcional e onde hospedar a instância para ter controle total sobre dados e execuções.
O Que É o n8n e Por Que Usá-lo em 2026
O n8n (pronunciado "n-eight-n") é uma plataforma de automação baseada em nós. Cada nó representa uma ação: buscar dados de uma API, enviar um e-mail, gravar em uma planilha, fazer uma requisição HTTP, ou executar JavaScript personalizado. Você conecta esses nós visualmente e define quando e como cada etapa deve acontecer.
A diferença em relação a ferramentas como Zapier ou Make é estrutural. Rodando na sua própria infraestrutura, você não paga por execução, não tem limite de workflows ativos e seus dados não passam por servidores de terceiros. Para agências que lidam com dados de clientes, isso não é detalhe — é requisito.
Além disso, o n8n tem suporte nativo a código. Quando a lógica de negócio for complexa demais para configuração visual, você insere um nó de função com JavaScript puro. Isso coloca o n8n numa categoria diferente das ferramentas voltadas para usuários não técnicos.
Requisitos Antes de Começar
Antes de instalar o n8n, você vai precisar de:
- Um servidor Linux (Ubuntu 22.04 ou 24.04 são as distribuições mais testadas)
- Node.js versão 18 ou superior
- NPM ou um gerenciador de pacotes como pnpm
- Acesso SSH ao servidor
- Um domínio ou subdomínio apontado para o IP do servidor (se quiser acesso via HTTPS)
Para testar localmente, um computador com Node.js instalado já é suficiente. Para produção com clientes reais, você precisa de um VPS ou servidor dedicado com recursos adequados.
Como Instalar o n8n no Servidor
Instalação via NPM (Método Mais Direto)
A forma mais rápida de instalar o n8n globalmente:
npm install n8n -g
Após a instalação, inicie com:
n8n start
Por padrão, o n8n sobe na porta 5678. Acesse http://localhost:5678 no navegador para ver a interface.
Instalação via Docker (Recomendado para Produção)
Para ambientes de produção, Docker é a abordagem mais estável e fácil de manter. Crie um arquivo docker-compose.yml:
version: '3.8'
services:
n8n:
image: docker.n8n.io/n8nio/n8n
restart: always
ports:
- "5678:5678"
environment:
- N8N_HOST=seu-dominio.com
- N8N_PORT=5678
- N8N_PROTOCOL=https
- WEBHOOK_URL=https://seu-dominio.com/
- GENERIC_TIMEZONE=America/Sao_Paulo
volumes:
- n8n_data:/home/node/.n8n
volumes:
n8n_data:
Suba o container com:
docker compose up -d
Esse setup persiste workflows e credenciais no volume n8n_data, então nada é perdido ao reiniciar o container.
Configurar HTTPS com Nginx como Proxy Reverso
Para expor o n8n publicamente com HTTPS, configure o Nginx como proxy reverso. Instale o Nginx e o Certbot, depois crie um bloco de servidor:
server {
listen 443 ssl;
server_name seu-dominio.com;
ssl_certificate /etc/letsencrypt/live/seu-dominio.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/seu-dominio.com/privkey.pem;
location / {
proxy_pass http://localhost:5678;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
proxy_cache_bypass $http_upgrade;
}
}
Obtenha o certificado com certbot --nginx -d seu-dominio.com e reinicie o Nginx. Sua instância n8n estará acessível via HTTPS.
Entendendo a Interface do n8n
Ao abrir o n8n pela primeira vez, a tela principal exibe o editor de workflows. Os elementos centrais são:
Canvas: A área de trabalho onde você arrasta, posiciona e conecta os nós.
Painel lateral de nós: Clique em "+" para abrir o catálogo de integrações. Em 2026, o n8n conta com mais de 400 integrações nativas.
Nó de trigger: Todo workflow começa com um trigger, que define quando o fluxo é executado — pode ser um webhook, um agendamento (cron), um evento de e-mail, ou uma execução manual.
Execuções: A seção "Executions" no menu lateral mostra o histórico completo de rodadas, com status de sucesso ou erro e os dados que passaram por cada nó.
Construindo Seu Primeiro Workflow
Vamos criar algo prático: sempre que um formulário no seu site enviar dados, o n8n recebe via webhook, formata as informações e envia um e-mail de notificação.
Passo 1: Adicionar o Nó Webhook
No canvas, clique em "+" e pesquise por "Webhook". Configure o nó:
- HTTP Method: POST
- Path:
/novo-lead(ou qualquer caminho que preferir) - Response Mode: Immediately
Salve o nó. O n8n vai gerar uma URL no formato https://seu-dominio.com/webhook/novo-lead — essa é a URL que você vai colocar no formulário do site.
Passo 2: Adicionar um Nó de Função para Formatar os Dados
Conecte um nó "Code" após o webhook para transformar os dados recebidos:
const nome = $input.item.json.body.nome || 'Não informado';
const email = $input.item.json.body.email || 'Não informado';
const mensagem = $input.item.json.body.mensagem || '';
return [{
json: {
nome,
email,
mensagem,
dataRecebimento: new Date().toLocaleString('pt-BR', { timeZone: 'America/Sao_Paulo' })
}
}];
Esse nó extrai os campos relevantes e adiciona um timestamp no fuso horário de Brasília.
Passo 3: Adicionar o Nó de E-mail
Conecte um nó "Send Email" (ou o nó Gmail, se preferir OAuth). Configure:
- To: seu-email@dominio.com
- Subject:
Novo lead recebido: {{ $json.nome }} - Body:
Nome: {{ $json.nome }} E-mail: {{ $json.email }} Mensagem: {{ $json.mensagem }} Recebido em: {{ $json.dataRecebimento }}
Para usar SMTP genérico, configure as credenciais do seu servidor de e-mail na seção "Credentials" do n8n.
Passo 4: Ativar o Workflow
No canto superior direito do editor, mude o toggle de "Inactive" para "Active". A partir daí, qualquer POST enviado para a URL do webhook dispara o fluxo completo.
Teste com cURL:
curl -X POST https://seu-dominio.com/webhook/novo-lead \
-H "Content-Type: application/json" \
-d '{"nome":"João Silva","email":"joao@exemplo.com","mensagem":"Quero saber mais"}'
Se tudo estiver configurado corretamente, o e-mail chega em segundos.
Casos de Uso Práticos para Agências e Desenvolvedores
Com o primeiro workflow funcionando, a lógica se repete para qualquer automação. Alguns fluxos que agências brasileiras costumam implementar:
Sincronização de leads entre plataformas: Capturar leads do RD Station, Google Ads ou Meta Ads e enviá-los automaticamente para um CRM como Pipedrive ou Notion.
Alertas de monitoramento de sites: Usar o nó HTTP Request para verificar periodicamente se um site cliente está respondendo. Se retornar erro, disparar alerta via WhatsApp pela API do WhatsApp Business.
Geração automática de relatórios: Buscar dados do Google Analytics ou Search Console via API, formatar em uma planilha do Google Sheets e enviar por e-mail toda segunda-feira de manhã.
Automação de onboarding de clientes: Quando um novo cliente é adicionado no CRM, criar automaticamente a pasta no Google Drive, enviar e-mail de boas-vindas personalizado e criar tarefa no projeto do time.
Cada fluxo segue a mesma estrutura: trigger, transformação de dados, ação. O que muda é a combinação de nós e a lógica de negócio no meio.
Onde Hospedar Sua Instância n8n
Essa é a decisão que mais impacta a confiabilidade das suas automações. Um servidor instável vai interromper webhooks, perder execuções agendadas e gerar problemas difíceis de depurar — exatamente o tipo de incidente que consome horas de trabalho sem gerar nada para o cliente.
Para automações de produção, você precisa de:
- Uptime garantido (99,9% ou mais)
- Armazenamento rápido para o banco de dados interno do n8n
- Latência baixa para webhooks que precisam responder rapidamente
- Suporte acessível quando algo der errado
Um VPS com NVMe SSD é o ponto de entrada razoável para a maioria dos casos. Para agências gerenciando automações de múltiplos clientes, um servidor dedicado tende a ser a escolha mais segura.
A Napoleon oferece VPS com armazenamento NVMe e servidores dedicados bare metal em datacenters no Brasil e nos EUA, com suporte 24/7 via WhatsApp e Telegram. Para quem hospeda automações críticas, ter suporte no canal que você já usa no dia a dia faz diferença quando um webhook para de responder às 23h.
Dicas para Workflows Mais Robustos
Configure tratamento de erros desde o início. O n8n tem um nó "Error Trigger" que captura falhas em qualquer workflow e pode enviar um alerta imediato. Não deixe para adicionar isso depois.
Versione seus workflows. Exporte como JSON e versione no Git. O n8n tem exportação nativa via interface e via CLI.
Separe credenciais por ambiente. Crie credenciais diferentes para desenvolvimento e produção. Misturar os dois é a causa mais comum de dados de teste chegando em sistemas reais.
Monitore o uso de memória. Workflows que processam arquivos grandes ou fazem loops extensos podem consumir muita RAM. Acompanhe o uso do servidor e ajuste os recursos conforme o volume de execuções cresce.
Use filas para workflows de alto volume. O n8n suporta modo de fila com Redis para distribuir execuções. Se você tem workflows disparando centenas de vezes por hora, o modo de fila é necessário para evitar sobrecarga.
Erros Comuns de Iniciantes
Webhook não recebe dados: Confirme que o workflow está ativo (toggle "Active" ligado) e que a URL está correta. Teste com cURL antes de integrar ao sistema externo.
Credenciais não funcionam após migração: O n8n armazena credenciais criptografadas. Se você migrou a instância sem copiar a variável N8N_ENCRYPTION_KEY, as credenciais antigas ficam inacessíveis. Sempre faça backup dessa variável.
Workflows somem após atualização do Docker: Verifique se o volume de dados está montado corretamente. Sem o volume persistente, tudo é perdido ao recriar o container.
Agendamentos rodando no horário errado: Configure GENERIC_TIMEZONE=America/Sao_Paulo no Docker ou no arquivo de configuração do n8n para garantir que os cron jobs rodem no horário correto.
FAQs
O n8n é gratuito?
A versão open source é completamente gratuita para hospedar no seu próprio servidor — sem custo de licença, sem cobrança por execução. Existe também uma versão em nuvem gerenciada com planos pagos, mas para uso em servidor próprio não há nenhuma cobrança.
Qual a diferença entre n8n e Zapier?
O Zapier é um SaaS com cobrança por tarefa executada e limites nos planos gratuitos. O n8n pode ser auto-hospedado, sem custo por execução e sem limite de workflows ativos. Além disso, o suporte nativo a JavaScript nos nós de função torna o n8n muito mais flexível para lógicas complexas.
Preciso saber programar para usar o n8n?
Não necessariamente. A maioria dos workflows pode ser construída usando apenas nós visuais. Mas conhecimento básico de JavaScript e JSON ajuda bastante quando você precisa transformar dados ou lidar com casos fora do padrão das integrações nativas.
Quantos recursos de servidor o n8n precisa?
Para uso básico com poucos workflows, 1 vCPU e 1 GB de RAM funcionam. Para produção com múltiplos workflows ativos e alto volume de execuções, 2 vCPUs e 4 GB de RAM são um ponto de partida mais confortável. Workflows com processamento de arquivos ou loops extensos podem exigir mais.
Como fazer backup dos workflows?
Você pode exportar workflows individualmente como JSON pela interface, ou fazer backup completo do volume Docker que contém o banco de dados SQLite (ou PostgreSQL, se você configurou um banco externo). A segunda opção é mais completa porque inclui credenciais e histórico de execuções.
O n8n funciona com WhatsApp?
Sim, via integração com a API oficial do WhatsApp Business ou com serviços intermediários como Evolution API. O nó HTTP Request permite chamar qualquer API REST, então qualquer serviço com API pode ser integrado mesmo sem um nó nativo dedicado.
Posso rodar o n8n em hospedagem compartilhada?
Não de forma prática. O n8n é uma aplicação Node.js que precisa rodar como processo contínuo em background — algo que hospedagem compartilhada não permite. Para produção, você precisa de um VPS ou servidor dedicado.
Conclusão
O n8n resolve um problema concreto: conectar sistemas que não se falam sem depender de plataformas caras ou escrever integrações do zero. Com a instalação via Docker, um servidor adequado e os conceitos de trigger, transformação e ação bem entendidos, você consegue construir automações úteis em poucas horas.
O próximo passo é explorar os nós de banco de dados, as integrações de IA (o n8n tem suporte nativo a OpenAI e outros modelos) e o modo de fila para workflows de alto volume. A lógica é sempre a mesma — o que muda é a complexidade da orquestração.
Se você ainda está definindo onde hospedar sua instância, vale avaliar a infraestrutura antes de começar a construir automações críticas. Uma base instável vai custar mais tempo de depuração do que qualquer economia inicial.
