n8n: Tutorial Completo de Automação com IA [2026]

O n8n é uma das ferramentas de automação de workflows que testamos na Marfin para ligar sistemas que não conversam entre si. Em vez de programar uma integração do zero toda vez que um app precisa falar com outro, você desenha o fluxo numa tela visual, conecta os nós, e deixa rodar. O que diferencia o n8n da maioria das plataformas de automação é que ele é open source, roda na sua própria máquina ou servidor, e tem suporte nativo a IA e agentes. Você consegue plugar o Claude ou o GPT dentro de um workflow e fazer o modelo tomar decisões no meio do processo, não só executar passos fixos.

A gente foi testar o n8n quando percebeu o custo de ferramentas fechadas escalando junto com o volume. Cada nova automação no Zapier ou no Make significava mais uma assinatura mensal amarrada ao número de tarefas. Com o n8n self-hosted, a conta para de subir conforme o uso cresce, e ainda dá para versionar tudo no Git como código. Hoje usamos a ferramenta em alguns casos pontuais, e o que aprendemos nos testes virou este guia. Ele cobre o que é o n8n, como ele funciona por dentro, como instalar nas duas modalidades, como montar seu primeiro workflow do zero, e como usar os nós de IA para construir automações que pensam, não só repetem.

Se você já trabalha com automação de marketing com IA, vai reconhecer muita coisa aqui. A diferença é que o n8n te dá controle total sobre a lógica, sem depender do roadmap de uma empresa terceira para liberar a integração que você precisa.

O que é o n8n e por que ele é diferente

O n8n é uma plataforma de automação de workflows baseada em nós, criada na Alemanha por Jan Oberhauser. O nome se pronuncia "n-eight-n", uma brincadeira com "nodemation", automação por nós. A ideia central é simples: cada tarefa que você quer automatizar vira um nó na tela, e você conecta esses nós em sequência para formar um fluxo de dados. Um nó busca contatos de uma planilha, o próximo filtra quem abriu o último email, o seguinte dispara uma mensagem personalizada, e por aí vai.

A grande sacada do n8n está no modelo de licenciamento e na arquitetura. Ele é fair-code, distribuído sob a Sustainable Use License, o que na prática significa que você pode rodar a versão community de graça, modificar o código, e hospedar onde quiser. Diferente do Zapier e do Make, que são produtos fechados e cobram por tarefa executada, o n8n self-hosted não tem teto de execuções nem cobrança por volume. Você paga pela infraestrutura, que para a maioria dos casos cabe num servidor barato.

Outra diferença importante é o nível de controle. O n8n não esconde a lógica atrás de uma interface simplificada demais. Quando o fluxo visual não dá conta, você abre um nó de código e escreve JavaScript ou Python direto ali, manipulando os dados como quiser. Isso coloca o n8n num meio-termo raro entre as ferramentas no-code puras e escrever uma integração inteira na mão. Para quem está começando no vibe coding para marketing, é um ótimo ponto de entrada, porque você aprende a pensar em fluxos de dados sem precisar dominar uma linguagem inteira primeiro.

O catálogo de integrações passa de 400 nós nativos cobrindo as ferramentas mais usadas: Google Sheets, Slack, Notion, GitHub, Postgres, HubSpot, WhatsApp, Stripe, e os principais provedores de IA. Quando o nó nativo não existe, o nó HTTP Request resolve, porque ele fala com qualquer API REST do mundo. Nos testes, a gente não esbarrou numa integração que o n8n não desse conta.

Como o n8n funciona por dentro

Entender três conceitos resolve oitenta por cento do uso do n8n: nós, conexões e dados. O nó é a unidade de trabalho, cada um executa uma ação específica. As conexões são as linhas que ligam um nó ao outro e definem a ordem de execução. Os dados são os itens que fluem pelas conexões, normalmente em formato JSON, sendo transformados a cada parada.

Todo workflow começa com um nó de gatilho, o trigger. Ele decide quando o fluxo roda. O trigger pode ser um agendamento via cron, rodando todo dia às nove da manhã, por exemplo. Pode ser um webhook, que dispara o fluxo no instante em que recebe uma requisição HTTP, perfeito para reagir a eventos de outros sistemas. Pode ser um gatilho de app, que escuta um evento específico como "novo lead no formulário" ou "nova linha na planilha". E pode ser manual, para quando você está testando.

Depois do gatilho vêm os nós de ação e de lógica. Os nós de ação fazem o trabalho concreto: criar um registro, enviar uma mensagem, chamar uma API. Os nós de lógica controlam o caminho dos dados. O nó IF separa o fluxo em dois caminhos conforme uma condição. O nó Switch faz o mesmo com múltiplos caminhos. O nó Merge junta dados de ramos diferentes. O nó Loop processa uma lista item por item.

O que confunde quem vem do Zapier é o conceito de itens. No n8n, os dados trafegam como uma lista de itens, e cada nó processa todos os itens de uma vez por padrão. Se o nó anterior trouxe cinquenta contatos, o nó seguinte roda cinquenta vezes, uma para cada contato, sem você precisar montar um loop explícito. Esse comportamento economiza muito trabalho quando você sacou a lógica, e é uma das razões pelas quais o n8n escala bem para volumes grandes.

Quando o fluxo visual não basta, o nó Code entra em cena. Você escreve JavaScript ou Python para transformar dados, fazer cálculos, montar payloads complexos, ou implementar qualquer lógica que não tem um nó pronto. É a válvula de escape que mantém o n8n poderoso sem virar uma bagunça de cinquenta nós para uma tarefa simples.

n8n vs Zapier vs Make: qual escolher

A pergunta que mais recebemos é qual ferramenta de automação escolher. A resposta honesta depende de quem vai operar e de quanto a operação vai crescer.

O Zapier é o mais simples de todos e o melhor para quem nunca automatizou nada na vida. A interface é linear, quase à prova de erro, e o catálogo de apps é o maior do mercado. O problema é o preço. O Zapier cobra por tarefa executada, e a conta cresce rápido quando você passa de algumas automações simples para fluxos com muitos passos rodando o dia todo. Para um time pequeno com poucos fluxos, ainda compensa. Para uma operação que automatiza de verdade, vira um buraco no orçamento.

O Make, antigo Integromat, fica no meio. Ele tem um editor visual mais parecido com o do n8n, mostra os dados fluindo entre os módulos, e é mais barato que o Zapier no mesmo volume. É uma boa escolha para quem quer visual sem se preocupar com servidor. A limitação é a mesma do Zapier: é um produto fechado, você depende das integrações que eles oferecem, e o modelo de cobrança por operação continua amarrado ao volume.

O n8n ganha em três frentes: custo em escala, controle e privacidade. Self-hosted, ele roda sem limite de execuções, então o custo não acompanha o crescimento do uso. Você tem acesso ao código de cada nó e pode escrever o seu, o que elimina a dependência de roadmap de terceiros. E como os dados rodam na sua infraestrutura, informação sensível nunca sai do seu ambiente, o que pesa muito para empresas com exigências de compliance. A contrapartida é que o n8n pede um pouco mais de mão de obra técnica para subir e manter, principalmente na versão self-hosted. Quem quer o n8n sem cuidar de servidor usa o n8n Cloud, que entrega a mesma ferramenta hospedada por eles.

O critério que faz sentido é direto. Automação simples e pontual, que um não técnico vai montar sozinho, pode começar no Zapier. Automação que vira parte da operação, roda em volume, ou lida com dado sensível, é onde o n8n compensa.

Como instalar o n8n

Existem dois caminhos para começar com o n8n, e a escolha entre eles define boa parte da sua experiência.

n8n Cloud

O n8n Cloud é a versão hospedada pela própria empresa. Você cria uma conta, escolhe um plano, e em minutos tem um ambiente rodando sem tocar em servidor. É o caminho recomendado para quem quer focar em construir workflows e não em infraestrutura. Os updates são automáticos, os backups ficam por conta deles, e a disponibilidade é gerenciada. A desvantagem é o custo recorrente e a cobrança por execuções, que aproxima o n8n Cloud do modelo do Make em termos de previsibilidade de gasto.

Para times de marketing que querem resultado rápido e não têm alguém de tecnologia dedicado, o n8n Cloud costuma ser a melhor porta de entrada. Você testa a ferramenta, valida que ela resolve o seu problema, e só depois decide se vale a pena migrar para self-hosted para cortar custo.

Self-hosted com Docker

A versão self-hosted é onde o n8n brilha. A forma mais limpa de subir é com Docker. Com o Docker instalado, um único comando coloca o n8n no ar localmente. Você roda o container apontando para um volume persistente, onde ficam guardados seus workflows e credenciais, acessa pelo navegador no endereço local, e está pronto para construir.

Para produção, o caminho é subir o n8n num servidor barato na nuvem, colocar um domínio na frente com HTTPS, e configurar um banco Postgres externo para guardar os dados em vez do SQLite padrão. Esse setup aguenta volume sério e custa uma fração do que custaria no Zapier para o mesmo número de execuções. Se você já usa Supabase como backend nos seus projetos, dá para apontar o n8n para o mesmo Postgres e centralizar tudo.

A manutenção do self-hosted pede atenção a algumas coisas: atualizar a versão quando sai release nova, fazer backup do banco e das credenciais, e proteger o acesso ao painel com autenticação forte, porque quem entra no n8n entra em todas as suas integrações conectadas. Nada disso é complicado, mas é trabalho que no Cloud você não tem. Vale a conta quando o volume justifica.

Como criar seu primeiro workflow no n8n

Vamos montar um fluxo prático de exemplo: capturar leads de um formulário, qualificar com IA, e mandar para o Slack do time comercial. É um caso que mostra gatilho, transformação de dados, IA e ação, tudo num fluxo só.

O primeiro nó é o gatilho. Use um nó Webhook, que gera uma URL única. Quando o formulário do site envia os dados para essa URL, o fluxo dispara. O n8n recebe o payload com nome, email e a mensagem do lead, e disponibiliza esses campos para os nós seguintes.

O segundo passo é limpar e organizar os dados. Um nó Set ou Edit Fields pega o payload bruto do webhook e monta um objeto limpo, só com os campos que interessam, nos nomes que a gente quer usar adiante. Esse passo evita arrastar lixo pelo fluxo inteiro e deixa tudo mais legível quando você volta no workflow meses depois.

O terceiro passo é a qualificação por IA, e é aqui que o n8n se diferencia. A gente adiciona um nó de modelo de IA, conecta a credencial do Claude, e escreve um prompt pedindo para o modelo classificar o lead como quente, morno ou frio com base na mensagem que a pessoa deixou. O modelo lê o texto, entende a intenção, e devolve a classificação junto com uma justificativa curta. Isso é algo que nenhuma regra fixa de IF conseguiria fazer com a mesma qualidade, porque depende de interpretar linguagem natural.

O quarto passo usa um nó IF para separar os leads quentes do resto. Os quentes seguem por um caminho que dispara uma notificação imediata no Slack do comercial, com o nome, o contato e o motivo da classificação. Os mornos e frios vão para outro caminho, que apenas registra o lead numa planilha ou no CRM para follow-up posterior. O fluxo inteiro roda em segundos a cada novo lead, sem ninguém precisar olhar.

Depois de montar, você testa rodando o workflow manualmente com dados de exemplo, confere que cada nó produziu o que devia, e só então ativa o fluxo para rodar em produção. O n8n mostra os dados saindo de cada nó na própria tela, o que torna a depuração muito mais rápida do que ficar lendo logs.

n8n com IA: nós de modelo e agentes autônomos

O suporte a IA é o que transformou o n8n de uma boa ferramenta de automação numa plataforma para construir agentes de IA sem escrever um backend inteiro. Existem três níveis de uso de IA dentro do n8n, e vale entender a diferença.

O nível mais básico é o nó de modelo de linguagem. Você conecta um provedor, Claude, OpenAI, Gemini ou outro, passa um prompt, e recebe a resposta para usar no resto do fluxo. É o caso do exemplo de qualificação de lead que montamos acima. O modelo entra como mais um passo, fazendo uma tarefa de interpretação ou geração de texto no meio do processo.

O segundo nível é o AI Agent. Aqui o modelo deixa de ser um passo fixo e ganha autonomia para decidir o que fazer. Você dá ao agente um objetivo e um conjunto de ferramentas, que no n8n são outros nós ou workflows, e o modelo escolhe quais ferramentas chamar e em que ordem para cumprir a tarefa. Um agente de atendimento, por exemplo, pode decidir sozinho se busca o pedido no banco, se consulta o status de entrega numa API, ou se escala para um humano, dependendo da pergunta do cliente. Esse padrão se aproxima do que a gente faz com o Claude Code no terminal, onde o modelo planeja e executa em vez de só responder.

O terceiro nível envolve memória e bases de conhecimento. O n8n integra com vector stores, o que permite construir fluxos de RAG, onde o modelo busca informação relevante numa base de documentos antes de responder. Você indexa seus manuais, suas políticas ou sua documentação num banco vetorial, e o agente consulta esse material para dar respostas fundamentadas no seu conteúdo, em vez de inventar. É o caminho prático para colocar IA generativa para negócios rodando em cima do conhecimento da própria empresa.

A vantagem de construir agentes no n8n em vez de programar do zero é que você ganha toda a infraestrutura de integração de graça. O agente precisa mandar email, consultar um banco, postar no Slack? Já tem nó para isso. Você foca na lógica do agente e deixa as conexões para a ferramenta.

Casos de uso de automação com IA no marketing

Dá para usar o n8n para tirar trabalho repetitivo das costas do time. Vale comentar os fluxos que mais geram retorno nos casos que testamos, porque eles servem de inspiração para o que você pode montar.

A qualificação automática de leads é o primeiro e o que dá retorno mais rápido. Todo lead que entra é lido por um modelo, classificado por intenção e prioridade, e roteado para o caminho certo, sem ninguém peneirar formulário na mão. O time comercial só vê o que importa.

A curadoria e o resumo de conteúdo vêm logo atrás. Dá para montar fluxos que monitoram fontes, puxam artigos novos, pedem para a IA resumir, e entregam um digest pronto. É o tipo de rotina de curadoria que casa bem com as ferramentas de IA para marketing digital, orquestrada no n8n.

A personalização de mensagens em escala é outro caso forte. Em vez de mandar o mesmo email para a base inteira, o fluxo pega o contexto de cada contato, pede para o modelo adaptar o texto, e dispara a versão personalizada. O ganho de resposta compensa o custo de tokens com folga.

O enriquecimento de dados fecha a lista. Quando um novo contato entra no CRM com pouca informação, o fluxo busca dados públicos, organiza com IA, e preenche os campos que faltavam. O comercial recebe o lead já com contexto, em vez de uma linha vazia para investigar.

Preços e planos do n8n

O modelo de preços do n8n divide-se entre a versão self-hosted e o n8n Cloud, e entender a diferença evita susto na fatura.

A versão community self-hosted é gratuita e sem limite de execuções. Você só paga pela infraestrutura onde ela roda, que para a maioria dos casos é um servidor de poucas dezenas de reais por mês. É a melhor relação custo-benefício para quem tem mão técnica e roda volume.

O n8n Cloud trabalha com planos baseados no número de execuções de workflow por mês, mais o número de workflows ativos. O plano de entrada gira em torno de vinte euros mensais para alguns milhares de execuções, e sobe conforme você precisa de mais volume, mais workflows ativos e recursos avançados como execução concorrente. Os planos superiores liberam histórico de execução mais longo, ambientes separados e suporte prioritário. Vale confirmar os valores e limites atuais direto no site do n8n, porque a tabela é revisada com frequência.

Para uso corporativo, existe o plano Enterprise, com preço sob consulta, que adiciona controle de acesso por papel, SSO, ambientes de versionamento, e a opção de rodar self-hosted com suporte oficial e licença comercial. É o caminho para empresas grandes que querem o controle do self-hosted com a rede de segurança de um contrato.

A conta que fazemos é simples. Se a automação é leve e você não quer pensar em servidor, o Cloud no plano de entrada resolve por pouco. Se o volume cresce ou o dado é sensível, o self-hosted paga a infraestrutura e ainda sobra, principalmente comparado ao que o mesmo volume custaria no Zapier.

Sete dicas para tirar o máximo do n8n

1. Comece pelo gatilho certo. Errar o trigger faz o fluxo todo rodar na hora errada ou nem rodar. Use webhook para reagir a eventos em tempo real, schedule para tarefas periódicas, e gatilho de app quando a integração nativa existir. O resto do fluxo depende dessa escolha.

2. Limpe os dados logo no início. Coloque um nó Set ou Edit Fields logo depois do gatilho para deixar só os campos que importam, com nomes claros. Arrastar payload bruto pelo fluxo inteiro deixa tudo confuso e quebra fácil quando a fonte muda de formato.

3. Trate os erros de propósito. Configure um Error Workflow para ser avisado quando algo falha, em vez de descobrir que o fluxo parou dias depois. Uma automação silenciosa que quebrou sem aviso é pior do que não ter automação nenhuma.

4. Versione tudo no Git. Exporte seus workflows em JSON e guarde no repositório. Você ganha histórico, consegue reverter mudanças que quebraram algo, e documenta a evolução da sua operação como faria com qualquer código.

5. Use o nó Code com parcimônia. Ele é a válvula de escape, não a regra. Se um fluxo virou cinco nós de código, talvez ele devesse ser um script de verdade. Mantenha a lógica no visual sempre que der, porque é o que o n8n faz de melhor.

6. Proteja o acesso ao painel. O n8n guarda as credenciais de todas as suas integrações. Quem entra no painel entra em tudo. Use autenticação forte, restrinja o acesso por rede quando possível, e nunca exponha um n8n self-hosted na internet sem HTTPS e login.

7. Teste com dados reais antes de ativar. Rode o fluxo manualmente com um caso de verdade, confira a saída de cada nó na tela, e só ative depois de ver tudo funcionando ponta a ponta. O n8n mostra os dados fluindo, então use isso a seu favor para pegar erro antes da produção.

Por onde começar

O n8n recompensa quem investe as primeiras horas para entender o modelo de nós e itens. Depois que essa lógica entra na cabeça, montar automação vira rápido, e a sensação de poder ligar qualquer sistema a qualquer outro sem pedir para ninguém é difícil de largar. Para um time de marketing ou uma startup que quer escalar sem inchar o time, é uma das ferramentas de maior alavancagem que existem hoje.

A nossa recomendação é começar pequeno. Escolha uma tarefa chata que você faz na mão toda semana, monte o fluxo no n8n Cloud para não se preocupar com servidor, e veja a automação rodar sozinha. Quando você tiver cinco ou seis fluxos rodando e começar a sentir o limite de execuções, aí sim vale estudar a migração para self-hosted. Adicione um nó de IA no primeiro fluxo que envolver interpretar texto ou tomar decisão, e você vai entender na prática por que a gente acha que o n8n com IA é o caminho da automação para quem leva produtividade a sério.

Leia também:

TL;DR