Ir para o conteúdo
Promovaweb

Guias de n8n

Os guias explicam um assunto por vez, com objetivo, pré-requisitos, procedimento e uma forma clara de conferir o resultado. Eles servem para consulta: você chega pelo problema do momento e sai com o assunto resolvido.

O que você encontra aqui

  • Fundamentos: editor, nodes e triggers, itens e JSON, expressões e credenciais.
  • Como o n8n processa itens: quando um node roda uma vez por item e quando roda uma vez para a lista inteira.
  • Item linking: como buscar o valor certo de um node anterior sem misturar registros.
  • APIs e webhooks: o HTTP Request para chamar qualquer API e o Webhook para receber chamadas.
  • Integrações: Google Sheets, Postgres, Chatwoot, Mautic e WhatsApp, com credencial, nodes e limites de cada serviço.
  • Erros: workflow de erro com Error Trigger, novas tentativas e falhas controladas.
  • Code node: quando escrever código e quando um node pronto resolve melhor.

Como os guias são feitos

Cada guia informa a versão do n8n usada como referência e a data da revisão. As fontes da documentação oficial aparecem no fim, com a data da consulta.

Uma dica de leitura

Os guias se ligam entre si. No fim de cada um, “Continue a leitura” aponta os assuntos vizinhos. Siga por eles quando um conceito novo aparecer no meio do caminho.

Guia, nível inicial

Como o n8n processa itens

Entenda quando um node do n8n roda uma vez por item, quando roda uma vez para a lista inteira e como essa diferença altera o resultado final do workflow.

Guia, nível intermediário

Conecte a API oficial do WhatsApp ao n8n

Use WhatsApp Business Cloud e WhatsApp Trigger no n8n, configure as credenciais da Meta e confira o envio de mensagens e o recebimento de eventos.

Guia, nível intermediário

Conecte o Chatwoot ao n8n por webhook e API

Integre o Chatwoot ao n8n com Webhook e HTTP Request, receba eventos de atendimento e envie mensagens pela API oficial com autenticação e conferência.

Guia, nível inicial

Conecte o Google Sheets ao n8n

Conecte o Google Sheets ao n8n, escolha a planilha e a aba, configure o mapeamento das colunas e confira como inserir ou atualizar linhas pelo Node.

Guia, nível intermediário

Conecte o Mautic ao n8n pelo Node nativo

Configure o Node Mautic no n8n com Basic auth ou OAuth2, habilite a API e use as ações de contatos, segmentos e campanhas com conferência no destino.

Guia, nível intermediário

Conecte o PostgreSQL ao n8n

Conecte o n8n ao Postgres: credencial, consultas parametrizadas, inserções e atualizações, com cuidados de conexão e de volume para não travar o banco.

Guia, nível inicial

Conheça o editor de workflows

Conheça o editor do n8n: crie um workflow, adicione o primeiro trigger, execute manualmente e entenda a diferença entre rascunho e versão publicada.

Guia, nível inicial

Consuma uma API com o HTTP Request

Use o node HTTP Request do n8n para chamar qualquer API REST: escolha o método, configure a autenticação, envie parâmetros e corpo e leia a resposta.

Guia, nível inicial

Credenciais

Crie credenciais no n8n para conectar serviços externos, entenda como o n8n testa e protege esses acessos e como restringir o uso no HTTP Request.

Guia, nível inicial

Expressões

Aprenda a escrever expressões no n8n com chaves duplas e $json para usar campos do item atual e de nodes anteriores em qualquer parâmetro do node.

Guia, nível intermediário

Item linking na prática

Entenda como o n8n liga cada item aos itens que o geraram e como usar .item, itemMatching() e pairedItem() para buscar valores de nodes anteriores.

Guia, nível inicial

Itens e JSON

Veja o formato dos itens que passam entre os nodes do n8n: a chave json, o processamento item a item, a leitura de campos aninhados e o mapeamento.

Guia, nível inicial

Nodes e triggers

Entenda a diferença entre triggers e ações no n8n, como os nodes passam itens entre si e quais configurações mudam o comportamento de cada um deles.

Guia, nível inicial

O que é o n8n e quando usar

Entenda o que é o n8n, como um workflow funciona com trigger, nodes e execuções e para quais tarefas a ferramenta serve na rotina de uma empresa.

Guia, nível intermediário

Quando usar o Code node

Saiba quando o Code node do n8n é a escolha certa, como funcionam os dois modos de execução e o que muda no n8n 3.0 para workflows que usam Function.

Guia, nível inicial

Receba chamadas com webhooks

Receba chamadas de outros sistemas com o node Webhook do n8n: URL de teste e de produção, métodos HTTP e as três formas de responder ao chamador.

Guia, nível inicial

Sua primeira automação funcional

Monte sua primeira automação no n8n: receba um nome por webhook, prepare os campos com Edit Fields, teste pela URL de teste e publique o workflow.

Guia, nível intermediário

Trate erros nos seus workflows

Monte um workflow de erro com o Error Trigger, configure novas tentativas e saídas de erro nos nodes e force falhas controladas com o Stop And Error.

Guia, nível inicial

Visão geral do n8n Assistant

Conheça o n8n Assistant, o assistente em chat que cria, edita, testa e corrige workflows, e veja o que ele exige em uma instalação própria do n8n.

Guia, nível inicial

Visão geral dos workflows

Veja como um workflow do n8n funciona: trigger, nodes, conexões, itens, expressões, execuções e a diferença entre o rascunho e a versão publicada.