Disponible en el plan Corporate. Esta funcionalidad forma parte de las capacidades empresariales de woku. Conversa con nuestro equipo comercial.
Dónde viven las transformaciones
Las transformaciones forman parte de un flujo de datos. Un flujo trabaja sobre 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. Antes de evaluar esas reglas, el flujo puede transformar cada registro: limpiar valores, derivar campos nuevos, normalizar formatos o descartar filas que no sirven. Encuentras el módulo en el grupo Datos del menú lateral, junto a Fuente de datos.Cómo se construye una transformación
No escribes la transformación desde cero. El constructor del flujo es conversacional:1
Describe lo que necesitas
En el chat del constructor explicas en lenguaje natural qué quieres
hacer, por ejemplo “combina nombre y apellido en un solo campo, clasifica
el NPS en promotor, pasivo o detractor, y descarta las filas sin email ni
teléfono”.
2
El agente genera el código
El agente escribe el código JavaScript completo del flujo, incluidas las
transformaciones, y lo muestra en dos representaciones sincronizadas:
Pseudocódigo, una descripción humana de cada paso, y Código, el
JavaScript real, que puedes editar a mano si prefieres ajustar algo
directamente.
3
Valida con una simulación
La pestaña Simulación ejecuta el código sobre los registros de
muestra de la fuente, sin enviar mensajes ni modificar clientes, y te
muestra el efecto de cada transformación fila por fila.
Transformación de campos
Dentro del código del flujo, las transformaciones operan sobre cada registro con operaciones explícitas:setField deriva o modifica un campo,
discardRecord descarta la fila con un motivo, y hold la deja en espera
sin acción. También hay ayudas como normalizePhone, que lleva teléfonos a
formato internacional, y hasContent, que verifica que un campo tenga
contenido real.
Estos son ejemplos de fragmentos como los que genera el agente, y que puedes
ajustar en la pestaña Código:
Simulación y versiones
La pestaña Simulación es la forma de validar una transformación antes de que toque datos reales. Ejecuta el código sobre la muestra guardada de la fuente y devuelve un desglose por resultado, ejemplos de registros con el detalle de las transformaciones aplicadas a cada fila, y una validación de que los campos referenciados existen y los comandos son válidos. 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 puedes ver cualquier versión anterior en modo solo lectura y restaurarla como la versión actual, y cada ejecución queda registrada con la versión que usó.Ejecución y aislamiento del runtime
La ejecución del flujo es manual y corre siempre del lado del servidor. El código se ejecuta en un contexto aislado, sin acceso a red ni al sistema de archivos: solo puede leer el registro de entrada y expresar qué hacer con él mediante las operaciones del flujo. No expones credenciales ni mantienes infraestructura propia.Buenas prácticas
- Tolerancia a nulos: los datos de origen pueden venir incompletos; usa
??yhasContentantes de calcular o concatenar. - Campos derivados explícitos: prefiere crear campos nuevos
(
fullName,npsCategory,purchaseDate) en lugar de sobrescribir los originales, para que las reglas del flujo y el detalle de la simulación sean fáciles de leer. - Descarta con motivo: cuando una fila no sirve, usa
discardRecordcon un motivo claro. El motivo aparece en la simulación y en el historial, y facilita entender por qué un registro no generó acción. - Simula antes de ejecutar: valida la transformación en la pestaña Simulación y revisa el detalle por fila antes de ejecutar el flujo con envíos reales.