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.

Fluxo de automação conectando aplicativos em uma tela de computador

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)
Slide 1: um fluxo simples com quatro etapas já resolve um problema real.

Passo 1: crie um novo workflow

  1. Acesse o n8n (na nuvem ou na sua instalação) e entre na sua conta.
  2. Clique em criar um novo workflow. Abre-se o editor em canvas.
  3. 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.

  1. Clique em “Adicionar primeiro passo” e escolha o gatilho Webhook.
  2. Defina o método (normalmente POST) e um caminho para a URL.
  3. Copie a URL de teste gerada pelo n8n.
  4. Configure o formulário para enviar os dados para essa URL ou use uma ferramenta de testes para simular um envio.
  5. 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.

Exemplo de dados recebidos (JSON)
{
  "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.

Comece com nós visuais e use o código só quando necessário.
NecessidadeNó útilExemplo
Criar ou renomear camposEdit Fields (Set)Juntar nome e sobrenome em um só campo
Filtrar ou desviar o fluxoIF / SwitchSó prosseguir se o e-mail estiver preenchido
Juntar dados de fontes diferentesMergeCombinar dados de formulário e de cadastro
Esperar um tempoWaitEnviar o lembrete depois de um intervalo
Lógica personalizadaCodeFormatar 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.

  1. Adicione o nó da planilha e escolha a operação “Adicionar linha”.
  2. Crie a credencial: siga o assistente para autorizar o acesso à sua conta.
  3. Selecione o arquivo e a aba onde os dados serão gravados.
  4. Mapeie os campos: relacione cada coluna da planilha com o campo correspondente do fluxo.
  5. 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.

Exemplo de expressão
{{ $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

  1. Teste o fluxo inteiro com um envio novo e verifique cada nó.
  2. Corrija os problemas: campos vazios, formatos errados, credenciais expiradas.
  3. Ative o workflow (alternando o botão de ativação) para que ele rode sozinho, usando a URL de produção do webhook.
  4. Atualize o formulário para usar a URL de produção.
  5. Acompanhe o histórico de execuções: confira quais rodaram com sucesso e quais falharam.

Erros comuns de quem está começando

A aba de execuções mostra exatamente onde e por que o fluxo falhou.
ErroCausa provávelComo resolver
O fluxo não disparaURL de teste usada em produção, ou workflow inativoUsar a URL de produção e ativar o workflow
Campo vazio na planilhaMapeamento incorreto ou dados diferentes do esperadoConferir a saída do nó anterior e ajustar a expressão
Erro de autorizaçãoCredencial expirada ou sem permissãoReautorizar a credencial
Fluxo roda duas vezesGatilho duplicado ou formulário reenviandoRevisar os gatilhos e evitar envios duplicados
Falha silenciosaSem tratamento de erroConfigurar 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.

Cada variação ensina um recurso novo: gatilhos diferentes, tratamento de dados e uso de IA.
VariaçãoGatilhoAção
Alerta por e-mailNova linha em uma planilhaEnviar e-mail com os dados
Resumo diárioAgendamento (todos os dias, às 8h)Compilar dados e enviar uma mensagem
Cadastro de contatosFormulário preenchidoSalvar em planilha e enviar boas-vindas
MonitoramentoVerificação periódica de um serviçoAvisar quando algo sair do esperado
Classificação com IAMensagem recebidaClassificar 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.

  1. Execute o fluxo passo a passo e observe a saída de cada nó.
  2. Confira os dados de entrada: o campo esperado existe? O nome está correto?
  3. Verifique as credenciais: conexões expiradas ou sem permissão são causas comuns.
  4. Leia a mensagem de erro com atenção: ela costuma indicar o nó e a causa.
  5. Simplifique: desative etapas e teste uma parte de cada vez.
  6. 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.

Equipe Tetra

Conteúdo produzido pela equipe de educação da Tetra, que ensina dados, inteligência artificial, gestão, comunicação e inglês para o mercado de trabalho. Revisado em .