Cómo utilizar el nodo Loop Over Items (Split in Batches) en n8n

En n8n, el bucle sobre elementos o Loop Over Items, es una de las técnicas más potentes para manejar listas de datos, como direcciones de correo electrónico, respuestas de API o registros de bases de datos.

Aunque muchos nodos n8n procesan los elementos individualmente por defecto, algunas situaciones requieren un mayor control, por ejemplo, cuando se necesita enviar mensajes por lotes o limitar el número de peticiones por ciclo.

Aquí es donde entra en juego el nodo Loop Over Items (Split in Batches). Se define un tamaño de lote, y éste divide el conjunto de datos en grupos más pequeños, procesando cada lote de uno en uno.

Este artículo explica qué significa hacer un bucle en n8n, cómo funciona el nodo Loop Over Items y cuándo utilizarlo. También aprenderás a iterar sobre elementos a través de ejemplos prácticos, como el envío de correos electrónicos masivos y el procesamiento de grandes conjuntos de datos en trozos manejables.

¿Qué significa loop en n8n?

En n8n, el bucle se refiere a la repetición de un conjunto de acciones para cada elemento de una lista o matriz dentro de un flujo de trabajo. Esto te permite automatizar tareas para cada elemento de un conjunto de datos sin intervención manual.

Por ejemplo, si tienes una lista de 100 contactos y deseas enviar un correo electrónico a cada uno de ellos, el bucle permite a n8n procesar cada contacto secuencialmente (enviando un correo electrónico tras otro) en lugar de enviar correos electrónicos masivos a todos ellos a la vez.

Por defecto, muchos nodos n8n procesan las matrices o listas entrantes elemento a elemento. Cuando un nodo recibe una matriz, pasa cada elemento por el flujo de trabajo, de uno en uno.

Pero el bucle explícito se hace necesario cuando un nodo sólo puede manejar un único elemento a la vez, cuando se necesita un mayor control sobre el orden y el procesamiento por lotes de las operaciones o cuando el manejo de demasiados elementos a la vez podría saturar el sistema.

¿Cómo funciona el nodo Loop Over Items en n8n?

El nodo n8n Loop Over Items (Split in Batches) funciona dividiendo una lista entrante de elementos en lotes más pequeños y manejables y procesándolos de uno en uno.

Al definir un tamaño de lote, puedes controlar cuántos elementos fluyen a través de su flujo de trabajo en cada iteración.

Aquí tienes un desglose detallado de cómo funciona:

1. El nodo Loop Over Items (Split in Batches) divide una matriz de elementos de entrada en lotes en función del tamaño que defina, como un elemento por lote.
2. A continuación, cada lote se pasa al siguiente nodo conectado, que realiza la acción deseada, como enviar un correo electrónico o realizar una solicitud de API.
3. Después de procesar un lote, el flujo de trabajo vuelve al nodo Loop Over Items para continuar procesando el siguiente conjunto de elementos.
4. Esta operación se repite automáticamente hasta que se procesan todos los lotes.

El nodo Loop Over Items procesa sólo la lista de elementos que recibe y luego se detiene, por lo que no no debes preocuparte de que haga un bucle eterno.

Pero si lo utilizas para manejar datos paginados, como la obtención de páginas de una API, debes añadir lógica condicional, como un nodo If, para comprobar si hay más páginas.

Esta condición indica al flujo de trabajo cuándo debe detenerse, evitando que pase por páginas vacías.

¿Cuándo utilizar el nodo Loop Over Items?

Debes utilizar el nodo Loop Over Items cuando necesites dividir los datos en trozos más pequeños y procesar los elementos uno a uno.

Esto es especialmente útil para grandes conjuntos de datos, cuando cada elemento requiere una acción individual o cuando deseas controlar el número de elementos procesados en cada iteración.

Algunos ejemplos de cuando usar el nodo Loop Over Items son:

• Enviar correos electrónicos o mensajes individuales a cada contacto de una lista.
• Realizar llamadas API independientes para cada entrada de un conjunto de datos, como la actualización de registros de clientes.
• Procesar registros de una hoja de cálculo o base de datos uno a uno, asegurándose de que cada fila se trata de forma individual.
• Manejo de respuestas API paginadas para obtener todos los datos disponibles de una API a través de múltiples peticiones.
• Generación y envío de informes o facturas personalizados para cada cliente de una lista.
• Supervisar el estado de varios servidores o sitios web comprobando cada uno por separado y registrando los resultados.

¿Cómo se hace un loop over items en n8n?

Para realizar un bucle sobre los elementos en n8n, combina varios nodos para procesar cada elemento individualmente en una lista.

Loop Over Items (Split in Batches) es el nodo principal para esto, pero lo emparejarás con otros nodos, como Edit Fields (Set) para preparar datos, HTTP Request para interactuar con servicios externos e If para añadir lógica o definir condiciones de parada.

Una estructura general para realizar bucles sobre elementos es la siguiente:

1. Input: comienza con un nodo que proporcione una fuente de datos, como Editar campos (Set) u Hojas de Google.
2. Split Out (opcional): añade este nodo si tu nodo de entrada no puede dividir los datos en elementos individuales.
3. Bucle: utiliza el nodo Loop Over Items (Split in Batches) para dividir la lista en lotes más pequeños, normalmente un elemento por lote (o más dependiendo de tus necesidades).
4. Process: añade un nodo de procesamiento, como HTTP Request, si necesitas interactuar con servicios externos, u otros nodos de herramientas de terceros, dependiendo de tu flujo de trabajo.
5. If o Wait (opcional): usa el nodo If para aplicar condiciones o gestionar la paginación y añade Wait para hacer una pausa después de una iteración antes de continuar.
6. End: el bucle finaliza automáticamente una vez procesados todos los elementos.

A continuación, vamos a explorar tres casos de uso prácticos para ver cómo funciona esta configuración en el mundo real.

Envío masivo de correos electrónicos en lotes controlados

En este ejemplo, tienes 100 direcciones de correo electrónico y deseas enviar mensajes en lotes de cinco cada vez, con una pausa de cinco minutos entre lotes.

¿Por qué es necesario el bucle?

Los proveedores de servicios de correo electrónico aplican límites estrictos de velocidad a los mensajes salientes. El envío de 100 mensajes de correo electrónico a la vez puede superar estos límites y provocar fallos o la suspensión temporal de la cuenta.

El bucle con retrasos entre lotes te ayuda a mantenerte dentro de estos límites, conservar una reputación de envío legítima y reducir el riesgo de que tus correos electrónicos se marquen como spam.

Instrucciones para enviar correos masivos en lotes controlados en n8n:

1. Inicio con disparador manual

Arrastra el nodo Manual Trigger al lienzo para iniciar el flujo de trabajo.

2. Prepara la lista de correo electrónicos

Utiliza el nodo Edit Fields (Set) para crear una matriz de 100 direcciones de correo electrónico ficticias. Ajusta lo siguiente:

• Nombre: emails
• Tipo: array
• Valor: ={{ Array.from({length: 100}, (_, i) => email${i + 1}@ejemplo.com) }}

Si ya has conectado n8n a Google Sheets, puedes extraer direcciones de correo electrónico reales de una hoja de cálculo utilizando el nodo Google Sheets.

3. Divide la matriz en elementos individuales

Añade un nodo Split Out y establece el campo en emails para separar la matriz en elementos de email individuales.

4. Agrupa artículos en lotes

Añade el nodo Loop Over Items (Split in Batches) y ajusta el tamaño del lote a 5. Esto procesará los correos electrónicos en grupos de cinco.

5. Envia los correos electrónicos

Utiliza el nodo Send Email para configurar las siguientes opciones:

• Correo electrónico del remitente: la dirección de correo electrónico del remitente
• Para Email: ={{ $json.emails }}
• Asunto: “Correo de prueba”
• Formato de correo electrónico: texto
• Texto: “Hola, este es un email de prueba vía n8n.”

Además, configura las credenciales SMTP de tu proveedor de correo electrónico.

6. Pausa entre lotes

Añade un nodo Wait y establece la unidad en minutos con un valor de 5, creando una pausa de cinco minutos después de cada lote.

7. Bucle hasta que se envíen todos los correos electrónicos

Conecta el nodo Wait de nuevo a Split in Batches para continuar el bucle hasta que se procesen todos los correos electrónicos.

Tratamiento de grandes conjuntos de datos mediante procesamiento por lotes

Imagina que necesitas procesar un gran conjunto de datos respetando los límites de velocidad o las restricciones del sistema. Este flujo de trabajo procesa 500 registros de clientes en lotes de 10.

¿Por qué es necesario el bucle?

Muchas API imponen límites de velocidad, como 100 solicitudes por minuto. Procesar los 500 registros a la vez supera estos límites, provocando fallos.

El bucle divide los datos en trozos más pequeños, lo que evita sobrecargas en n8n y en el sistema de destino y garantiza un procesamiento más fluido y fiable.

Instrucciones para manejar grandes conjuntos de datos con procesamiento por lotes en n8n:

1. Configura el desencadenante del flujo de trabajo

Utiliza el nodo Manual Trigger para iniciar el proceso.

2. Genera registros de clientes

Utiliza el nodo Code para crear 500 registros de clientes ficticios utilizando el siguiente código JavaScript:

const customers = [];
for (let i = 1; i <= 500; i++) {
customers.push({
id: i,
name: `Customer ${i}`,
email: `customer_${i}@example.com`,
registration_date: new Date().toISOString().slice(0, 10)
});
}
return customers.map(customer => ({json: customer}));

Si está disponible, puedes utilizar datos reales de clientes mediante el nodo Google Sheets o PostgreSQL.

3. Divide los datos en lotes

Añade el nodo Split in Batches, establece el tamaño del lote en 10 y desactiva la opción Reiniciar.

4. Pausa entre lotes

Inserta el nodo Wait después de Dividir en lotes para introducir un retardo entre lotes. Ajusta el intervalo a 90 segundos o como prefieras.

5. Establece acciones de tratamiento

Añade el nodo No Operation, do nothing como marcador de posición. Más tarde, sustitúyelo por un nodo HTTP Request para enviar cada lote de clientes a la API de destino, como un CRM o un servicio de correo electrónico.

6. Crearel bucle

Conecta el nodo No Operation, do nothing de nuevo a Split in Batches, para que el bucle continúe hasta que se procesen todos los lotes.

Procesamiento secuencial de varios canales RSS

En este escenario deseas configurar un sistema automatizado que obtenga contenido de múltiples fuentes RSS, por ejemplo los Tutoriales y el Blog de Hostinger secuencialmente, con retrasos controlados.

¿Por qué es necesario el bucle?

Realizar solicitudes simultáneas a varios canales RSS, ya sean del mismo dominio o de dominios diferentes, puede confundirse con un comportamiento agresivo.

Los bucles con retardo ayudan a gestionar los recursos del servidor, reducen el riesgo de bloqueo de IP o limitación de velocidad y garantizan un acceso fiable a las fuentes.

Instrucciones para procesar varios canales RSS secuencialmente en n8n:

1. Activa el flujo de trabajo

Inicia el flujo de trabajo utilizando el nodo Manual Trigger.

2. Define URL de fuentes RSS

Añade el nodo Code para definir las URL de los feeds con este código JavaScript:

return [
{ json: { url: 'https://www.hostinger.com/tutorials/feed' } },
{ json: { url: 'https://www.hostinger.com/blog/feed' } }
];

Modifica o añade más URLs según sea necesario.

3. Divide la alimentación en elementos individuales

En el nodo Split in Batches, establece el tamaño de lote en 1 para procesar un alimento cada vez.

4. Lee canales RSS
   • Conecta el nodo de lectura RSS después de la división en lotes.
   • Establece el parámetro URL en ={{ $json.url }} para utilizar la URL de alimentación dinámica de cada lote.
5. Añade un retardo entre solicitudes

Establece un retardo de 15 minutos en el nodo Wait para evitar que se envíen peticiones demasiado rápido.

6. Crea el bucle

Conecta de nuevo el nodo Wait al nodo de Split in Batches para continuar procesando todas las alimentaciones.

Los mejores consejos para usar el nodo Loop Over Items (Split in Batches)

A continuación algunas buenas prácticas al realizar bucles sobre elementos en n8n para evitar problemas y mantener limpios los flujos de trabajo:

• Utiliza el nodo Split Out cuando tu entrada sea una única matriz JSON que no haya sido dividida en elementos individuales.
• Establece el nodo Loop Over Items (Split in Batches) en un tamaño de lote de 1 para el procesamiento artículo por artículo o auméntalo si el manejo masivo funciona para tu caso.
• Conecta siempre el bucle de vuelta desde tu nodo de procesamiento a Loop Over Items (Split in Batches) para continuar hasta que todos los ítems sean manejados.
• Define una condición de salida clara para evitar bucles infinitos, especialmente cuando trabajes con paginación o lógica de repetición hasta.
• Evita bucles innecesarios, ya que muchos nodos n8n ya admiten entradas de matriz y procesan cada elemento automáticamente.
• Respeta los límites de velocidad de la API añadiendo un nodo de espera entre peticiones para evitar estrangulamientos o bloqueos.
• Mantén tu bucle delgado. Cuantos menos nodos haya en su interior, mejor será el rendimiento y la mantenibilidad.

¿Dónde debes alojar tus flujos de trabajo n8n?

Si estás creando flujos de trabajo n8n que repiten elementos, programan tareas o se ejecutan en producción, necesitas un entorno estable y siempre activo.

Ejecutar el n8n localmente funciona para hacer pruebas, pero tiene inconvenientes importantes: el ordenador debe permanecer encendido y las tareas programadas fallarán si el dispositivo se duerme o pierde el acceso a Internet.

Para un rendimiento y tiempo de actividad fiables, te sugerimos alojar n8n en un servidor privado virtual. Un VPS mantiene tus flujos de trabajo en funcionamiento 24/7, permitiendo un acceso remoto seguro y adaptándose a tus necesidades de automatización.

Con el alojamiento n8n de Hostinger, a partir de AR$ 10899.00/mes, n8n y todos los componentes necesarios vienen preinstalados, por lo que no tienes que instalarlo todo manualmente.

Puedes ejecutar automatizaciones avanzadas sin interrupción, con el apoyo de un hardware y una infraestructura potentes que garantizan un tiempo de actividad del 99.9%.

Escalar es sencillo. Con hasta 8 núcleos vCPU, 32 GB de RAM, 400 GB de almacenamiento NVMe y 32 TB de ancho de banda, puedes empezar con poco y actualizar con solo unos clics a medida que crezcan tus flujos de trabajo.

¿Qué sigue después de aprender a usar loop over items bucles en n8n?

Ahora que hemos visto cómo hacer bucles sobre elementos en n8n, puedes empezar a utilizar uno de los patrones más potentes para crear flujos de trabajo dinámicos y flexibles.

Bien sea enviar correos electrónicos personalizados, procesar datos API paginados o sincronizar entradas entre herramientas, el bucle te ofrece un control total para automatizar tareas lote a lote.

A partir de aquí, intenta acciones avanzadas para escalar, optimizar y combinar el bucle con otra lógica, como por ejemplo:

• Fusiona los resultados procesados utilizando el nodo Merge.
• Activa flujos de trabajo de seguimiento o llamadas a la API en función del resultado del bucle.
• Almacena o analiza datos en bases de datos, hojas de cálculo o cuadros de mando.
• Envía notificaciones resumidas por correo electrónico, Slack u otros canales.
• Limpia los datos temporales o las entradas de registro para futuros seguimientos.

Además, para crear una automatización más inteligente, explora más ejemplos de flujos de trabajo n8n para ver cómo el looping encaja en configuraciones más grandes y avanzadas.