Pular para o conteúdo principal

Conceitos Fundamentais do n8n

O n8n é uma plataforma de automação de workflows que permite conectar diferentes aplicações e serviços através de uma interface visual intuitiva. Este guia apresenta os conceitos fundamentais para começar a usar o n8n.

O que é o n8n?​

O n8n é uma ferramenta de automação de workflows que permite:

  • Conectar aplicações sem escrever código
  • Automatizar processos repetitivos
  • Integrar sistemas diferentes
  • Criar workflows visuais e intuitivos

Arquitetura Básica​

Workflows​

Workflows são sequências de ações que automatizam tarefas. Eles são compostos por:

  • Triggers - Iniciam o workflow
  • Nodes - Processam dados
  • Connections - Conectam os nodes

Nodes​

Nodes são os blocos de construção dos workflows. Cada node tem uma função específica:

// Exemplo de configuração de HTTP Request Node
{
  "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 permite usar os dados gerados por um node anterior nos próximos passos. É 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}}

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​

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

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

Próximos Passos

Agora que você conhece os conceitos fundamentais do n8n, está pronto para:

  1. Criar seu primeiro workflow
  2. Explorar nodes disponíveis
  3. Configurar credenciais
  4. Aprender expressões avançadas
  5. Implementar automações complexas

Dica: Comece com workflows simples e vá aumentando a complexidade gradualmente. A prática é a melhor forma de aprender o n8n.