Clase 03 · Módulo 04
Lotes, bucles y pausas
Lotes, bucles y pausas
Qué logras en esta clase
Procesas listas largas sin que el servicio de destino te bloquee y sin armar bucles que no hacían falta.
- Reconoces cuándo n8n ya repite por su cuenta.
- Usas Loop Over Items para trabajar por lotes.
- Calculas el tamaño del lote y la pausa a partir de un límite real.
02
El bucle que no necesitas
En n8n, repetir es lo normal. Un nodo que recibe cien ítems se ejecuta para los cien sin que armes nada.
03
Lo que n8n ya hace solo
El nodo de correo recibe 30 ítems y envía 30 correos. No hay bucle en el lienzo ni hace falta.
04
Lo contrario: ejecutar una sola vez
A veces quieres que un nodo corra una vez aunque le lleguen muchos ítems, por ejemplo para mandar un único aviso de «proceso terminado».
En la pestaña Settings del nodo, activa Execute Once: procesará solo el primer ítem que reciba.
05
Entonces, ¿cuándo sí hay que repetir a mano?
| Situación | Por qué no basta lo automático |
|---|---|
| El servicio limita llamadas por minuto | Los ítems salen todos seguidos |
| El nodo trabaja una vez por operación | No recorre los ítems uno a uno |
| Una lista llega por páginas | Hay que pedir la página siguiente |
| Varios pasos deben completarse por ítem antes de pasar al otro | Cada nodo procesa la lista entera antes de entregar |
06
Nodos que no repiten por ítem
Las excepciones que te tocarán en esta línea:
- RSS Read: corre una vez para la dirección pedida.
- HTTP Request: la paginación la manejas tú (módulo 5, clase 4).
- Code y Execute Sub-workflow en modo de una corrida para todos los ítems.
07
Loop Over Items: trabajar por lotes
Es el nodo para repetir a mano. En documentación antigua aparece como Split in Batches. Guarda la lista completa y la entrega de a porciones.
- Batch Size: cuántos ítems entrega en cada vuelta.
- Salida loop: el lote de esta vuelta; aquí conectas el trabajo.
- Salida done: todo lo procesado, cuando ya no quedan ítems.
08
Cómo se conecta
El último nodo de la rama loop se conecta de vuelta a la entrada de Loop Over Items. Esa conexión de regreso es la que hace avanzar al lote siguiente.
09
Armarlo paso a paso
- Agrega Loop Over Items después del nodo que entrega la lista.
- Define el Batch Size: 1 para ir de a uno, más para grupos.
- Desde la salida loop, conecta los nodos que hacen el trabajo.
- Une el último de ellos con la entrada de Loop Over Items.
- Desde done, conecta lo que debe pasar al terminar.
No necesitas un IF: el nodo se detiene solo al repartir todos los ítems.
10
El límite manda, no la impaciencia
Un flujo que envía todo de golpe no es más rápido si el servicio lo rechaza. El ritmo lo fija el límite del destino.
11
Límites reales para dimensionar
| Servicio | Límite publicado |
|---|---|
| Google Sheets API | 60 lecturas y 60 escrituras por minuto por usuario |
| Telegram, mismo chat | Alrededor de 1 mensaje por segundo |
| Telegram, grupo | 20 mensajes por minuto |
Al pasarte, estos servicios responden con el error 429 (demasiadas llamadas). Cada servicio publica sus propios límites: búscalos como «rate limits» o «usage limits» en su documentación antes de construir.
12
Calcular lote y pausa
Parte del límite y deja margen.
Mejor aún: si el servicio acepta escribir muchas filas en una sola llamada, haz eso y te ahorras el bucle.
13
Wait: la pausa entre lotes
El nodo Wait detiene la ejecución y la retoma después. Para espaciar lotes:
- Pon Wait al final de la rama loop, antes de volver.
- En Resume elige After Time Interval.
- Completa Wait Amount y Wait Unit (segundos, minutos, horas o días).
Las otras formas de reanudar, por llamada o por formulario, se ven en la clase 5.
14
Qué pasa durante una espera
| Espera | Cómo la maneja n8n |
|---|---|
| Menos de 65 segundos | La ejecución sigue en memoria y continúa sola |
| Más larga | Guarda la ejecución en la base y la recarga al cumplirse el plazo |
15
Saber en qué vuelta vas
Dentro del bucle puedes consultar el estado del nodo con expresiones:
{{ $("Loop Over Items").context["currentRunIndex"] }}
{{ $("Loop Over Items").context["noItemsLeft"] }}La primera entrega el número de vuelta. La segunda vale true cuando ya no quedan ítems. Sirven para numerar avisos o para tratar distinto la última vuelta.
16
Bucle manual con IF
Hay casos sin lista previa: «pregunta el estado hasta que diga listo». Ahí conectas la salida de un nodo de vuelta a uno anterior y pones un IF que decide si seguir o salir.
17
Todo bucle necesita una puerta de salida
Antes de ejecutar un bucle, responde una pregunta: ¿qué lo detiene si el dato esperado nunca llega?
18
La opción Reset
Loop Over Items tiene una opción Reset: al activarla, el nodo trata lo que recibe en cada vuelta como una lista nueva en vez de continuar la anterior. Se usa en bucles donde la lista se va generando, como al recorrer páginas.
La documentación advierte lo mismo que con el bucle manual: con Reset necesitas una condición de término válida o la ejecución gira sin fin.
19
Errores comunes con bucles y pausas
- Poner un bucle donde el nodo ya procesaba todos los ítems.
- Olvidar la conexión de regreso: se procesa solo el primer lote.
- Conectar el paso final a loop en vez de a done: se repite en cada vuelta.
- Elegir la pausa a ojo, sin leer el límite del servicio.
- Probar el bucle con la lista completa en vez de con cinco ítems.
20
Lo que te llevas
- n8n ejecuta cada nodo una vez por ítem; el bucle es la excepción.
- Loop Over Items reparte por lotes: trabajo en loop, cierre en done.
- El tamaño del lote y la pausa salen del límite publicado por el servicio.
- Wait de más de 65 segundos guarda la ejecución y la retoma.
- Un bucle manual siempre lleva tope de vueltas.
21
Hazlo ahora
En 10 minutos, con una lista ficticia de 12 ítems:
- Arma un Loop Over Items con Batch Size 4 y un Wait de 5 segundos en la rama loop.
- Conecta un nodo a done y ejecuta.
- Revisa cuántas veces corrió cada nodo y qué recibió el de done.
- Quita la conexión de regreso y observa qué deja de pasar.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026