Introducción al Módulo: Loops e Iteraciones

Descripción de la cápsula

Hasta acá, cuando un workflow procesaba múltiples items (filas de un Sheet, items de un webhook batch), n8n iteraba automáticamente — cada nodo se ejecutaba una vez por item, sin que tú escribieras un loop. Funciona perfecto para volúmenes pequeños y medianos.

Pero la realidad de listas grandes (1000+ items) y APIs con rate limits rompe ese modelo. Necesitas control explícito sobre cómo y cuándo se procesan los items: ¿de a 50 a la vez para no saturar?, ¿con 1 segundo de delay entre batches?, ¿en paralelo o secuencial?, ¿hasta que cierta condición se cumpla?

Este módulo te enseña los nodos y patrones para esos casos: SplitInBatches (el caballo de batalla), Wait para rate limiting, Aggregate para juntar resultados, y patrones de loops hasta condición y paginación que son esenciales en automaciones reales.

Lo que vas a aprender

Al terminar este módulo serás capaz de:

✅ Entender la iteración implícita de n8n y sus límites
✅ Usar SplitInBatches para procesar listas en lotes controlados
✅ Implementar patrones de loop según el caso (todos, hasta condición, paginación)
✅ Aplicar rate limiting con Wait node
✅ Juntar resultados con Aggregate
✅ Procesar 1000+ items sin saturar APIs ni timear el workflow

Estructura del módulo

8 cápsulas en cuatro bloques:

Bloque 1: Fundamentos (cápsulas 01-02)

01 Introducción al módulo
02 Iteración implícita — cómo n8n itera por default

Bloque 2: Control explícito (cápsulas 03-04)

03 SplitInBatches — el nodo principal de loops
04 Patrones de loop con SplitInBatches

Bloque 3: Operación profesional (cápsulas 05-06)

05 Rate limiting con Wait node
06 Aggregate — juntar resultados después de iterar

Cierre (cápsulas 07-08)

07 Loops complejos (paginación, hasta condición)
08 Mini-proyecto: procesar 1000 items con rate limit

¿Por qué este orden?

Aprendes en el orden natural:

Primero cómo n8n itera por default (cápsula 02) — porque muchos no lo entienden
Después el nodo central (SplitInBatches) y sus patrones (03-04)
Luego rate limiting y agregación (05-06)
Finalmente loops avanzados y proyecto integrador (07-08)

El modelo mental: iteración implícita vs explícita

Iteración implícita (n8n default): llegan 100 items al nodo. El nodo se ejecuta 100 veces, una por item. Tú no escribes loop. Es como pasar 100 cartas al cartero — cada una se entrega independientemente.

Iteración explícita (con SplitInBatches): controlas el tamaño del lote, el delay entre lotes, qué hacer con el resultado de cada lote. Es como decirle al cartero "entrega de a 10 cartas, espera 2 minutos entre tandas, agrúpame todas las confirmaciones al final".

El default está bien para volúmenes chicos. Para 100+ items o APIs con rate limits, necesitas explícito.

Tiempo estimado

1.5 a 2 horas para las 8 cápsulas. El mini-proyecto ~30 min.

División sugerida:

Sesión 1 (45-60 min): 01-03 (intro + implícita + SplitInBatches)
Sesión 2 (45-60 min): 04-06 (patrones + rate limit + aggregate)
Sesión 3 (30-45 min): 07-08 (complejos + proyecto)

Lo que NO cubre este módulo

❌ Loops recursivos avanzados (workflow se llama a sí mismo) → G10
❌ Procesamiento distribuido (múltiples instancias) → G10
❌ Streaming de datos grandes (procesamiento en memoria limitada) → guías avanzadas
❌ Map/reduce conceptual con Code → guías avanzadas

El foco: patrones prácticos que cubren 90% de casos reales.

Pre-requisitos

G1 completada (sobre todo M07 — lógica)
G2-M01 (triggers) y M02 (branching) completados o en curso
Familiaridad con expressions y Set node

Resumen

M03 enseña control explícito sobre iteración
8 cápsulas en 4 bloques: fundamentos → control → operación → avanzados/proyecto
Iteración implícita de n8n vs explícita con SplitInBatches
Tiempo estimado: 1.5-2 horas

Recursos adicionales

SplitInBatches Documentation - Referencia oficial.
Looping Patterns in Workflows - Patrones generales.

Creado: Mayo 11, 2026 Versión: 1.0