O que o Split Out Faz
O nó Split Out no n8n permite que você pegue qualquer campo de array nos seus dados e o divida, fazendo com que cada elemento do array se torne seu próprio item para processamento individual, funcionando como o nó "iterator" em outras ferramentas de automação.
- Recebe um item (por exemplo, com um campo chamado "customers", que é um array: [{"name":"Alice"},{"name":"Bob"},{"name":"Carlos"}])
- O nó produz um item separado para cada entrada nesse array, expandindo o array agrupado em múltiplos itens de workflow para processar individualmente
- Isso significa que você pode enviar emails personalizados para cada cliente, processar registros separados de respostas de API ou lidar com cada linha de uma planilha isoladamente
Principais Casos de Uso
- Dividir registros de respostas de API para que cada um seja processado separadamente
- Separar linhas de uma tabela, como Google Sheets ou consulta de banco de dados, para aplicar ações individuais
- Iterar sobre saídas de modelos de IA, para que você possa tratar cada resultado gerado individualmente
- Ações de automação granulares, como enviar mensagens para cada contato de uma lista de contatos
Como Configurar e Usar
- Inserir o Nó: Adicione o nó Split Out diretamente após um nó que gera um array (ex: HTTP Request, Sheets, AI, etc.)
- Campo para Dividir: Especifique o campo que contém o array que você deseja dividir (ex: "data.customers")
- Configurações de Inclusão: Decida se deseja manter outros campos do item original com cada resultado dividido:
- "No Other Fields" (apenas o campo principal)
- "All Other Fields" (preservar contexto)
- "Selected Other Fields" (lista customizada)
- Notação de Ponto: Por padrão, você pode referenciar subcampos usando notação de ponto ("parent.child"). Isso é útil para dados estruturados, desabilite se usar objetos planos
- Conectar Downstream: Continue construindo seu workflow, cada novo item agora representa um caminho de execução individual para apenas aquele elemento do array
Melhores Práticas e Dicas
- Use Split Out antes de loops, requisições HTTP ou ações de mensagens - você garantirá que cada dado seja processado sem manipulação manual de arrays
- Se seu array de origem vem de mais profundo no workflow (não apenas do nó anterior), verifique as conexões dos nós, pois Split Out espera entrada diretamente de seu predecessor, a menos que use nós Merge ou Set
- Combine com o nó Aggregate se precisar reconstruir arrays após o processamento para relatórios, resumos ou envios de API
Exemplo Prático
Cenário: Processar Lista de Contatos
Suponha que uma API retorne [{"name":"Julie"},{"name":"Sam"},{"name":"Lee"}] em um campo "contacts".
Com Split Out:
- O nó produz três itens separados para Julie, Sam e Lee
- Você pode então enviar um email por contato ou registrar cada um em um banco de dados individualmente
Resultado: O nó Split Out é crítico para mudar automações de "volume" para "individual", permitindo workflows detalhados, direcionados e poderosos no n8n.