Antes de profundizar en su funcionamiento, es importante entender un concepto base: las Listas de Datos (Arrays).
En el mundo de las integraciones, la información a veces no llega sola, sino en grupos. Por ejemplo, un "Negocio" en un CRM puede tener varios productos asociados. Cada producto es una Fila y el conjunto de productos es una Lista.
Ejemplo de objeto JSON:
{ "nombreNegocio": "Venta Corporativa", "items": [ { "nombre": "Licencia IA", "cantidad": "2" }, { "nombre": "Soporte Técnico", "cantidad": "1" } ] }El Iterator Tool está diseñado para tomar cada elemento de esa lista individualmente. Esto garantiza que cualquier paso posterior en el flujo se ejecute el mismo número de veces que elementos haya en la lista.
Nota: El Iterator se utiliza comúnmente después de acciones de "Búsqueda de múltiples registros".
¿Qué desafíos resuelve el Iterator Tool?
Imagina que tienes una base de datos con clientes que tienen facturas pendientes y quieres automatizar el envío de recordatorios. Si un cliente tiene 3 facturas, no quieres enviar un correo genérico, sino procesar cada factura por separado.
Ejemplo de uso del Iterator:
Disparador (Trigger): El flujo se activa al finalizar el mes.
Búsqueda de Datos: Darwin busca en tu CRM todos los pagos pendientes de un cliente (esto devuelve una lista).
Iterator Tool: Aquí es donde entra la herramienta. El iterador recorre cada factura de la lista una por una:
Extrae el número de factura, el monto y la fecha de vencimiento de cada ítem.
Formatea los detalles para cada mensaje.
Acción: Por cada factura encontrada, el flujo puede realizar una acción, como enviar un mensaje de WhatsApp individualizado o actualizar el estado de cada ítem en una hoja de cálculo.
Cómo acceder y configurar el Iterator Tool
Para aplicar lógica de iteración en tu flujo, sigue estos pasos:
Identifica la lista: Abre la automatización y asegúrate de tener un paso previo que genere una lista de datos (como una búsqueda múltiple).
Añade la herramienta: Haz clic en el botón "+" (Plus) debajo del paso que contiene la lista.
Selecciona "Tool": Elige la opción Tool y luego selecciona Iterator.
Configura el origen: En la configuración del Iterator, selecciona el campo que contiene el "Array" o lista que deseas desglosar.
Configura los pasos siguientes: Cualquier módulo que coloques después del Iterator se repetirá automáticamente por cada elemento de la lista.
✅ Recomendación
Si vas a enviar mensajes masivos basados en una lista (por ejemplo, notificar a 20 contactos encontrados en una búsqueda), te recomendamos colocar un Delay Tool justo después del Iterator. Esto evitará que los mensajes salgan todos en el mismo segundo, protegiendo tu reputación de envío y evitando bloqueos.
Preguntas Frecuentes (FAQs)
¿Qué pasa si la lista está vacía? Si el Iterator no encuentra elementos en la lista, los pasos siguientes simplemente no se ejecutarán y el flujo finalizará correctamente sin errores.
¿Puedo editar los datos dentro del iterador? ¡Sí! Puedes usar herramientas de formato (como un formateador de texto o números) dentro del ciclo del iterador para que cada ítem se procese con el formato correcto antes de llegar a su destino final.
¿Es lo mismo que un "Loop"? Sí, en términos de programación, el Iterator funciona como un ciclo for-each, recorriendo cada objeto de una colección de principio a fin.