Tutorial de n8n para iniciantes: seu primeiro workflow real

O n8n é uma ferramenta de automação de fluxos de trabalho em que você conecta blocos, chamados de nós (nodes), em uma tela: um gatilho (trigger) inicia o workflow, e cada nó depois dele faz um trabalho. Neste tutorial, você constrói um workflow real sem código: um formulário de contato que salva cada lead no Google Sheets e manda um e-mail de agradecimento para essa pessoa.

Aqui está o que você vai construir:

O que você precisa antes de começar

• 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 não é preciso cartão de crédito.
• Uma conta do Google com Gmail e Google Sheets.
• Uma planilha nova no Google Sheets chamada "Leads do site", com estes quatro cabeçalhos na linha 1: Data, Nome, E-mail, Mensagem.

Nuvem ou self-hosted: qual usar neste tutorial

O n8n também roda de graça no seu computador ou no seu servidor, o chamado self-hosted. Para um primeiro workflow, a nuvem é mais fácil, por dois motivos que você sente logo de cara:

No n8n Cloud, os nós do Google usam o login gerenciado, então você clica em um botão em vez de criar um projeto no Google Cloud. Instâncias self-hosted não têm esse atalho.

Se mesmo assim você quiser hospedar por conta própria, a instalação de uma linha do n8n precisa do Docker Desktop instalado e rodando. No Mac ou no Linux, abra o Terminal e rode:

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

Depois abra http://localhost:5678 no navegador. No Windows, o PowerShell não roda esse script: rode dentro do WSL (Subsistema do Windows para Linux) com a integração WSL 2 do Docker Desktop ativada.

Passo 1: crie o workflow

1. Entre no n8n e selecione Personal no menu da esquerda.
2. Selecione Create workflow no canto superior direito. A tela de edição abre.
3. Renomeie o workflow selecionando o nome no topo. Chame de "Leads do site".

Passo 2: adicione o gatilho de formulário

1. Selecione Add first step, pesquise "form" e escolha o gatilho n8n Form.
2. Form Title: digite "Peça um orçamento". Ele aparece como o título do seu formulário.
3. Form Elements: adicione três campos. Nome (tipo Text, nome do campo name, obrigatório), E-mail (tipo Email, nome do campo email, obrigatório) e Mensagem (tipo Textarea, nome do campo message).
4. Respond When: escolha Form Is Submitted, para que os visitantes vejam um agradecimento na hora.
5. Options: adicione Ignore Bots e ative, depois adicione Append n8n Attribution e desative.
6. Renomeie o nó para "Formulário de lead", selecionando o nome dele no canto superior esquerdo. Você vai se referir a ele pelo nome no Passo 5.

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

Selecione Execute workflow. O n8n abre o formulário na Test URL; preencha com os seus próprios dados e envie.

De volta ao editor, abra o nó Formulário de lead. A saída mostra o seu name, email e message, mais um registro de data e hora submittedAt que o n8n adiciona para você.

Passo 4: salve o lead no Google Sheets

1. Selecione o + depois do Formulário de lead, pesquise "Google Sheets" e escolha a ação Append Row.
2. Conecte a sua conta: crie uma nova credencial e selecione Sign in with Google.
3. Escolha o arquivo: selecione "Leads do site" 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 Data, Nome, E-mail e Mensagem.
5. Selecione Execute step e confira a sua planilha. Uma linha nova deve aparecer.

Quando você solta um campo, o n8n escreve uma expressão para você, como {{ $json.email }}. Uma expressão é um marcador que o n8n troca pelo valor real a cada execução.

Passo 5: mande um e-mail para o lead

1. Selecione o + depois do Google Sheets, pesquise "Gmail" e escolha a ação 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: {{ $('Formulário de lead').item.json.email }}. Se você digitar em vez de arrastar, coloque o campo no modo Expression antes.
4. Subject e Message: 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.

Obrigado, {{ $('Formulário de lead').item.json.name }}, recebemos a sua mensagem

Oi, {{ $('Formulário de lead').item.json.name }},

Obrigado pelo contato. Lemos todas as mensagens e respondemos em até um dia útil.

[SEU NOME]

Passo 6: teste o workflow inteiro

Selecione Execute workflow de novo e envie o formulário com um segundo lead de teste. Confira duas coisas: uma linha nova na planilha e o e-mail de agradecimento naquela caixa de entrada.

Se alguma delas 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 e compartilhe o formulário de produção

1. Copie a Production URL: abra o Formulário de lead 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), dê um nome à versão e confirme. A documentação sobre publicação explica os estados do botão.
3. Compartilhe: coloque o link de produção atrás de um botão "Peça um orçamento" no seu site ou na bio das suas redes sociais.

A partir de agora, cada envio real é uma execução em produção. As edições que você fizer depois ficam como rascunho até você publicar de novo.

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 monta workflows a partir de uma descrição, com uma cota mensal de créditos do Assistant. 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: nome (texto), e-mail (email) e mensagem (textarea).
Adicione cada envio como uma nova linha na planilha do Google "[NOME DA PLANILHA]", com as colunas Data, Nome, E-mail e Mensagem.
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.

Erros comuns e como corrigir

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 tutorial de agente de IA no n8n. Antes de escolher um plano pago, veja quanto o n8n custa de verdade no seu volume.

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.

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. Para ver primeiro como o n8n se compara às alternativas, leia n8n vs Zapier vs Make.