Flujo de datos

Flujo de datos es el módulo que conecta tus fuentes de datos con las herramientas de voz del cliente de woku. En lugar de exportar registros y hacer envíos a mano, defines una vez qué debe pasar con cada fila de la fuente y woku lo ejecuta por ti. Lo encuentras en el grupo Datos del menú lateral, junto a Fuente de datos.

​

Qué es un flujo de datos

Un flujo de datos es una receta guardada que recorre los registros de una fuente de datos publicada y decide, fila por fila, qué acción ejecutar: enviar una encuesta, invitar a dejar una opinión, crear un cliente o actualizar sus datos. Cada flujo trabaja sobre una sola fuente, y cada registro puede disparar como máximo una acción. Si un registro no cumple las condiciones del flujo, se descarta o queda en espera, según lo que definas.

​

Crear un flujo

La creación tiene dos pasos:

1. Elegir fuente: seleccionas la fuente de datos sobre la que trabajará el flujo. Solo aparecen las fuentes publicadas.
2. Construir y probar: defines la lógica del flujo conversando con el agente, revisas el resultado y lo pruebas con simulaciones hasta que haga exactamente lo que esperas.

​

Construir con el agente

El constructor es conversacional. Describes en lenguaje natural qué quieres hacer, por ejemplo “envía un NPS por WhatsApp a cada cliente con compra entregada, y si no tiene teléfono usa el email”, y el agente genera dos representaciones sincronizadas del flujo:

• Código: el código JavaScript completo que se ejecutará sobre cada registro. Puedes editarlo a mano si prefieres ajustar algo directamente.
• Pseudocódigo: una descripción humana del flujo con su título, qué pasará al ejecutarlo, las transformaciones aplicadas y cada regla con el comando que dispara.

El agente conoce los instrumentos de voz del cliente de tu empresa (encuestas NPS, CSAT, CES, wokus y formularios) y los resuelve por nombre, así que puedes pedirle “envía la encuesta de postventa” sin buscar identificadores. También propone un nombre y una descripción para el flujo, que puedes cambiar antes de guardar. La conversación con el agente se guarda junto con el flujo, por lo que puedes retomarla más adelante para pedir ajustes con todo el contexto anterior. El editor tiene tres pestañas: Código, Pseudocódigo y Simulación.

​

Acciones disponibles

Estas son las acciones que un flujo puede ejecutar por cada registro: Además de las acciones, el código del flujo cuenta con:

• Transformaciones: setField modifica un campo del registro antes de evaluar las reglas y setClientField prepara cambios en los datos del cliente.
• Control de fila: discardRecord descarta el registro y hold lo deja en espera, sin acción.
• Ayudas: normalizePhone normaliza teléfonos a formato internacional, hasContent verifica que un campo tenga contenido y lookupSingle busca un valor en otra parte de la fuente.

​

Probar el flujo

La pestaña Simulación ejecuta el código sobre la muestra guardada de la fuente en un entorno aislado. Es una prueba segura: no se envía ningún mensaje ni se modifica ningún cliente. El resultado incluye:

• Un titular con cuántos registros recibirían la encuesta.
• Un desglose por resultado: envíos por canal, registros que no cumplen las condiciones, registros sin canal disponible, clientes que se actualizarían y errores.
• Ejemplos de registros con el detalle Ver acción: los datos usados, las condiciones evaluadas, las transformaciones aplicadas, los cambios en el cliente y el resultado final de esa fila.
• Una validación del flujo: que la fuente esté disponible, que los campos referenciados existan, que los canales estén disponibles y que los comandos y las reglas sean válidos.

Si la fuente aún no tiene muestra, la simulación usa datos sintéticos y lo avisa. En ese caso el resultado sirve para revisar la lógica, pero no refleja tus datos reales.

​

Ejecutar el flujo

La ejecución es manual. Al presionar Ejecutar, un modal de confirmación resume el resultado de la última simulación para que sepas qué va a pasar antes de confirmar. Al confirmar, el flujo procesa los registros de la muestra de la fuente y ejecuta las acciones reales sobre los que cumplen las condiciones: se envían las encuestas NPS, CSAT y CES, las invitaciones woku y los formularios por el canal que corresponda, y se crean los clientes nuevos. La ejecución queda registrada en el historial. Si la fuente no tiene una muestra real, la ejecución se bloquea hasta que la fuente la tenga.

​

Historial y versiones

Cada ejecución queda en el historial con su fecha, la versión del flujo usada, quién la ejecutó, cuántos registros se revisaron, el resultado y los errores. Puedes abrir el detalle por registro para ver qué pasó con cada fila. El código del flujo está versionado: al ejecutar, si el código cambió desde la última ejecución, se congela una nueva versión. Desde el historial de versiones puedes ver cualquier versión anterior en modo solo lectura y restaurarla como la versión actual.

​

Límites

• La ejecución es manual. No hay programación automática de ejecuciones.
• Tanto la simulación como la ejecución operan sobre la muestra guardada de la fuente, con un máximo de 50 registros por corrida.
• Cada registro dispara como máximo una acción.
• La actualización de datos de un cliente existente se refleja en la simulación, pero todavía no se aplica en la ejecución real. En la ejecución real se despachan las encuestas, las invitaciones, los formularios y la creación de clientes nuevos.
• El detalle por registro del historial muestra hasta 50 filas.