Pesquisar
Português
Conteúdo
  1. Tutorial de n8n
Primeiros passos
  1. O que é n8n
  2. Instalação do n8n
  3. Guia da interface
  4. Primeiro workflow
  5. Estrutura de dados e items
Conceitos essenciais
  1. Expressões
  2. Gerenciamento de credenciais
  3. Nós principais
  4. Webhook
  5. Nó Code
  6. Tratamento de erros
Automação com IA
  1. Introdução ao AI Agent
  2. Conecte modelos locais do Ollama
  3. Perguntas e respostas com base de conhecimento RAG
Exemplos práticos
  1. Automação do Google Sheets
  2. Bot de IA do Telegram
Implantação e operações
  1. Hospedagem própria
  2. Backup e atualização
  3. Perguntas frequentes e erros

Tutorial de n8n: aprenda a criar automações e fluxos de trabalho

n8n é uma ferramenta de automação de fluxos de trabalho de código aberto. Você pode conectar Google Sheets, Gmail, Slack, Telegram, bancos de dados, várias APIs e modelos de IA arrastando e soltando nós, para automatizar tarefas repetitivas.

Por exemplo:

  • Buscar informações sobre o clima e a agenda todos os dias às 8h, organizá-las e enviá-las pelo Telegram
  • Quando alguém preencher um formulário, registrar os dados automaticamente em uma planilha, enviar um e-mail de confirmação e avisar a equipe de vendas
  • Ao receber um e-mail de um cliente, usar IA para classificá-lo e redigir uma resposta
  • Criar um assistente de IA que consulte documentos da empresa e use ferramentas

Em comparação com serviços como Zapier e Make, o grande diferencial do n8n é que você pode hospedá-lo por conta própria. Os dados ficam no seu servidor, e o número de execuções não é limitado pelo plano.

O que você vai aprender

  • Conceitos básicos do n8n: fluxos de trabalho, nós, gatilhos e itens (items)
  • Instalar o n8n com Docker e criar seu primeiro fluxo de automação
  • Usar expressões, credenciais e nós principais comuns
  • Receber dados externos com Webhook e processar lógicas complexas com o nó Code
  • Tratar erros e enviar notificações
  • Criar um assistente de IA com o nó AI Agent e conectá-lo a um modelo local do Ollama e a uma base de conhecimento (RAG)
  • Hospedar sua própria instância, fazer backup e atualizar

Para quem é este tutorial

  • Profissionais de escritório, marketing, atendimento ao cliente e operações que querem automatizar tarefas repetitivas do dia a dia
  • Desenvolvedores que querem conectar serviços rapidamente sem programar tudo do zero
  • Pessoas que querem criar fluxos de automação com IA e AI Agents

Você não precisa programar para realizar as operações básicas. Os capítulos avançados usam um pouco de JavaScript.

Este tutorial usa a versão 2.x do n8n. Como o n8n recebe atualizações frequentes, alguns detalhes da interface podem ser diferentes do que você vê.

Comece por O que é o n8n.

Primeiros passos

  1. O que é n8n

    Conheça o n8n, seus fluxos de trabalho, nós e gatilhos. Compare-o com Zapier e Make e escolha entre n8n Cloud e hospedagem própria.

  2. Instalação do n8n

    Instale o n8n no seu computador passo a passo: inicie rapidamente com Docker, configure o fuso horário de Taiwan e salve os dados, ou execute diretamente com npx / npm e configure sua conta no primeiro acesso.

  3. Guia da interface

    Conheça a interface do n8n: página inicial e projetos, editor de workflows, como adicionar e conectar nós, painel de configurações, execução de testes, salvamento e publicação (Publish), histórico de execuções e atalhos úteis.

  4. Primeiro workflow

    Siga as etapas para criar sua primeira automação no n8n: use Schedule Trigger para executar diariamente, HTTP Request para consultar a API de previsão do tempo, Edit Fields para organizar os dados e envie uma notificação por Email. Aprenda também a testar, publicar e consultar o histórico de execuções.

  5. Estrutura de dados e items

    Entenda o conceito central de dados no n8n: os nós passam arrays de items, e cada nó é executado uma vez para cada item. Veja JSON, dados binários, vinculação, divisão e combinação de dados, além de entender por que uma ação é executada várias vezes.

Conceitos essenciais

  1. Expressões

    Tutorial completo de expressões no n8n: leia dados com {{ }}, entenda $json e $('nome do nó'), manipule textos e arrays, use condições, datas com Luxon, $now e $execution, com vários exemplos práticos.

  2. Gerenciamento de credenciais

    Tutorial de credenciais do n8n: adicione chaves de API e credenciais OAuth, configure o OAuth do Google no n8n auto-hospedado e proteja e compartilhe credenciais.

  3. Nós principais

    Conheça os nós principais mais usados no n8n e quando usar cada um: HTTP Request, Edit Fields, If, Switch, Filter, Merge, Loop Over Items, Wait, Execute Workflow e gatilhos de agendamento.

  4. Webhook

    Use o nó Webhook do n8n para receber dados de formulários, pagamentos e serviços como o GitHub. Configure URLs, métodos HTTP, autenticação e respostas personalizadas.

  5. Nó Code

    Tutorial completo do nó Code do n8n: modos de execução, formato de items, exemplos de processamento de dados, pacotes externos e mudanças no Python e na segurança no n8n 2.x.

  6. Tratamento de erros

    Torne seus fluxos de automação no n8n mais confiáveis: configure retentativas, continue após falhas, interrompa execuções e crie notificações globais de erro.

Automação com IA

  1. Introdução ao AI Agent

    Crie um assistente de IA com o nó AI Agent do n8n: conheça o Chat Trigger, modelos de chat, memória (Memory) e ferramentas (Tools), e monte um chatbot que consulta o clima e lê planilhas. Veja também como configurar instruções do sistema e resolver problemas comuns.

  2. Conecte modelos locais do Ollama

    Use modelos de código aberto (Qwen, Llama, Gemma) executados localmente pelo Ollama no n8n, sem custos de API e sem enviar seus dados para fora.

  3. Perguntas e respostas com base de conhecimento RAG

    Crie uma base RAG no n8n: divida documentos do Google Drive ou enviados em partes, gere embeddings e salve-os em um banco vetorial para que o AI Agent responda com base neles. Veja Simple Vector Store, Qdrant e PGVector.

Exemplos práticos

  1. Automação do Google Sheets

    Aprenda a usar o n8n com Google Sheets: configure a autenticação, leia, adicione e atualize linhas, monitore novos dados e automatize inscrições com e-mail de confirmação.

  2. Bot de IA do Telegram

    Crie um bot do Telegram com n8n: configure o BotFather, receba mensagens, gere respostas com IA, mantenha o contexto por usuário e envie imagens e botões.

Implantação e operações

  1. Hospedagem própria

    Implante o n8n em um servidor na nuvem para produção com Docker Compose, PostgreSQL e HTTPS automático do Caddy; configure domínio, Webhooks, chave de criptografia e fuso horário.

  2. Backup e atualização

    Proteja seus workflows e credenciais do n8n: exporte workflows e credenciais pela CLI, faça backup do PostgreSQL e do diretório de dados, migre para um novo host e atualize o n8n com segurança, incluindo cuidados ao passar da versão 1.x para a 2.x.

  3. Perguntas frequentes e erros

    Respostas para problemas comuns no n8n: Webhook com localhost, fuso horário, nós executados várias vezes, falhas de OAuth, falta de memória e mais.

Atualizado 12 de outubro de 2026