Pular para o conteúdo principal

Conceitos Fundamentais

Esta seção apresenta os conceitos fundamentais que formam a base do n8n. Entender estes conceitos é essencial para criar workflows eficientes e aproveitar ao máximo a plataforma.

Índice​

  1. Introdução ao n8n
  2. Conceitos Básicos
  3. Componentes Principais
  4. Conceitos Avançados
  5. Próximos Passos

1. Introdução ao n8n​

O que é o n8n?​

O n8n (pronuncia-se "n-eight-n") é uma plataforma de automação de workflows que permite conectar diferentes aplicações e serviços através de uma interface visual. É uma ferramenta open-source que oferece flexibilidade e poder para criar automações complexas sem necessidade de programação avançada.

Características principais:

  • Open source: Código aberto e gratuito
  • Visual: Interface gráfica para criar workflows
  • Flexível: Suporta centenas de integrações
  • Poderoso: Permite automações complexas
  • Escalável: Funciona para projetos pequenos e grandes

Características Principais​

  • Editor visual de workflows com mais de 400 integrações nativas
  • Nós de código em JavaScript/Python para lógica específica
  • Triggers avançados: webhooks, automações agendadas e ações via IA
  • Autonomia total: pode ser executado localmente ou na nuvem
  • Gratuito e open-source sob licença "fair-code"

Por que usar o n8n?​

O n8n se destaca por sua flexibilidade e poder. Diferente de outras ferramentas de automação, ele oferece controle total sobre seus workflows, permitindo desde automações simples até sistemas complexos de integração entre múltiplas plataformas.

2. Conceitos Básicos​

Workflows​

Um workflow é a unidade fundamental do n8n. É uma sequência visual de etapas automatizadas que processam dados de uma forma específica. Pense em um workflow como uma receita que o n8n segue para realizar uma tarefa.

Estrutura básica de um workflow:

Trigger → Node 1 → Node 2 → Node 3 → Resultado

Exemplo simples:

Receber dados → Processar → Enviar resultado

Exemplo prático: Receber dados de um formulário, processar as informações e enviar um email de confirmação.

Componentes de um Workflow​

  1. Trigger: Inicia o workflow
  2. Nodes: Processam os dados
  3. Connections: Ligam os nodes
  4. Data: Informações que fluem entre nodes

Tipos de Workflows​

1. Workflows Simples

  • Um trigger + poucos nodes
  • Tarefa específica e bem definida
  • Fácil de entender e manter

Exemplo: Enviar email quando receber webhook

2. Workflows Complexos

  • Múltiplos triggers e muitos nodes
  • Lógica condicional e loops
  • Integração com vários sistemas

Exemplo: Sistema completo de CRM com múltiplas integrações

3. Workflows em Paralelo

  • Múltiplos caminhos de execução
  • Processamento simultâneo
  • Agregação de resultados

Exemplo: Consultar múltiplas APIs e consolidar dados

Nodes​

Nodes são os blocos de construção dos workflows. Cada node tem uma função específica e processa dados de uma forma particular. É como uma peça de LEGO: pequena, funcional, e que se encaixa em outras.

Tipos de Nodes​

1. Trigger Nodes Iniciam workflows automaticamente:

  • Manual Trigger: Execução manual pelo usuário
  • Schedule Trigger: Execução programada (cron)
  • Webhook: Recebe dados de sistemas externos
  • Polling: Consulta APIs periodicamente

2. Regular Nodes Processam dados durante o workflow:

  • HTTP Request: Faz chamadas para APIs
  • Set: Define ou modifica campos
  • Code: Executa código JavaScript
  • If: Cria condições e decisões
  • Switch: Múltiplas condições

3. Output Nodes Geram resultados ou ações:

  • Email: Envia emails
  • Slack: Envia mensagens
  • Database: Salva dados
  • File: Cria arquivos

Configuração de Nodes​

Cada node tem propriedades configuráveis:

// Exemplo: Configuração de HTTP Request
{
  "method": "POST",
  "url": "https://api.exemplo.com/dados",
  "headers": {
    "Content-Type": "application/json"
  },
  "body": {
    "nome": "{{ $json.nome }}",
    "email": "{{ $json.email }}"
  }
}

Triggers​

Triggers são nodes especiais que iniciam workflows. Eles "disparam" a execução baseado em eventos ou condições. Todo workflow começa com um trigger.

Tipos de Triggers​

1. Manual Trigger

  • Execução manual pelo usuário
  • Teste de workflows
  • Debug e desenvolvimento

2. Schedule Trigger

  • Execução programada (cron)
  • Tarefas recorrentes
  • Backups automáticos
// Exemplo: Executar diariamente às 8h
Cron: 0 8 * * *

3. Webhook Trigger

  • Recebe dados de sistemas externos
  • Execução em tempo real
  • Integração com APIs
// Exemplo: URL do webhook
https://seu-n8n.com/webhook/meu-webhook

4. Polling Trigger

  • Consulta APIs periodicamente
  • Verifica mudanças
  • Sincronização de dados

Connections​

Connections são as ligações entre nodes que definem o fluxo de dados. Elas mostram por onde os dados vão passar e em que ordem. Conectar bem significa garantir que a informação certa chegue ao lugar certo — sem ruídos.

Tipos de Connections​

1. Connection Simples

  • Um node para um node
  • Fluxo linear de dados
  • Processamento sequencial

2. Connection Condicional

  • Múltiplos caminhos baseados em condições
  • Decisões no workflow
  • Processamento paralelo

3. Connection de Merge

  • Múltiplos inputs para um output
  • Consolidação de dados
  • Sincronização de fluxos

Data Flow​

O fluxo de dados é fundamental no n8n. Os dados fluem de um node para outro, sendo processados e transformados em cada etapa.

Como os Dados Fluem​

  1. Trigger inicia o workflow
  2. Dados são passados para o próximo node
  3. Cada node processa os dados
  4. Resultado é passado adiante

Estrutura de Dados​

Os dados no n8n são organizados em items:

{
  "json": {
    "nome": "João Silva",
    "email": "joao@exemplo.com",
    "idade": 30
  },
  "binary": {
    "arquivo": {
      "data": "base64...",
      "mimeType": "application/pdf"
    }
  }
}

Data Mapping (Mapeamento de Dados)​

Você pode usar os dados gerados por um node anterior nos próximos passos. Esse processo é chamado de data mapping. É como dizer: "pegue o nome que veio do formulário e insira aqui no e-mail".

Use expressions para acessar dados:

// Dados do item atual
{{ $json.campo }}

// Dados de nodes específicos
{{ $('Nome do Node').json.campo }}

// Dados de múltiplos nodes
{{ $('Node A').json.valor + $('Node B').json.valor }}

3. Componentes Principais​

Expressions​

Expressions são fórmulas que permitem usar dados dinâmicos e fazer cálculos no n8n. Elas são essenciais para criar workflows flexíveis e dinâmicos.

Tipos de Expressions​

1. Acesso a Dados

// Dados do item atual
{{ $json.campo }}

// Dados de nodes específicos
{{ $('Nome do Node').json.campo }}

// Dados de todos os items
{{ $input.all() }}

2. Funções de Data/Hora

// Data atual
{{ $now.toISOString() }}

// Data formatada
{{ $now.toFormat('dd/MM/yyyy HH:mm') }}

// Data calculada
{{ $now.minus({ days: 7 }).toISOString() }}

3. Manipulação de Texto

// Concatenar strings
{{ $json.nome + ' ' + $json.sobrenome }}

// Converter para maiúsculo
{{ $json.texto.toUpperCase() }}

// Substituir texto
{{ $json.texto.replace('antigo', 'novo') }}

4. Cálculos Matemáticos

// Soma
{{ $json.valor1 + $json.valor2 }}

// Multiplicação
{{ $json.quantidade * $json.preco }}

// Porcentagem
{{ ($json.valor * 10) / 100 }}

Credenciais​

Credenciais são informações de autenticação armazenadas de forma segura no n8n para conectar com APIs e serviços externos.

Tipos de Credenciais​

1. API Keys

{
  "apiKey": "sua-chave-api-aqui"
}

2. OAuth2

{
  "clientId": "seu-client-id",
  "clientSecret": "seu-client-secret",
  "accessToken": "token-de-acesso"
}

3. Basic Auth

{
  "username": "seu-usuario",
  "password": "sua-senha"
}

4. Custom Headers

{
  "Authorization": "Bearer seu-token",
  "X-Custom-Header": "valor-personalizado"
}

Segurança​

  • Criptografia: Credenciais são criptografadas
  • Acesso controlado: Apenas usuários autorizados
  • Auditoria: Logs de acesso às credenciais
  • Rotação: Troca periódica de credenciais

Templates​

Templates são workflows pré-configurados que podem ser importados e adaptados para suas necessidades. Eles aceleram o desenvolvimento e fornecem exemplos de boas práticas.

Benefícios dos Templates​

  • Acelerar desenvolvimento: Comece com base sólida
  • Aprender boas práticas: Veja como outros resolvem problemas
  • Reduzir erros: Use soluções testadas
  • Padronizar processos: Mantenha consistência

Como Usar Templates​

  1. Navegue para a seção Templates
  2. Procure por template adequado
  3. Importe o template
  4. Configure credenciais
  5. Adapte para suas necessidades
  6. Teste e ative

Execução de Workflows​

Cada vez que um workflow é ativado, ocorre uma execução. O n8n pega seus dados reais, segue o fluxo definido, e gera um resultado.

Como os Workflows Executam​

  1. Trigger é ativado
  2. Dados são coletados
  3. Nodes processam sequencialmente
  4. Resultado é gerado
  5. Log é registrado

Estados de Execução​

  • Running - Em execução
  • Completed - Concluído com sucesso
  • Failed - Falhou
  • Waiting - Aguardando trigger

Monitoramento​

  • Execution History - Histórico de execuções
  • Logs - Detalhes de cada execução
  • Metrics - Estatísticas de performance
  • Alerts - Notificações de problemas

4. Conceitos Avançados​

Lógica Condicional​

Lógica condicional permite criar workflows que tomam decisões baseadas em dados ou condições específicas.

Nodes para lógica condicional:

  • If - Decisões simples (sim/não)
  • Switch - Múltiplas condições
  • Code - Lógica customizada em JavaScript

Exemplo de lógica condicional:

// Se o valor for maior que 100, enviar para processamento premium
if ($json.valor > 100) {
  // Processamento premium
} else {
  // Processamento padrão
}

Looping e Iteração​

Looping permite processar múltiplos itens ou repetir ações até que uma condição seja atendida.

Tipos de looping:

  • Split In Batches - Dividir dados em lotes
  • Loop Over Items - Iterar sobre cada item
  • While Loop - Repetir até condição ser atendida

Error Handling​

Error Handling é o tratamento de erros que torna seus workflows mais confiáveis e resilientes.

Estratégias de error handling:

  • Try-Catch - Capturar e tratar erros
  • Error Triggers - Executar ações quando há erro
  • Retry Logic - Tentar novamente em caso de falha
  • Fallback Actions - Ações alternativas

Data Mapping Avançado​

Data mapping avançado permite transformar e estruturar dados de forma complexa.

Técnicas avançadas:

  • JSON Path - Acesso a dados aninhados
  • Data Transformation - Modificar estrutura de dados
  • Aggregation - Combinar dados de múltiplas fontes
  • Validation - Validar dados de entrada

Performance e Otimização​

Otimização de performance é crucial para workflows que processam grandes volumes de dados.

Estratégias de otimização:

  • Batch Processing - Processar dados em lotes
  • Caching - Armazenar dados frequentemente acessados
  • Parallel Execution - Executar tarefas simultaneamente
  • Resource Management - Gerenciar uso de recursos

Integração com APIs​

Integração com APIs permite conectar o n8n com sistemas externos e serviços.

Tipos de integração:

  • REST APIs - APIs HTTP padrão
  • GraphQL - APIs de consulta flexível
  • Webhooks - Receber dados em tempo real
  • OAuth - Autenticação segura

Subworkflows​

Subworkflows são workflows que podem ser chamados por outros workflows, permitindo modularização e reutilização de código.

Benefícios dos subworkflows:

  • Modularização - Dividir workflows complexos
  • Reutilização - Usar lógica em múltiplos workflows
  • Manutenção - Facilitar manutenção de código
  • Testabilidade - Testar componentes isoladamente

Monitoramento e Logging​

Monitoramento e logging são essenciais para manter workflows em produção.

Ferramentas de monitoramento:

  • Execution History - Histórico de execuções
  • Logs - Detalhes de cada execução
  • Metrics - Estatísticas de performance
  • Alerts - Notificações de problemas

5. Próximos Passos​

Para Iniciantes​

  1. Instalação - Configure seu ambiente n8n
  2. Primeiro Workflow - Crie sua primeira automação
  3. Conectar Aplicações - Aprenda sobre integrações
  4. Expressões - Domine as expressions

Para Desenvolvedores​

  1. API Reference - Documentação completa da API
  2. Criar Nodes - Desenvolva nodes customizados
  3. Lógica Avançada - Conceitos avançados de fluxo
  4. Performance - Otimize seus workflows

Para Empresas​

  1. Hosting n8n - Implantação em produção
  2. Segurança - Configurações de segurança
  3. Escalonamento - Clustering e load balancing
  4. Compliance - Conformidade e LGPD

Recursos de Aprendizado​

Recursos Relacionados​

Documentação Técnica​

Comunidade e Suporte​

Pronto para começar? Agora você tem uma base sólida dos conceitos fundamentais do n8n. Escolha seu próximo passo e comece a criar automações incríveis!