O que o Loop Faz
O nó Loop Over Items (às vezes mostrado como Split in Batches) no n8n é essencial para processamento sequencial, especialmente ao trabalhar com grandes listas e você quer evitar sobrecarregar APIs, atingir limites de taxa ou esgotar a memória processando muitos itens em paralelo.
- Divide uma lista de itens de entrada em lotes menores e gerenciáveis, frequentemente um de cada vez, processando cada um sequencialmente, em vez de em massa ou paralelo
- Mantém suas automações confiáveis e eficientes em recursos, lidando com limites de API, requisitos de delay e automação de dados em larga escala
Principais Casos de Uso
- Limitação de Taxa de API: Enviar requisições com segurança para APIs com limite de taxa, processando apenas uma (ou um punhado) de cada vez
- Grandes Datasets: Automatizar tarefas como enviar emails, atualizar registros de CRM ou fazer scraping de sites para centenas/milhares de itens sem timeouts ou crashes de sistema
- Workflows Paginados: Fazer loop sobre páginas de dados, buscar e processar cada uma por vez, e opcionalmente lidar com tamanho dinâmico de item ou lote
- Throttling de Workflow: Adicionar pausas (com o nó Wait) entre lotes, garantindo conformidade com limites de processamento de terceiros ou backend
Como Funciona
- Adicionar Nó Após Fonte de Dados: Posicione o nó após um nó produtor de lista (como API, Code, Google Sheets ou nó Aggregate)
- Definir Tamanho do Lote: Defina o tamanho do lote, 1 para limites de taxa estritos, ou maior para processamento agrupado
- Conectar Sua Lógica de Processamento: Downstream, adicione nós para sua ação (ex: HTTP Request, Email, Transformação de Dados)
- Loop de Volta: Conecte o nó de ação de volta à entrada "loop" do nó Loop para execuções repetidas até que todos os lotes sejam processados
- Finalizar e Sair: Quando todos os itens estiverem completos, a execução do workflow avança da saída "done" do nó Loop
- Delays Opcionais: Insira nós Wait para controlar a velocidade de requisição entre iterações se necessário
Melhores Práticas e Dicas
- Prefira Loop Over Items/Split in Batches para chamadas de API para evitar banimentos ou falhas com serviços externos
- Muitos nós n8n nativamente iteram através de arrays de entrada, mas loops explícitos fornecem controle preciso e tratamento de erros
- Sempre defina uma condição de saída clara ou lista finita de itens para evitar loops infinitos, especialmente ao fazer scraping ou paginar
- Se precisar processar lotes em paralelo, ajuste o tamanho do lote ou combine nós paralelos e de loop intencionalmente
Exemplo Prático
Cenário: Enviar Emails com Limite de Taxa
Você tem 500 contatos para enviar email (com um limite de API de 10 por minuto):
- Use Loop Over Items (tamanho do lote: 1) e um nó Wait (6 segundos)
- O workflow envia um email, pausa, faz loop para o próximo, e repete até que todos os 500 estejam prontos, evitando banimentos e garantindo operação estável
Resultado: O nó Loop Over Items torna automações complexas e de larga escala estáveis, controladas e em conformidade com restrições de taxa e memória, uma ferramenta essencial para qualquer construtor sério de n8n.