O que o Aggregate Faz
O nó Aggregate no n8n é a contraparte do nó Split Out, permitindo que você combine (ou "agrupe") múltiplos itens de workflow em um único item, frequentemente para preparar dados para relatórios resumidos, processamento em grupo ou atualizações de API em lote.
- Transforma muitos itens individuais de workflow em um número menor de itens agrupados, geralmente apenas um, coletando dados de um campo (ex: todos os valores de "email") ou combinando itens inteiros em um único array
- Permite preparar payloads em lote, fazer cálculos de resumo ou criar relatórios agrupados antes de enviar os dados adiante no workflow
Principais Casos de Uso
- Lotes para APIs: Preparar arrays de registros para enviar a um sistema externo em massa, em vez de um de cada vez
- Resumir: Computar métricas agregadas (como totais, médias ou min/max) para relatórios
- Agrupar: Agrupar itens por um campo específico (como ID do cliente ou categoria) para reestruturar sua saída para análise ou dashboards
- Reconstruir Arrays: Após processar itens individuais (por exemplo, após um Split Out), reagrupá-los para processamento adicional ou exportação
Como Configurar e Usar
- Inserir o Nó: Adicione o nó Aggregate após uma série de itens, como saídas de Split Out, requisições HTTP ou registros transformados
- Escolher Modo de Agregação:
- Individual Fields: Combine campos específicos de todos os itens de entrada em um array (ex: coletar todos os endereços de email em um campo de array)
- All Item Data: Agrupe itens inteiros em uma lista dentro de um único campo de saída, frequentemente nomeado como "orders" ou "results"
- Opções Avançadas:
- Group By: Agrupe itens por um valor único ou categoria (ex: todas as vendas por cliente)
- Merge Lists: Achate arrays do campo agregado se cada entrada já for um array (problema de "lista de listas")
- Include/Exclude Fields: Ajuste quais campos são mantidos em arrays ou itens de resumo
- Disable Dot Notation: Referencie campos com nomes contendo pontos como chaves literais
- Conectar Downstream: Após a agregação, a saída é um único item (ou itens agrupados se usar Group By) contendo arrays ou dados resumidos, pronto para relatórios, exportação ou ação em massa
Melhores Práticas e Dicas
- Use após Split Out ou lógica de loop para recombinar resultados individuais de volta em estrutura para o próximo passo de automação
- Ao resumir, aproveite nós JavaScript downstream para cálculos complexos (ex: totais/médias) se não forem tratados diretamente no Aggregate
- Sempre verifique que seu array resultante ou dados agrupados correspondem ao que o próximo sistema downstream ou API está esperando
Exemplo Prático
Cenário: Agregando Pedidos
Suponha que você tenha 10 itens de pedido chegando individualmente. Usando Aggregate:
- All Item Data: Produz um único item com um campo "orders", cujo valor é um array de todos os seus registros de pedidos, ideal para POSTs de API únicos ou planilhas de resumo
- Individual Fields + Sum: Reúne todos os campos "amount" em um único array, ou os soma para um valor total de vendas
Resultado: O nó Aggregate é o passo crítico de "recombinação" ou "agrupamento", ajudando você a passar do tratamento de dados granular de volta para dados agrupados e prontos para lote para automações eficientes.