komasu Tools
Português
English 日本語 Deutsch Français Español Italiano Nederlands Português 한국어 繁體中文

Tutorial do n8n (2026): crie o seu primeiro fluxo passo a passo

Por Equipa komasu · Atualizado · Factos verificados · 8 min de leitura

O komasu Tools é apoiado por leitores como você. Podemos receber uma comissão de afiliado quando compra através das nossas ligações, o que nos permite oferecer a nossa pesquisa gratuitamente. Como ganhamos dinheiro

Um fluxo publicado no n8n Cloud que corre de forma agendada, obtém dados de uma API, mantém apenas os itens que lhe interessam e os publica num canal do Slack.

Experimente n8n gratuitamente

O que vai criar

Neste tutorial vai criar uma automação pequena mas realista no n8n Cloud. Todas as manhãs, obtém uma lista de registos de uma API, mantém apenas os que cumprem uma condição e publica cada um deles num canal do Slack. Pense em novas encomendas acima de um certo valor, pedidos de suporte abertos ou tarefas com prazo para hoje.

O fluxo usa quatro nós, todos da documentação oficial do n8n:

  1. O Schedule Trigger inicia o fluxo a uma hora definida.
  2. O HTTP Request chama a API e devolve os seus dados.
  3. O Filter mantém apenas os itens que cumprem a sua condição.
  4. O Slack envia uma mensagem por cada item restante.

Pelo caminho, vai aprender as ideias essenciais do n8n: um fluxo de trabalho (workflow) é a automação inteira, um nó (node) é um passo e os dados movem-se entre nós como uma lista de itens (items). Uma execução (execution) é uma execução do fluxo inteiro, que é também a forma como o n8n Cloud conta a utilização.

Antes de começar

Precisa de três coisas:

Se preferir o email, pode trocar o Slack pelo nó Gmail no Passo 5. O resto fica igual.

Se ainda está a decidir se o n8n é a ferramenta certa, leia primeiro a nossa análise do n8n.

Passo 1: Criar um novo fluxo

Inicie sessão no n8n Cloud. No menu da esquerda, selecione Personal e depois Create workflow. Vê agora uma tela (canvas) vazia, a área onde coloca e liga os nós.

Dê ao fluxo um nome claro, como "Daily filtered report to Slack". Os nomes importam quando tiver dezenas de fluxos, e aparecem nos alertas de erro.

O n8n oferece também um Assistant integrado que consegue criar um fluxo a partir de uma instrução no chat. É útil mais tarde, mas construir à mão a primeira vez ensina-lhe como as peças encaixam.

Passo 2: Acrescentar um Schedule Trigger

Todos os fluxos começam com um nó de gatilho. Selecione Add first step e escolha On a schedule. Isto acrescenta o nó Schedule Trigger.

Nas definições do nó, mantenha o intervalo em dias e defina Trigger at Hour para a hora que quiser, por exemplo as 8h. O agendamento usa o fuso horário da sua instância do n8n, por isso verifique se corresponde ao sítio onde está.

Mude o nome do nó para algo descritivo, como "Every day at 8 AM". Feche o painel para voltar à tela.

Passo 3: Obter dados com o nó HTTP Request

Selecione o botão + no lado direito do nó de gatilho. Em Search nodes, escreva "http" e escolha HTTP Request.

Defina o método como GET e cole o endereço da sua API no campo URL. Se a API precisar de autenticação, escolha-a nas definições de autenticação e guarde a chave como uma credencial (credential). As credenciais são guardadas separadamente do fluxo, por isso a chave não aparece no próprio nó e pode ser reutilizada.

Agora selecione Execute step. O n8n chama a API uma vez e mostra o resultado no painel de saída. Se a resposta for uma lista, deve ver vários itens. Se a sua lista estiver aninhada dentro de um campo de um único objeto (por exemplo data ou results), acrescente um nó Split Out a seguir a este e aponte-o para esse campo, para que cada registo se torne o seu próprio item.

Mude o nome do nó para algo como "Get records". Executar um passo e ver a sua saída real antes de avançar é o hábito mais útil que existe no n8n.

Passo 4: Manter só o que importa com o nó Filter

Acrescente um nó a seguir ao HTTP Request e procure Filter. Segundo a documentação do n8n, o nó Filter deixa passar os itens que cumprem uma condição e descarta os restantes.

Configure a condição:

  1. No primeiro campo de valor, referencie um campo da entrada. Abra o painel de entrada à esquerda e arraste o campo (por exemplo status ou amount) para a caixa de valor. O n8n escreve uma expressão como {{ $json.status }}, que substitui pelo valor real de cada item no momento da execução.
  2. Use a lista pendente do tipo de dados para escolher o tipo e a comparação, como String com "is equal to", ou Number com "is greater than".
  3. Escreva o valor a comparar, como open ou 100.

Para acrescentar mais regras, selecione Add condition e escolha AND (todas as condições têm de se verificar) ou OR (qualquer condição pode verificar-se). Não pode misturar AND e OR dentro de um mesmo nó Filter. Nas opções, Ignore Case torna as comparações de texto insensíveis a maiúsculas e minúsculas, e Less Strict Type Validation ajuda se vir um erro de "wrong type".

Selecione Execute step outra vez. A saída deve agora conter apenas os itens que correspondem. Se estiver vazia, confira a sua condição com os dados de entrada antes de avançar.

Passo 5: Publicar cada resultado no Slack

Acrescente um nó a seguir ao Filter e procure Slack. Para a ação, escolha o recurso Message com a operação Send, que publica uma mensagem num canal.

Depois, ligue a sua conta do Slack. O nó Slack suporta autenticação OAuth2 e por Access Token. Crie uma nova credencial a partir do nó e siga os passos da página de credenciais do Slack do n8n. Se configurar a sua própria aplicação do Slack, certifique-se de que tem os scopes que a documentação lista para enviar mensagens.

Depois escolha o canal e escreva o texto da mensagem. Misture texto fixo com expressões da entrada, por exemplo:

New item: {{ $json.name }} (status: {{ $json.status }})

Use os nomes de campos dos seus próprios dados. O n8n executa o nó Slack uma vez por cada item recebido, por isso três itens filtrados produzem três mensagens.

Selecione Execute step e verifique o canal do Slack. Quando as mensagens de teste estiverem certas, mude o nome do nó para "Post to Slack".

Passo 6: Testar o fluxo completo e publicá-lo

Até agora testou um nó de cada vez. Agora selecione Execute por baixo da tela para executar o fluxo completo a partir do gatilho. Cada nó deve mostrar uma marca verde quando é bem-sucedido.

Um fluxo testado ainda não corre sozinho. Para ligar o agendamento, selecione Publish no cabeçalho da tela. A partir de agora, o n8n inicia o fluxo automaticamente à hora que definiu no Passo 2, e cada execução conta como uma execução.

Se alterar o fluxo mais tarde, lembre-se de publicar outra vez para que a versão em produção apanhe as suas edições.

Passo 7: Verificar as execuções e acrescentar um alerta de erro

Abra o separador de execuções do fluxo para ver as execuções anteriores, se cada uma foi bem-sucedida e os dados que passaram por cada nó. É aqui que olha primeiro quando algo corre mal.

Como rede de segurança, crie um segundo fluxo que comece com o nó Error Trigger e envie uma mensagem do Slack ou um email com os detalhes do erro. Depois abra o seu fluxo principal, vá a Options > Settings e escolha esse fluxo em Error workflow. Segundo a documentação do n8n, o error workflow recebe o ID da execução falhada, a mensagem de erro e o último nó que correu, e um mesmo error workflow pode servir vários fluxos.

Passo 8 (opcional): Executar o n8n você mesmo com o Docker

O n8n Cloud é a forma mais fácil de começar, mas também pode alojar a Community Edition gratuita. A sua licença é a Sustainable Use License, que permite uso empresarial interno, pessoal e não comercial. A documentação do n8n avisa que o alojamento próprio exige conhecimentos técnicos e que erros podem levar a perda de dados, problemas de segurança e indisponibilidade.

Para um teste local, a documentação descreve esta configuração com o Docker Desktop instalado:

  1. Crie um volume para que os seus dados sobrevivam aos reinícios: docker volume create n8n_data
  2. Inicie o n8n com a imagem oficial, mapeando a porta 5678 e montando o volume: docker run -it --rm --name n8n -p 5678:5678 -e GENERIC_TIMEZONE="<YOUR_TIMEZONE>" -e TZ="<YOUR_TIMEZONE>" -e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true -v n8n_data:/home/node/.n8n n8nio/n8n
  3. Abra http://localhost:5678 no navegador.

Substitua <YOUR_TIMEZONE> por um nome de fuso horário como America/New_York. Para qualquer coisa além de um teste local, a documentação do n8n recomenda antes a instalação com Docker Compose, e é você o responsável pelas atualizações, cópias de segurança e HTTPS. Algumas funcionalidades de equipa, como projetos e SSO, não fazem parte da Community Edition.

Erros comuns

Próximos passos

Tem agora um fluxo publicado que corre todas as manhãs e comunica apenas o que importa. A partir daqui, experimente acrescentar um nó If para enviar mensagens diferentes para casos diferentes, ou substituir o Slack pelo Gmail para um resumo por email. A biblioteca de modelos do n8n também é um bom sítio para ver como outros estruturam fluxos semelhantes.

Se quer comparar o n8n com outras ferramentas antes de construir mais, leia Make vs n8n e Zapier vs n8n, ou siga o nosso tutorial do Make para construir lá o mesmo tipo de fluxo.

Continue a criar com o n8n

Perguntas frequentes

Preciso de saber programar para seguir este tutorial?

Não. Todos os passos usam os nós visuais e os campos de formulário do n8n. Vai escrever algumas expressões curtas, mas nenhum código.

O teste do n8n Cloud custa alguma coisa?

Segundo o n8n, o teste do Cloud de 14 dias não exige cartão de crédito e inclui as funcionalidades do Pro com 1.000 execuções. Se não fizer upgrade, o teste termina automaticamente.

Quantas execuções usa este fluxo?

Uma por execução. O n8n conta uma execução como uma única execução do fluxo inteiro, independentemente do número de nós que tenha, por isso um agendamento diário usa cerca de 30 execuções por mês.

Qual é a diferença entre Execute e Publish?

O Execute corre o fluxo uma vez para que o possa testar. O Publish põe-no em produção, para que o Schedule Trigger o inicie automaticamente nas horas que definir.

Posso enviar um email em vez de uma mensagem do Slack?

Sim. Substitua o nó Slack pelo nó Gmail ou por outro nó de email e mapeie os mesmos campos para a mensagem.

Posso executar este fluxo no meu próprio servidor?

Sim. Pode alojar a Community Edition do n8n com o Docker, como descrito no último passo, e importar ou reconstruir lá o fluxo.

Ver o histórico de atualizações deste artigo
  • Primeira publicação.

Equipa komasu

A komasu é um programador independente no Japão que cria pequenas ferramentas de software e gere o seu próprio negócio com produtos de automação e no-code. Escrevemos análises baseadas em pesquisa: lemos a documentação, as páginas de preços e os comentários públicos dos utilizadores, pontuamos cada ferramenta com os mesmos critérios fixos e datamos todos os factos que indicamos.

Sobre · Metodologia