Como criar sua primeira automação no n8n: passo a passo para iniciantes
Tutorial para criar a primeira automação no n8n: planejar o fluxo, escolher o gatilho, conectar serviços, tratar dados, testar, ativar e corrigir erros comuns.

Resumo
Para criar a primeira automação no n8n, defina um processo simples, desenhe o fluxo (gatilho, tratamento e ação), crie um novo workflow, adicione o gatilho, conecte os serviços com credenciais, mapeie os dados com expressões, teste cada nó, ative o fluxo e acompanhe as execuções. Comece com algo simples, como registrar formulários em uma planilha e avisar por mensagem.
- Comece por um processo simples e bem definido.
- Todo fluxo tem gatilho, nós de tratamento e ações finais.
- Teste nó a nó, olhando os dados de entrada e de saída.
- Ative o fluxo e acompanhe o histórico de execuções para corrigir falhas.
A melhor forma de entender o n8n é construir algo com as próprias mãos. Neste tutorial, você vai criar uma automação clássica e útil: quando alguém preencher um formulário, os dados serão registrados em uma planilha e uma notificação será enviada para você. É um caso simples, mas ele ensina os fundamentos que aparecem em quase todas as automações: gatilho, tratamento de dados, conexão com serviços e ações. As telas e nomes de botões podem variar entre versões do n8n, mas a lógica é a mesma.
Antes de abrir a ferramenta: desenhe o fluxo
O erro mais comum de iniciantes é abrir o editor e começar a arrastar nós sem plano. Antes, responda em um papel:
- O que dispara o processo? (o gatilho)
- Quais dados chegam? (nome, e-mail, mensagem)
- O que precisa ser feito com eles? (registrar, filtrar, formatar)
- Qual o resultado final? (linha na planilha, mensagem enviada)
- E se algo der errado? (quem deve ser avisado)
Passo 1: crie um novo workflow
- Acesse o n8n (na nuvem ou na sua instalação) e entre na sua conta.
- Clique em criar um novo workflow. Abre-se o editor em canvas.
- Dê um nome claro, como “Formulário de contato para planilha”. Nomes descritivos facilitam a manutenção.
Passo 2: adicione o gatilho
O gatilho inicia o fluxo. Para o nosso caso, uma boa opção é o Webhook, que recebe dados de qualquer formulário capaz de enviar para um endereço (URL). Outras opções comuns: gatilhos de aplicativos específicos (como e-mail ou planilhas), de horário agendado ou de chamadas externas.
- Clique em “Adicionar primeiro passo” e escolha o gatilho Webhook.
- Defina o método (normalmente POST) e um caminho para a URL.
- Copie a URL de teste gerada pelo n8n.
- Configure o formulário para enviar os dados para essa URL ou use uma ferramenta de testes para simular um envio.
- Execute o nó e envie um exemplo, para que o n8n capture a estrutura dos dados recebidos.
Passo 3: entenda os dados que chegam
No n8n, os dados circulam como itens, geralmente em formato JSON (pares de campo e valor). Ao clicar em um nó executado, você vê a aba de entrada e a de saída, com o conteúdo que entrou e saiu. Reservar um tempo para entender esse formato é o que mais acelera o seu aprendizado.
{
"nome": "Maria Souza",
"email": "[email protected]",
"mensagem": "Gostaria de saber mais sobre o curso."
}Passo 4: trate e organize os dados
Nem sempre os dados chegam no formato ideal. Para organizá-los, use o nó Edit Fields (Set), que permite criar, renomear e formatar campos. Você também pode usar nós de condição (IF) para filtrar, por exemplo, apenas os contatos com e-mail válido.
| Necessidade | Nó útil | Exemplo |
|---|---|---|
| Criar ou renomear campos | Edit Fields (Set) | Juntar nome e sobrenome em um só campo |
| Filtrar ou desviar o fluxo | IF / Switch | Só prosseguir se o e-mail estiver preenchido |
| Juntar dados de fontes diferentes | Merge | Combinar dados de formulário e de cadastro |
| Esperar um tempo | Wait | Enviar o lembrete depois de um intervalo |
| Lógica personalizada | Code | Formatar texto ou calcular valores com JavaScript |
Passo 5: conecte a planilha e grave os dados
Agora vamos registrar o contato em uma planilha. Adicione um nó de planilhas (por exemplo, o do Google Sheets) e configure a credencial, que é a autorização para o n8n acessar a sua conta.
- Adicione o nó da planilha e escolha a operação “Adicionar linha”.
- Crie a credencial: siga o assistente para autorizar o acesso à sua conta.
- Selecione o arquivo e a aba onde os dados serão gravados.
- Mapeie os campos: relacione cada coluna da planilha com o campo correspondente do fluxo.
- Execute o nó e confira se a linha apareceu na planilha.
No mapeamento, o n8n permite usar expressões para inserir os valores dos nós anteriores. Elas aparecem entre chaves duplas e fazem referência aos campos recebidos.
{{ $json.nome }}Passo 6: envie uma notificação
Para fechar o fluxo, adicione um nó que avise você ou o time. Pode ser um e-mail, uma mensagem em um aplicativo de comunicação ou outro canal que você use. Monte a mensagem aproveitando as expressões para personalizar o texto.
- Assunto ou título: “Novo contato: {{ $json.nome }}”.
- Corpo: inclua e-mail e mensagem, para você agir sem abrir a planilha.
- Destinatários: você ou o time responsável.
- Cuidado: não inclua dados sensíveis em canais sem a devida proteção.
Passo 7: teste, ative e monitore
- Teste o fluxo inteiro com um envio novo e verifique cada nó.
- Corrija os problemas: campos vazios, formatos errados, credenciais expiradas.
- Ative o workflow (alternando o botão de ativação) para que ele rode sozinho, usando a URL de produção do webhook.
- Atualize o formulário para usar a URL de produção.
- Acompanhe o histórico de execuções: confira quais rodaram com sucesso e quais falharam.
Erros comuns de quem está começando
| Erro | Causa provável | Como resolver |
|---|---|---|
| O fluxo não dispara | URL de teste usada em produção, ou workflow inativo | Usar a URL de produção e ativar o workflow |
| Campo vazio na planilha | Mapeamento incorreto ou dados diferentes do esperado | Conferir a saída do nó anterior e ajustar a expressão |
| Erro de autorização | Credencial expirada ou sem permissão | Reautorizar a credencial |
| Fluxo roda duas vezes | Gatilho duplicado ou formulário reenviando | Revisar os gatilhos e evitar envios duplicados |
| Falha silenciosa | Sem tratamento de erro | Configurar um aviso de erro e verificar o histórico |
Variações da primeira automação para praticar
Depois de concluir o primeiro fluxo, repita o processo com variações. A prática com casos diferentes consolida o aprendizado.
| Variação | Gatilho | Ação |
|---|---|---|
| Alerta por e-mail | Nova linha em uma planilha | Enviar e-mail com os dados |
| Resumo diário | Agendamento (todos os dias, às 8h) | Compilar dados e enviar uma mensagem |
| Cadastro de contatos | Formulário preenchido | Salvar em planilha e enviar boas-vindas |
| Monitoramento | Verificação periódica de um serviço | Avisar quando algo sair do esperado |
| Classificação com IA | Mensagem recebida | Classificar o assunto e direcionar |
Como depurar quando algo não funciona
Erros fazem parte do aprendizado. O n8n permite inspecionar os dados de cada nó, e isso facilita encontrar onde está o problema.
- Execute o fluxo passo a passo e observe a saída de cada nó.
- Confira os dados de entrada: o campo esperado existe? O nome está correto?
- Verifique as credenciais: conexões expiradas ou sem permissão são causas comuns.
- Leia a mensagem de erro com atenção: ela costuma indicar o nó e a causa.
- Simplifique: desative etapas e teste uma parte de cada vez.
- Consulte a documentação e a comunidade com a descrição exata do problema.
Tratamento de erros e notificações de falha
Um fluxo útil precisa avisar quando falha. Sem isso, você pode descobrir o problema dias depois.
- Fluxo de erro: configure um fluxo separado que seja acionado quando outro falhar e envie um alerta.
- Tentativas automáticas: em nós que dependem de serviços externos, avalie repetir a chamada em caso de falha temporária.
- Mensagens claras: inclua nome do fluxo, horário e descrição do erro no aviso.
- Registro: mantenha o histórico de execuções para investigar problemas.
Organização e boas práticas à medida que os fluxos crescem
- Nomes descritivos para fluxos e nós.
- Notas nos nós explicando decisões importantes.
- Fluxos pequenos e reutilizáveis, em vez de um único fluxo gigante.
- Separação entre testes e produção.
- Cópias de segurança (exportação dos fluxos) antes de mudanças grandes.
- Credenciais organizadas e com permissões mínimas.
Quando estiver confortável, avance para como criar um agente de IA no n8n.
Boas práticas desde o primeiro fluxo
- Dê nomes claros aos nós e ao workflow.
- Comente e documente a lógica, principalmente em fluxos mais longos.
- Trate erros: configure notificações para falhas.
- Teste com dados reais e dados incomuns, como campos vazios.
- Respeite a LGPD: colete e guarde apenas os dados necessários.
- Evolua aos poucos: adicione filtros e etapas depois que o básico funcionar.
Para entender o que você acabou de usar, leia o que é n8n e veja os próximos passos em como criar um agente de IA no n8n. O curso recomendado abaixo leva você de automações simples a fluxos avançados, com projetos práticos.
Perguntas frequentes
Preciso saber programar para criar uma automação no n8n?
Não para fluxos simples. O editor visual resolve a maioria dos casos, e o uso de código é opcional para necessidades mais específicas.
O que é um webhook?
É um endereço (URL) que recebe dados enviados por outros sistemas. Quando um formulário, por exemplo, envia as informações para esse endereço, o n8n recebe os dados e inicia o fluxo.
Por que meu fluxo não dispara automaticamente?
Verifique se o workflow está ativo e se o sistema externo está usando a URL de produção do webhook (e não a de teste). Confira também o histórico de execuções.
Como evitar perder dados quando um fluxo falha?
Configure notificações de erro, acompanhe o histórico de execuções e considere guardar os dados recebidos em um registro antes de processá-los.
