# Como criar sua primeira automação no n8n: passo a passo para iniciantes

> 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.

- Publicado por: Equipe Tetra (Tetra Educação)
- Página: https://tetraeducacao.com.br/blog/como-criar-primeira-automacao-n8n
- Categoria: Automação
- Publicado em: 2026-09-10 · Atualizado em: 2026-09-10
- Tempo de leitura: 8 min

## Resumo

- 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)

**Ilustração: Slide 1: um fluxo simples com quatro etapas já resolve um problema real.**

1. Gatilho: novo envio de formulário
2. Tratar dados
3. Gravar na planilha
4. Avisar por mensagem

## 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.

> **Use dados de exemplo reais:** Ao testar, envie um registro completo, com todos os campos preenchidos. Assim, você enxerga como o n8n organiza as informações e consegue mapeá-las corretamente nos próximos passos.

## 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": "maria@exemplo.com",
  "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.:

| 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.

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 }}
```

> **Proteja suas credenciais:** Nunca compartilhe credenciais em prints, mensagens ou documentos. Use contas com as permissões mínimas necessárias e, para dados sensíveis, alinhe o uso com a área de TI.

## 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.:

| 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.

Cada variação ensina um recurso novo: gatilhos diferentes, tratamento de dados e uso de IA.:

| 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.

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.

> **Use dados de exemplo fixos:** Ao desenvolver, fixe uma execução de exemplo para testar os nós seguintes sem precisar disparar o gatilho toda vez. Isso acelera bastante o desenvolvimento.

## 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](https://tetraeducacao.com.br/blog/como-criar-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](https://tetraeducacao.com.br/blog/o-que-e-n8n) e veja os próximos passos em [como criar um agente de IA no n8n](https://tetraeducacao.com.br/blog/como-criar-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.

## Curso recomendado

[Curso de n8n](https://tetraeducacao.com.br/n8n): O Curso de n8n da Tetra Educação ensina a criar automações no-code/low-code, integrar aplicativos e APIs (Gmail, Google Sheets, Slack, Notion, webhooks) e construir agentes de IA, 100% online e com certificado.
