Cómo recuperar funciones en Zoho

Recuperar funciones en Zoho CRM te permite localizar, revisar y reutilizar la lógica personalizada ya implementada en tu organización, ahorrando tiempo y evitando código duplicado en tus automatizaciones.

Por qué es importante

Cuando tu equipo crea automatizaciones, flujos de trabajo o integraciones, las funciones personalizadas se acumulan rápidamente. Poder recuperar e inspeccionar esas funciones significa que puedes auditar la lógica antes de ejecutarla, invocar una función desde dentro de otra y pasar los parámetros correctos sin necesidad de adivinar. Esto es especialmente relevante al conectar Zoho CRM con servicios externos u otros productos de Zoho. Como soporte experto independiente (no soporte oficial de Zoho), Beam Help te guía a través de los pasos clave a continuación.

Paso a paso

Paso 1. Navega al área de configuración de Funciones dentro de tu aplicación de Zoho. Para Zoho CRM, ve a Configuración → Espacio para desarrolladores → Funciones. Aquí se listan todas las funciones personalizadas disponibles en tu cuenta, incluidas las independientes que pueden invocarse externamente. ^[1]

Paso 2. Identifica la función que deseas recuperar. Cada función tiene un nombre único (por ejemplo, createcontact1) que forma parte de su endpoint de ejecución. Toma nota de este nombre: lo necesitarás para invocar o inspeccionar la función de forma programática. ^[1]

Paso 3. Para recuperar o invocar una función desde dentro de otra función, utiliza la tarea Deluge invokeurl. Construye la solicitud apuntando al endpoint de ejecución de la función. Para Zoho FSM, el patrón es el siguiente:

rest = invokeurl
[
  url: "https://fsm.zoho.com/fsm/v1/functions/<function_name>/actions/execute?auth_type=oauth"
  type: GET
  parameters: {"Last_Name":"Robins","Email":"lucy.robins@zylker.com"}
  headers: Map()
  connection: "fsm"
];
return rest;

Adapta la URL base y el nombre de la conexión para que coincidan con tu entorno de Zoho CRM. ^[1]

Paso 4. Autentica la solicitud correctamente. Las llamadas a funciones independientes requieren OAuth. Necesitarás un Token de acceso válido obtenido desde https://accounts.zoho.com/oauth/v2/token, y el alcance debe incluir el permiso de funciones correspondiente (por ejemplo, ZohoFSM.settings.functions.CREATE en FSM — verifica el alcance equivalente de CRM en tu consola de desarrollador). ^[5]

Paso 5. Examina el payload de la respuesta. Cuando la función se ejecuta correctamente, los mensajes de registro info que emite tu función se devuelven bajo la clave userMessage, mientras que el valor de retorno real de la función aparece bajo la clave output. Usa estas claves para verificar que la función se ejecutó como se esperaba y para extraer los datos que necesitas. ^[5]

Paso 6. Si necesitas llamar a la función desde una automatización de flujo de trabajo en lugar de desde otra función, puedes configurarla mediante una acción de flujo de trabajo de Función personalizada. Dentro del editor Deluge para esa acción, utiliza el mismo patrón invokeurl descrito anteriormente, proporcionando la URL correcta, el método HTTP (GET o POST), los parámetros y el nombre de la conexión. ^[7]

Paso 7. Para gestionar la función después de recuperarla — por ejemplo, para editar su lógica, clonarla para un nuevo caso de uso o eliminar una versión desactualizada — regresa a la lista de Funciones en Configuración y utiliza el menú de acciones en línea junto al nombre de la función. Las opciones disponibles incluyen Editar, Eliminar y Clonar. ^[1]

Errores comunes

• Método HTTP incorrecto para tu tipo de entrada. Los parámetros pueden pasarse mediante GET (añadidos a la cadena de consulta) o POST (en el cuerpo de la solicitud). Mezclarlos provoca que la función reciba entradas vacías. Asegúrate siempre de que el método coincida con la forma en que tu función lee APIRequest. ^[5]
• Alcance OAuth ausente o incorrecto. Si el token de acceso se generó sin el alcance de funciones requerido, la llamada a la API será rechazada. Regenera el token con el alcance correcto antes de volver a intentarlo. ^[5]
• Invocar una función que no es independiente. Solo las funciones publicadas explícitamente como independientes pueden invocarse mediante el patrón de URL externo. Las funciones exclusivas de flujos de trabajo no son accesibles de esta manera. ^[1]
• Múltiples entradas de búsqueda en acciones de recuperación. Al recuperar registros como parte de la lógica de una función, proporcionar demasiadas entradas de campos únicos puede producir un comportamiento de coincidencia AND/OR inesperado. Utiliza el número mínimo de campos únicos necesarios para identificar un registro. ^[8]

Qué verificar

• Confirma que el nombre de la función en la URL coincide exactamente con el nombre que aparece en la lista de Funciones — una sola diferencia de caracteres devolverá un error 404. ^[1]
• Verifica que la clave output en la respuesta contiene el valor de retorno esperado antes de construir la lógica posterior que depende de él. ^[5]
• Asegúrate de que la conexión OAuth referenciada en el parámetro connection de invokeurl esté activa y no haya expirado ni sido revocada. ^[7]