Este n8n guia completo em português ensina você a instalar, configurar e usar o n8n para automatizar processos de forma prática.
Destinado a desenvolvedores, pequenos negócios e iniciantes, o conteúdo cobre desde a instalação gratuita até a criação de webhooks avançados.
Ao final, você terá domínio total da ferramenta e saberá comparar n8n com Zapier e Make.
O que é o N8n e Por Que Usá-lo?
O n8n é uma plataforma de automação de código aberto que permite criar fluxos entre APIs, bancos de dados e serviços sem escrever código.
Ele oferece mais de 250 nodes, execução auto‑hosted e controle total sobre dados, ideal para quem preza por privacidade.
Curiosidade: usuários avançados costumam usar o node Execute Command para chamar scripts Bash dentro do fluxo.
Consulte a documentação oficial para detalhes de cada node.
Instalando o N8n: Opções e Configurações
Você pode rodar o n8n gratuitamente via Docker ou usando o pacote npm; ambos dão acesso total à interface web.
Primeiro, escolha a opção que melhor se adapta ao seu ambiente.
- Instalação grátis com npm:
npm install n8n -g
Inicie comn8n start. A interface abre emhttp://localhost:5678. - Instalação na VPS com Docker:
docker run -d --name n8n -p 5678:5678 n8nio/n8n
O container persiste dados em volume/root/.n8n.
Para passo a passo detalhado, veja Instalar n8n de graça e Instalar n8n na VPS com Docker.
Configurando o Webhook no N8n
Webhooks no n8n recebem requisições externas e disparam fluxos automaticamente, perfeito para integrar formulários ou serviços.
Crie um node “Webhook” e copie a URL gerada; ela será seu ponto de entrada.
- Adicione o node “Webhook” ao seu workflow.
- Defina o método (GET, POST) e o caminho (ex.:
/api/receber). - Salve o workflow e copie a URL exibida.
- Configure a fonte externa (por exemplo, um formulário HTML) para enviar dados para essa URL.
Teste enviando um curl: curl -X POST -d "campo=valor" https://seuservidor.com/api/receber. O fluxo deve iniciar imediatamente.
Mais detalhes sobre webhooks estão em O que é webhook no n8n?.
Node HTTP Request no N8n: Guia Completo
O node HTTP Request no n8n envia requisições HTTP GET, POST, PUT, DELETE ou PATCH para qualquer API REST, retornando resposta em JSON ou texto.
Ele é fundamental para integrar serviços externos, enviar dados a webhooks ou consumir dados de APIs.
Como usar o node HTTP Request
Adicione o node HTTP Request ao fluxo, configure a URL da API, método, cabeçalhos e payload conforme necessário.
- Defina a URL do endpoint (ex.:
https://api.exemplo.com/v1/dados). - Escolha o método (GET, POST, PUT, DELETE).
- Adicione cabeçalhos personalizados (ex.:
Authorization: Bearer TOKEN). - Para POST/PUT, insira o body no formato JSON ou form-data.
- Salve e teste o node para ver a resposta da API.
Exemplo de resposta esperada: {"status": "sucesso", "dados": [...]}.
Dica: use o node “Set” antes para manipular dados antes de enviar na requisição.
Para detalhes avançados, acesse Node HTTP Request no n8n: Guia Completo.
Exemplo prático com API pública
Fluxo para buscar dados da JSONPlaceholder:
- Nodes: HTTP Request → Set → Write Binary File.
- Configuração: URL =
https://jsonplaceholder.typicode.com/posts/1, método = GET. - Resultado: arquivo salvo com os dados da postagem.
Erros Comuns no N8n e Como Resolvê-los
Erros como timeout na execução ou node desabilitado são frequentes e fáceis de corrigir com ajustes simples.
Veja os erros mais comuns e soluções diretas.
Lista de erros e soluções
| Erro | Causa provável | Solução |
|---|---|---|
| Execution timeout | Workflows longos ou APIs lentas. | Aumente o timeout em Settings > Execution Timeout ou otimize nodes. |
| Node desabilitado | Dependência não instalada ou permissão de pasta. | Verifique logs com docker logs n8n e reinstale dependências. |
| Credenciais inválidas | Token expirado ou permissão negada. | Renove tokens e revise permissões na API externa. |
| JSON inválido | Formato incorreto no payload ou saída de node. | Use o node “Function” para validar JSON antes de enviar. |
| Storage cheio | Volume de dados no container Docker. | Limpe cache com docker system prune ou aumente o volume. |
Para mais soluções, acesse Erros Comuns no N8n e Como Resolvê-los.
N8n vs Zapier vs Make: Qual Escolher?
Comparar n8n, Zapier e Make ajuda você a escolher a ferramenta ideal para automação sem código, com base em custo, privacidade e escalabilidade.
Aqui estão as diferenças essenciais em uma tabela direta.
Comparação n8n vs Zapier vs Make
| Critério | n8n | Zapier | Make |
|---|---|---|---|
| Modelo de preço | Gratuito (self-hosted), planos a partir de US$20/mês (nuvem). | Planos a partir de US$19.99/mês (limite de tasks). | Planos a partir de US$16/mês (limite de operações). |
| Código aberto | Sim (GitHub). | Não. | Não. |
| Controle de dados | Total (dados ficam no seu servidor). | Parcial (dados passam por servidores da Zapier). | Parcial (dados passam por servidores da Make). |
| Número de apps integrados | 250+ (nodes oficiais e comunidade). | 5000+ (apps oficiais). | 1000+ (apps oficiais). |
| Curva de aprendizado | Média (nodes e lógica de fluxo). | Baixa (interface drag-and-drop simples). | Média (interface visual, mas complexidade em cenários). |
| Execução auto-hosted | Sim (Docker, VPS, Kubernetes). | Não. | Sim (somente para planos enterprise). |
Use n8n se você prioriza privacidade e controle total. Escolha Zapier para simplicidade e apps populares. Opte por Make se precisa de cenários complexos com poucas tasks.
Veja mais detalhes em N8n vs Zapier vs Make: Qual Escolher?.
Quando usar cada ferramenta?
- n8n: Automações críticas, dados sensíveis, orçamento limitado.
- Zapier: Integrações rápidas com apps populares (Slack, Google Sheets, etc.).
- Make: Fluxos complexos com múltiplos cenários e lógica avançada.
Curiosidade: o n8n é a única das três que permite editar nodes via código (usando o node "Function").
Perguntas frequentes sobre n8n guia completo em português
O que é o n8n?
O n8n é uma plataforma de automação de código aberto que permite criar fluxos de trabalho entre APIs, bancos de dados e serviços sem necessidade de escrever código.
Como instalar o n8n?
Você pode instalar o n8n gratuitamente via npm (npm install n8n -g) ou usar Docker em uma VPS (docker run -d --name n8n -p 5678:5678 n8nio/n8n).
Qual é a diferença entre n8n e Zapier?
O n8n é auto‑hosted e de código aberto, oferecendo controle total dos dados, enquanto o Zapier é um serviço SaaS fechado, com interface mais simples, mas menos privacidade.
Como usar o n8n para automatizar processos?
Crie workflows arrastando nodes como Webhook, HTTP Request e Function, configure as conexões entre eles e ative o fluxo para que ele seja disparado automaticamente.
Quais são os erros comuns no n8n e como resolvê-los?
Erros frequentes incluem timeout de execução, credenciais inválidas e storage cheio; a solução costuma ser ajustar o timeout, renovar tokens ou limpar o volume Docker.
Como configurar o webhook no n8n?
Adicione um node “Webhook”, defina o método e caminho, salve o workflow e copie a URL gerada; então configure a fonte externa para enviar requisições a essa URL.
Qual é a melhor forma de aprender o n8n?
Comece pelos tutoriais oficiais, pratique criando pequenos workflows, explore a documentação de nodes e participe da comunidade GitHub para trocar experiências.
Domine a Automação com n8n e Transforme Seu Negócio
Agora você conhece tudo: instalação, configuração de webhooks, uso do node HTTP Request, resolução de erros comuns e a comparação entre n8n, Zapier e Make. Com esse conhecimento, pode criar fluxos poderosos e adaptar a ferramenta às suas necessidades.
- Instale o n8n de graça ou via Docker.
- Configure webhooks para disparar workflows.
- Use o node HTTP Request para integrar APIs.
- Resolva erros típicos rapidamente.
- Escolha a melhor ferramenta de automação para seu caso.
Explore mais artigos na nossa categoria n8n e continue aprimorando suas habilidades de automação.
Quer mais sobre o assunto? Veja todos os artigos de n8n ou a lista completa de artigos.