Como usar o n8n: tutorial para iniciantes em 7 passos (2026)

Como usar o n8n: cinco palavras para saber antes

A maior parte da confusão de quem começa no n8n vem de cinco termos:

Os dados passam entre os nós como itens. Cada envio do formulário é um item com campos como name e email, e cada nó consegue ler os campos dos nós que vêm antes dele.

O que você precisa para este tutorial n8n

• Uma conta no n8n. O teste grátis do n8n Cloud dá 14 dias de recursos do plano Pro, e a página de preços do n8n diz que o teste do Cloud não exige cartão de crédito.
• Uma conta do Google com Gmail e Google Sheets.
• Uma planilha nova no Google Sheets chamada "Website leads", com estes quatro cabeçalhos na linha 1: Date, Name, Email, Message.
• Cerca de 30 minutos. Você pode parar depois de qualquer passo; o n8n salva o seu trabalho automaticamente.

Todos os nomes de configuração abaixo vêm de montar exatamente este workflow no n8n 2.44.4 em outubro de 2026, então eles batem com o editor que você vai ver.

n8n Cloud ou self-hosted: qual usar neste tutorial

O n8n também roda de graça no seu computador ou no seu servidor, mas para um primeiro workflow a nuvem é mais fácil:

O n8n roda localmente?

Sim. O método de instalação atual do n8n é um script de uma linha que monta tudo no Docker, uma ferramenta que roda programas num pacote isolado. Instale o Docker Desktop, abra o programa e, no Mac ou no Linux, abra o Terminal e rode:

$ curl -fsSL https://get.n8n.io | sh
$ 

Depois abra http://localhost:5678. No Windows, o PowerShell e o Prompt de Comando não rodam esse script: rode dentro do WSL (Subsistema do Windows para Linux) com a integração WSL 2 do Docker Desktop ativada. O atalho antigo npx n8n, que aparece em muitos vídeos, para de funcionar no n8n 3.0, segundo a documentação da instalação de uma linha do n8n.

A primeira tela pede para você criar uma conta de proprietário. É o login de administrador da sua própria cópia do n8n, guardado no banco de dados dessa cópia.

Passo 1: crie o seu primeiro workflow

1. Entre no n8n. Você cai na página Overview.
2. Selecione o botão de criar no canto superior direito e escolha um novo workflow. Uma tela vazia abre.
3. Renomeie o workflow selecionando o nome no topo. Chame de "Website leads".

Você nunca precisa salvar à mão. O n8n salva cada mudança em poucos segundos, e nada vai ao ar até você publicar.

Passo 2: adicione o n8n Form Trigger

1. Selecione Add first step, pesquise "form" e escolha o gatilho n8n Form. O n8n o adiciona como um nó chamado "On form submission".
2. Authentication: deixe em None. Basic Auth ou n8n User Auth fariam os visitantes fazerem login antes de ver o formulário.
3. Form Title: digite "Get a quote". Ele aparece como o título do seu formulário. Acrescente uma Form Description de uma linha abaixo, se quiser.
4. Form Elements: adicione três, cada um com um Field Label, um Field Name e um Element Type. Name (name, Text, Required Field ativado), Email (email, Email, Required Field ativado) e Message (message, Textarea).
5. Respond When: escolha Form Is Submitted, para que os visitantes vejam um agradecimento na hora, em vez de esperar o Sheets e o Gmail.
6. Options: adicione Form Path e digite get-a-quote para ter um endereço legível, adicione Ignore Bots e ative, depois adicione Append n8n Attribution e desative.
7. Renomeie o nó para "Lead form", selecionando o nome dele no topo do painel. Você vai se referir a ele pelo nome no Passo 5.

Passo 3: mande um lead de teste para você mesmo

Selecione Execute workflow na tela (ou Execute step dentro do nó Lead form). O n8n começa a escutar e abre o formulário na Test URL; preencha com os seus próprios dados e envie.

De volta ao editor, abra o nó Lead form. A saída mostra o seu name, email e message, mais dois campos que o n8n adiciona para você: submittedAt, a data e a hora do envio, e formMode, que diz test aqui e production quando visitantes reais usarem o formulário.

Passo 4: salve o lead com o nó Google Sheets do n8n

1. Selecione o + depois do Lead form, pesquise "Google Sheets" e escolha Append row in sheet.
2. Conecte a sua conta: crie uma nova credencial e selecione Sign in with Google.
3. Escolha o arquivo: selecione "Website leads" em Document e a primeira aba em Sheet.
4. Mapeie as colunas: em Mapping Column Mode, escolha Map Each Column Manually e depois arraste submittedAt, name, email e message do painel de entrada, à esquerda, para Date, Name, Email e Message.
5. Selecione Execute step e confira a sua planilha. Uma linha nova deve aparecer.

Passo 5: mande o e-mail de agradecimento pelo Gmail

1. Selecione o + depois do nó Google Sheets, pesquise "Gmail" e escolha Send a message.
2. Conecte a sua conta com o Sign in with Google, como antes.
3. To: o endereço do lead. Como agora o nó anterior é o Google Sheets, aponte para o nó do formulário pelo nome: {{ $('Lead form').item.json.email }}. Se você digitar em vez de arrastar, coloque o campo no modo Expression antes.
4. Subject e Message: em Email Type, escolha Text, cole a primeira linha abaixo em Subject e o resto em Message, depois troque os detalhes.
5. Options: adicione Append n8n attribution e desative. Adicione BCC com o seu próprio endereço se quiser uma cópia de cada e-mail, e Sender Name para o lead ver o nome da sua empresa.

Thanks {{ $('Lead form').item.json.name }}, we got your message

Hi {{ $('Lead form').item.json.name }},

Thanks for getting in touch. We read every message and will reply within one working day.

[YOUR NAME]

Como funcionam as expressões no n8n

Uma expressão é qualquer coisa dentro de {{ }}. Quando você arrasta um campo, o n8n escreve uma para você, como {{ $json.email }}. $json sempre quer dizer "o nó imediatamente anterior a este", e é por isso que ele deixa de encontrar o e-mail quando o Google Sheets fica no meio.

$('Lead form') nomeia o nó de onde ler, então continua funcionando não importa quantas etapas você acrescente depois. É também por isso que o Passo 2 mandou você renomear o nó: se renomear de novo, atualize as expressões também.

Passo 6: teste o workflow inteiro

1. Selecione Execute workflow de novo e envie o formulário com um segundo lead de teste, usando um endereço de e-mail que você consiga conferir.
2. Confira a planilha: uma linha nova com as quatro colunas preenchidas.
3. Confira aquela caixa de entrada: o e-mail de agradecimento, com o primeiro nome certo no assunto.

Se alguma coisa estiver faltando, abra cada nó na tela. A etapa com um aviso vermelho mostra o erro, e o painel de saída mostra exatamente quais dados ela recebeu.

Passo 7: publique o workflow e compartilhe o formulário

Publicar diz ao n8n para manter o gatilho escutando sozinho, o tempo todo, sem nenhum editor aberto.

1. Copie a Production URL: abra o Lead form e mude a visualização da URL, no topo do nó, de Test URL para Production URL.
2. Selecione Publish no cabeçalho da tela, ou aperte Shift + P, e confirme com Publish na janela que abre. Para tirar o formulário do ar depois, abra a seta ao lado de Publish e escolha despublicar.
3. Abra a Production URL numa janela anônima do navegador para ver exatamente o que os visitantes recebem.
4. Compartilhe: coloque o link atrás de um botão "Peça um orçamento" no seu site ou na bio das suas redes sociais.

localhost:5679/form/get-a-quote

Os envios reais não aparecem na tela. Você encontra cada um na aba Executions do workflow, e as suas edições ficam como rascunho até você publicar de novo.

Você também pode preencher campos de antemão acrescentando-os ao link, por exemplo ?email= seguido do endereço; isso só funciona na Production URL, como observa a documentação do n8n Form Trigger.

Receba um e-mail quando uma execução no ar falhar

Com o formulário no ar, ninguém fica olhando a tela, então uma conexão quebrada com o Gmail poderia perder leads por dias. Crie um segundo workflow que comece com o nó Error Trigger, adicione um nó Send a message do Gmail que mande para você o nome do workflow que falhou e o erro, e salve. Depois abra as Settings do workflow Website leads e escolha esse segundo workflow em Error workflow. Ele só dispara em execuções publicadas, não em testes, e workflows de erro não contam nas suas execuções (documentação do Error Trigger).

Test URL vs Production URL no n8n

Quase toda pergunta do tipo "o meu formulário do n8n não funciona" se resolve com esta tabela:

A regra de contagem vem da documentação sobre execuções do n8n: execuções iniciadas pelo editor enquanto você monta são grátis, e execuções publicadas contam. Este workflow usa uma execução por lead, então as 1.000 execuções do teste grátis cobrem 1.000 envios reais, e o nosso guia de preços do n8n mostra qual plano pago combina com o seu volume.

Dentro do nó, você alterna entre os dois endereços com a chave no topo:

Opcional: deixe o n8n Assistant construir para você

O n8n Cloud inclui o n8n Assistant, um ajudante de IA em versão prévia que cria e edita workflows a partir de uma descrição. Ele funciona com uma cota mensal de créditos do Assistant, e o teste grátis inclui alguns. Depois de construir este workflow com as próprias mãos, experimente descrever o próximo:

Crie um workflow que comece com um gatilho n8n Form com o título "[TÍTULO DO FORMULÁRIO]" e três campos obrigatórios: name (text), email (email) e message (textarea).
Adicione cada envio como uma nova linha na planilha do Google "[NOME DA PLANILHA]", com as colunas Date, Name, Email e Message.
Depois mande para a pessoa um e-mail de agradecimento pelo Gmail que use o primeiro nome dela e diga que vamos responder em até [PRAZO].
Desative a atribuição do n8n no formulário e no e-mail.

Confira cada nó que ele criar antes de publicar, exatamente como você fez à mão.

O formulário do n8n não funciona? Problemas comuns e soluções

Duas mensagens causam a maior parte da confusão de quem começa, e as duas têm a ver com qual URL você abriu. É isto que o n8n mostra quando você abre a Test URL sem selecionar Execute workflow antes:

localhost:5679/form-test/get-a-quote

E é isto que os visitantes recebem na Production URL de um workflow que ainda não foi publicado:

localhost:5679/form/get-a-quote

Antes de compartilhar o link

Quando isso estiver rodando, o upgrade natural é uma etapa de IA que rascunha uma resposta personalizada para você aprovar, assunto do nosso tutorial de agente de IA no n8n. Se você ainda está decidindo o que automatizar em seguida, o guia de automação com IA para pequenas empresas ajuda a ordenar as suas próximas três tarefas pelo tempo economizado.

O que fazer agora

Publique este workflow hoje e mande um envio real para você mesmo pelo celular. Depois acrescente uma melhoria de cada vez, como uma resposta que você aprova antes de ser enviada ou um follow-up depois de três dias, e teste depois de cada mudança.

Se você gostaria de um caminho guiado por automações de leads e de e-mail como esta, o nosso curso de automação com IA está em acesso antecipado, e a nossa seleção dos melhores cursos de automação com IA compara opções gratuitas, como a n8n Academy. Se ainda está escolhendo uma ferramenta, leia n8n vs Zapier vs Make e, para ver o quadro maior, o nosso explicativo sobre o que é automação com IA tem 12 exemplos por departamento. Para continuar aprendendo com estrutura, o nosso guia dos melhores cursos de n8n começa pelos quatro cursos gratuitos da n8n Academy.