Deluge es el lenguaje de scripting de Zoho CRM que te permite automatizar actualizaciones de campos y operaciones de datos complejas mediante programación. Puedes usar funciones Deluge para modificar campos personalizados en registros, validar datos antes de guardarlos y activar actualizaciones en módulos relacionados.
Por qué esto es importante
Las actualizaciones de campos personalizados a través de Deluge son esenciales cuando necesitas automatizar cambios de datos que van más allá de los flujos de trabajo estándar, sincronizar datos entre módulos o aplicar lógica de negocio que la interfaz de usuario por sí sola no puede manejar. Este enfoque es especialmente útil durante migraciones de datos, operaciones masivas o al integrar Zoho CRM con sistemas externos.
Paso a paso
Paso 1. Accede al editor Deluge en Zoho CRM.
Navega a tu espacio de trabajo de Zoho CRM y abre la sección de automatización donde se gestionan las funciones personalizadas. Deluge es el lenguaje de scripting interno disponible en todos los productos de Zoho para realizar operaciones como llamadas a API, consultas a bases de datos y manipulaciones de datos [3].
Paso 2. Escribe una función para dirigirte al campo personalizado.
Crea una función Deluge que haga referencia al campo personalizado por su nombre de API. Puedes encontrar el nombre de la API haciendo clic derecho en el campo en tu módulo de CRM y seleccionando la opción para ver los detalles del campo. Usa el identificador de campo correcto (metaApiName o inputApiName) para asegurar que el sistema reconozca el campo que deseas actualizar [2].
Paso 3. Usa la sintaxis Deluge apropiada para actualizar el valor del campo.
Estructura tu script para asignar un nuevo valor al campo personalizado. La sintaxis exacta depende de si estás actualizando un solo registro, varios registros o extrayendo datos de módulos relacionados. Por ejemplo, si necesitas actualizar un campo de fecha de un módulo a otro, es posible que debas recuperar primero el valor de origen y luego aplicarlo al campo de destino [5].
Paso 4. Prueba la función con datos de ejemplo.
Antes de implementar en producción, ejecuta tu función Deluge en un registro de prueba para verificar que el campo personalizado se actualiza correctamente. Comprueba que el valor aparezca en el campo y que no ocurran errores de validación. Si encuentras un error "PATTERNNOTMATCHED", verifica que estás utilizando el nombre de API de campo correcto [2].
Paso 5. Integra la función en tu flujo de trabajo o regla de automatización.
Una vez probada, activa la función Deluge desde una regla de flujo de trabajo, una acción de botón o una tarea programada. Esto asegura que la actualización del campo personalizado se ejecute automáticamente cuando se cumplan las condiciones especificadas, en lugar de requerir ejecución manual cada vez [4].
Errores comunes
Los nombres de API de los campos distinguen entre mayúsculas y minúsculas y deben coincidir exactamente como aparecen en la configuración de tu CRM. Si tu campo personalizado no aparece en la respuesta de la API o recibes un error de coincidencia de patrones, verifica el nombre de la API inspeccionando las propiedades del campo directamente en la configuración del módulo [2].
Al actualizar campos en módulos relacionados, asegúrate de tener el ID de registro correcto y de que la relación entre los módulos esté definida correctamente. Intentar actualizar un campo en un tipo de registro que no tiene acceso a ese campo hará que la operación falle silenciosamente o genere un error [5].
Qué comprobar
- Confirma que el nombre de la API del campo personalizado coincide exactamente con lo que ingresaste en tu script Deluge.
- Verifica que el ID del registro al que te diriges existe y pertenece al módulo correcto.
- Prueba la función primero en un registro no crítico para asegurar que la actualización produce el resultado esperado antes de ejecutarla en datos de producción.
---
Nota: Este artículo es proporcionado por Beam Help, soporte experto independiente para Zoho, no es soporte oficial de Zoho. Para documentación oficial, consulta directamente el portal de ayuda de Zoho.