Nodo Bucle de lista

El nodo Bucle de lista (Loop List) recorre una lista y ejecuta los nodos siguientes una vez por cada elemento. Ideal para procesar varios contactos, filas de una hoja o resultados de una búsqueda.

Parámetros

Campo	Por defecto	Descripción
Ruta al array	—	Expresión que apunta a la lista (ej. {{nodes.sheets.rows}})
Tamaño de lote	0 (todos)	Cuántos elementos procesar por tanda
Máximo de iteraciones	0 (sin tope propio)	Límite de vueltas
Acumulador	No	Acumula un valor entre iteraciones
Valor del acumulador	—	Expresión que se acumula
Nombre de salida del acumulador	accumulated	Cómo se llama el resultado acumulado

Tope de seguridad: máximo 1000 iteraciones por ejecución.

Cómo conectar el nodo

El Bucle de lista tiene tres conexiones distintas:

• Loop → conecta al primer nodo del cuerpo del loop (ej. un nodo HTTP Request).
• ← Return el último nodo del cuerpo del loop conecta de vuelta aquí, para cerrar cada vuelta.
• Done → continúa el flujo con el resultado acumulado (si el acumulador está habilitado) una vez que termina el loop.

Variables dentro del loop

Dentro de cualquier nodo conectado al cuerpo del loop (entre Loop → y ← Return), estas variables están disponibles vía nodes.<nombre_del_nodo>.*:

Variable	Descripción
item	Elemento actual del array
index	Índice actual (0, 1, 2…)
total	Total de items
noItemsLeft	true si es el último item
currentRunIndex	Índice del lote (run), útil con tamaño de lote > 1
batchIndex	Posición dentro del lote actual

Salidas

Dos ramas:

• loop — se ejecuta por cada elemento, con las variables de la tabla anterior.
• done — se ejecuta al terminar. Incluye items, total, processedCount y el acumulador (si está habilitado, en {{nodes.<nombre_del_loop>.<nombre_de_salida>}}).

Ejemplo

Enviar un WhatsApp a cada contacto de una lista:

• Ruta al array: {{nodes.sheets.rows}}
• Rama loop → WhatsApp a {{nodes.bucle.item.telefono}}
• Rama done → Slack: “Envié a {{nodes.bucle.total}} contactos”

Problemas comunes

• Se detiene en 1000 — es el tope duro; para volúmenes mayores procesa por lotes (tamaño de lote) o divide en varias ejecuciones.
• item está vacío — verifica que la ruta al array apunte realmente a una lista (míralo en la ejecución).