ResenhaSaaS

Automação

n8n

Automação de workflows fair-code com código e IA

4.6 Plano grátis disponível

Para criar seu primeiro workflow no n8n: escolha onde rodar (Cloud gerenciado ou self-hosted via Docker), adicione um nó de gatilho que dispara a automação, conecte um ou mais nós de ação, mapeie os dados de um nó para o outro com expressões, teste e ative. Este tutorial monta um fluxo real — capturar um novo lead e avisar o time — explicando cada etapa para quem nunca tocou na ferramenta.

Este tutorial monta, do zero, um workflow útil de verdade: capturar um novo lead e avisar o time automaticamente. É um fluxo que mostra os três pilares do n8n — gatilho, ação e mapeamento de dados — sem exigir que você saiba programar. Reserve 15 minutos.

Antes de começar: Cloud ou self-hosted?

Você precisa de uma instância do n8n rodando. Há dois caminhos:

  • n8n Cloud — roda no navegador, sem instalar nada. Crie a conta e o período de teste libera o editor na hora. É o caminho recomendado para o primeiro contato.
  • Self-hosted — você sobe o n8n no seu servidor com Docker ou npm. É gratuito e ilimitado, mas exige familiaridade com linha de comando. Vale quando você já decidiu adotar a ferramenta. Entenda o trade-off em preços e planos.

Para aprender, comece pelo Cloud — você troca para self-hosted depois sem perder o que aprendeu.

Passo 1 — Crie um workflow em branco

No painel, clique em New workflow. Você verá o canvas: a tela onde o fluxo é desenhado. Ele começa vazio, com um único marcador pedindo o primeiro passo — que é sempre um gatilho.

Passo 2 — Adicione o gatilho

O gatilho é o evento que dispara a automação. Clique no marcador e procure por Webhook — o gatilho mais versátil para começar, porque qualquer formulário ou sistema pode chamá-lo.

Ao adicionar o nó Webhook, o n8n gera uma URL única. Quando essa URL recebe uma requisição (por exemplo, do seu formulário de captura), o workflow roda. Clique em Listen for test event e dispare uma chamada de teste para a URL — o n8n captura os dados recebidos e os exibe. É com esses dados que os próximos nós vão trabalhar.

Outros gatilhos comuns para conhecer depois: Schedule (roda em horário agendado), gatilhos de apps (novo e-mail, nova linha numa planilha, nova mensagem) e o Manual Trigger (você aperta o botão para rodar).

Passo 3 — Filtre o que importa

Nem todo lead merece o mesmo tratamento. Adicione um nó IF logo após o Webhook. Nele, você define uma condição — por exemplo, deixar passar só quem preencheu um e-mail corporativo, ou só quem marcou interesse em um plano pago.

O nó IF cria dois caminhos: true (a condição bateu) e false (não bateu). Você conecta a próxima ação no caminho que interessa.

Passo 4 — Adicione a ação

Agora o fluxo faz algo com o lead. Conecte um nó de ação no caminho true. Dois exemplos práticos:

  • Google Sheets / CRM — registrar o lead numa planilha ou criar o contato no seu CRM.
  • Slack / WhatsApp / e-mail — avisar o time que um lead qualificado chegou.

Escolha o app, conecte sua conta (o n8n guia a autenticação) e selecione a operação — por exemplo, “enviar mensagem” ou “adicionar linha”.

Passo 5 — Mapeie os dados entre os nós

Esta é a parte que distingue o n8n e a que mais confunde no início. Você precisa dizer à ação quais dados usar — e esses dados vêm dos nós anteriores.

No campo da mensagem, em vez de digitar um texto fixo, você referencia o dado recebido com uma expressão. Para usar o e-mail capturado pelo Webhook, a expressão é algo como {{ $json.email }}. O n8n abre um painel lateral com todos os campos disponíveis dos nós anteriores — então, na prática, você arrasta o campo para o lugar certo em vez de decorar a sintaxe.

Uma mensagem montada ficaria assim: Novo lead: {{ $json.nome }} ({{ $json.email }}).

Passo 6 — Teste e ative

Clique em Execute workflow (ou Test workflow) para rodar o fluxo uma vez com os dados de teste. O n8n acende cada nó conforme executa e mostra o que entrou e o que saiu em cada etapa — é assim que você depura: clicando no nó e olhando os dados. Lembre que execuções de teste não consomem o seu limite do plano.

Funcionou? Ative o workflow no botão de toggle no topo. A partir daí, ele roda sozinho toda vez que o gatilho disparar.

Erros comuns de quem está começando

  • Esquecer de ativar o workflow. Em modo de edição ele só roda nos testes; o toggle precisa estar ligado para valer em produção.
  • Mapear o campo errado. Se a mensagem chega vazia ou com undefined, quase sempre a expressão aponta para um campo que não existe naquele nó. Confira o painel de dados.
  • Confundir os caminhos do IF. Conectar a ação no caminho false sem querer faz o fluxo “não fazer nada” justamente quando deveria agir.

Próximo passo

Com o primeiro fluxo de pé, o caminho natural é explorar a biblioteca de templates do n8n — centenas de workflows prontos que você adapta — e os nós de IA, onde está o uso que mais cresce na ferramenta. Para entender se o n8n é a escolha certa para a sua operação a longo prazo, veja o review completo; para dimensionar o custo conforme você escala, a análise de preços.

Começar com n8n

Parceria · pode gerar comissão, sem custo a mais · como funciona

Perguntas frequentes

Quanto tempo leva para aprender o n8n?

Um workflow simples sai em 15 a 30 minutos no primeiro contato. O que leva mais tempo é dominar as expressões e o mapeamento de dados entre nós — algo que vem com dois ou três fluxos montados. Quem já entende lógica básica de programação acelera bastante.

Preciso instalar algo para usar o n8n?

Não, se usar o n8n Cloud: ele roda no navegador, sem instalação. Se for self-hosted, você instala via Docker ou npm no seu servidor — o que exige um pouco de familiaridade com linha de comando.

O que é um nó (node) no n8n?

Cada nó é uma etapa do workflow: pode ser um gatilho (o que dispara o fluxo) ou uma ação (o que o fluxo faz). Você conecta nós em sequência para montar a automação, ligando a saída de um na entrada do próximo.

Como o n8n passa dados de um nó para o outro?

Por expressões, escritas entre chaves duplas. Por exemplo, para usar o e-mail recebido em um nó anterior, você referencia o campo com uma expressão que aponta para o JSON daquele nó. O n8n mostra os dados disponíveis em um painel lateral, então dá para arrastar o campo em vez de digitar.

Como criar meu primeiro workflow no n8n?

Abra um workflow em branco, adicione um nó de gatilho (o evento que dispara, como um Webhook ou um agendamento), conecte um ou mais nós de ação, mapeie os dados entre eles com expressões, rode o teste e ative. Um fluxo simples fica pronto em cerca de 15 minutos.

Como instalar o n8n com Docker?

No self-hosted, o caminho mais comum é rodar a imagem oficial do n8n em um contêiner Docker, apontando um volume para persistir os dados e definindo as variáveis de ambiente (como a URL pública e as credenciais). Exige familiaridade com linha de comando, mas é o método mais estável para manter a instância de pé.

Como conectar um app como o Google Sheets no n8n?

Adicione o nó do app desejado, clique para criar uma credencial e siga o fluxo de autenticação (geralmente OAuth ou chave de API). Depois de conectada uma vez, a credencial fica disponível para todos os workflows que usarem aquele app.

Como usar um webhook no n8n?

Adicione o nó Webhook como gatilho: o n8n gera uma URL única que, ao receber uma requisição, dispara o workflow. Use o modo de escuta para capturar um evento de teste e ver os dados que chegam; depois, construa as ações com base nesses dados.

Como agendar um workflow para rodar sozinho?

Use o nó de gatilho Schedule, que dispara o fluxo em intervalos ou horários definidos (a cada hora, todo dia às 8h, e assim por diante). Com o workflow ativado, ele roda automaticamente, sem nenhuma intervenção manual.

Como testar e depurar um workflow no n8n?

Rode o workflow no botão de execução: o n8n acende cada nó conforme processa e mostra o que entrou e o que saiu em cada etapa. Para depurar, clique no nó suspeito e inspecione os dados — execuções de teste não consomem o limite do plano.

Como adicionar IA a um workflow no n8n?

Adicione um dos nós de IA (modelo de chat, agente ou cadeia), conecte uma credencial do provedor de IA e ligue a entrada de dados de um nó anterior. A partir daí, o n8n envia o conteúdo ao modelo e usa a resposta nas etapas seguintes do fluxo.