Pular para o conteúdo principal

Lógica e Manipulação de Dados no n8n - Workflows Inteligentes e Práticos

Lógica e Manipulação de Dados no n8n​

Esta seção apresenta os fundamentos técnicos, arquitetura e conceitos de lógica e dados do n8n. Para guias práticos, passo a passo e troubleshooting, acesse a seção Usando n8n.

Resumo Técnico: Estrutura de Dados no n8n​

No n8n, todos os dados trafegam entre os nós como um array de objetos. Cada item pode conter:

  • json
    : dados estruturados (campos, valores, objetos aninhados)
  • binary
    (opcional): arquivos anexos, com 
    data
    , 
    mimeType
    , 
    fileExtension
    , 
    fileName

Consulte a página Estrutura de Dados no n8n para detalhes avançados, exemplos genéricos e diagrama visual.

Casos de Uso no Brasil​

Veja exemplos completos e dicas para automações nacionais:

Dados​

Tipos de Dados​

  • Strings, números, objetos, arrays
  • Manipulação: Transformação e formatação
  • Validação: Verificação de dados
  • Conversão: Mudança de tipos

Lógica de Fluxo​

Condicionais e Decisões​

  • If/Else: Estruturas condicionais
  • Loops: Repetição de operações
  • Merge: Combinação de fluxos
  • Error Handling: Tratamento de erros

Conexões​

Tipos de Conexão​

  • Sucesso, erro, condicional
  • Mapeamento de Dados: Passagem entre nodes
  • Transformação: Modificação durante passagem

Conceitos Fundamentais​

Estrutura de Dados no n8n​

Todos os dados trafegam entre os nodes como um array de objetos, chamados de items. Cada item representa uma unidade de informação processada no workflow.

Estrutura Padrão de um Item​

Cada item possui, no mínimo, a chave 

json
(com dados estruturados) e, opcionalmente, a chave 
binary
(para arquivos e dados binários):

[
  {
    "json": {
      "nome": "João Silva",
      "email": "joao@exemplo.com",
      "idade": 30
    }
  },
  {
    "json": {
      "nome": "Maria Souza",
      "email": "maria@exemplo.com",
      "idade": 28
    },
    "binary": {
      "arquivo": {
        "data": "base64...",
        "mimeType": "application/pdf",
        "fileName": "contrato.pdf",
        "fileExtension": "pdf"
      }
    }
  }
]

Explicação dos Campos​

  • json: Objeto com dados estruturados (campos, valores, objetos aninhados)
  • binary: Objeto para dados binários (arquivos, imagens, documentos)
    • data: Conteúdo do arquivo em base64
    • mimeType: Tipo MIME do arquivo (ex: 
      image/png
      , 
      application/pdf
      )
    • fileName: Nome do arquivo original
    • fileExtension: Extensão do arquivo (ex: 
      png
      , 
      pdf
      )

Boas Práticas​

  • Sempre defina 
    mimeType
    , 
    fileName
    e 
    fileExtension
    ao trabalhar com arquivos binários para garantir compatibilidade e rastreabilidade
  • Use a chave 
    json
    para todos os dados estruturados e reserve 
    binary
    apenas para arquivos

Próximos passos​

  1. Estrutura de Dados - Entenda como os dados são organizados
  2. Expressões JavaScript - Aprenda a usar expressões
  3. Conexões entre Nodes - Saiba como conectar nodes

Agora você entende os fundamentos de lógica e dados no n8n. Use essas técnicas para criar workflows inteligentes!

Dica Pro

Sempre valide a estrutura dos dados antes de processá-los para garantir que estejam no formato esperado.

Importante

Mantenha backups seguros dos dados binários, pois são arquivos importantes que podem ser perdidos.

Recurso Adicional

Use o Debug Helper para visualizar a estrutura completa dos dados que fluem entre os nodes.