¿Cómo puedo…?

• Configurar las funciones
• Llamar a una función utilizando las API REST
• Implementar funciones en las reglas de flujo de trabajo
• Consultar los códigos de error
  • Códigos de estado de HTTP
  • Errores personalizados
• Ejemplos de algunas de las funciones de uso frecuente
  [Temas relacionados]

Configurar las funciones

Puede configurar funciones en cinco lugares:

• Cree una función independiente.
• Asocie una función a una regla de flujo de trabajo.
• Incluya las funciones en la Programación para usarlas más adelante.
• Configure la función para que se ejecute cuando se haga clic en un botón personalizado.
• Asocie una función a una lista relacionada.

Para crear una función

1. Vaya a Configuración > Espacio para desarrolladores > Funciones.
2. En la página de funciones, haga clic en + Crear nueva función.
3. Elija el lugar al que se debe agregar la función.
   
4. Haga clic en Siguiente.
5. En la página de creación de función, haga lo siguiente:
   • Indique un nombre y una descripción (opcional) a la función.
   • Haga clic en Editar argumentos.
   • Establezca los argumentos que se utilizarán en el script, con el nombre de campo o valor personalizado, en el módulo de CRM.
     
   • Cree la función que necesite en el Editor de Deluge Script.
     
   • Haga clic en Guardar y ejecutar script para validar su código.
   • Haga clic en Guardar.
6. Haga clic en Guardar.
   La función se incluirá en la vista de lista de la página de funciones.
   Tenga en cuenta que las funciones especificadas su uso en un lugar en específico no se pueden utilizar en ningún otro lugar. Por ejemplo, una función configurada para su uso en las reglas de flujo de trabajo no se puede usar en la programación.

Llamar a funciones mediante las API REST

Una función permite que tenga funciones y características adicionales en CRM, además de las convencionales. Para llamar a la función, es necesario un activador. El activador puede ser un flujo de trabajo, blueprint, lista relacionada o el clic de un botón.

Si es necesario activar la función sin que se empleen estos métodos o desde fuentes externas, puede crear funciones independientes y proporcionarlas como solicitudes de API. Activar funciones a través de las API REST le proporciona la flexibilidad para activarlas desde cualquier lugar dentro de Zoho CRM o desde cualquier aplicación de terceros.

Ejemplo de función como una llamada a la API:

Un formulario que automáticamente genera un cliente potencial en CRM con la información proporcionada en el formulario.

Paso 1:

Cree una función independiente con el siguiente código.

Paso 2:

Para proporcionar la función como una API

1. Vaya a Configuración > Espacio para desarrolladores > Funciones.
2. Haga clic en el ícono de Ajustes de la función correspondiente que quiere convertir en una API.
3. Haga clic en API REST.
   
4. Establezca el nombre de la API de la función personalizada.
5. Habilite los controles deslizantes de OAuth2.0 y de la Clave API.
6. Haga clic en Guardar.
   

Paso 3:

El ejemplo se muestra como un formulario creado con Zoho Creator. Cree un formulario que tenga los campos "FirstName", "LastName", "Company" y "Mobile". Puede programar la función para que se ejecute cuando se haga clic en el botón Enviar.

Resultado:

Una vez que se haga clic en el botón Enviar, la función se ejecutará y se creará el cliente potencial en CRM. El cliente potencial tendrá los detalles brindados en el formulario.

Funciones de Postman:

Las funciones proporcionadas como solicitudes de API se pueden probar usando la aplicación POSTMAN. Sin embargo, hay algunos aspectos que debe tener en consideración a la hora de ejecutar una función en esa aplicación.

• Los actuales métodos compatibles para utilizar una función como una API son GET y POST.
• En una solicitud POST, en la sección "cuerpo", seleccione "form-data".
• Cree una clave que se llame "arguments" y que el valor sea el objeto JSON de entrada.
• También puede brindar los argumentos en la dirección URL como arguments={encoded_arguments}
• Solicitud POST: límite de argumentos
  • En la dirección URL de solicitud: 5000 líneas
  • En el cuerpo: 95 000 líneas (como objeto JSON).

Ejemplo de argumento en el "cuerpo":

Implementar funciones en las reglas de flujo de trabajo

Para asociar una función a una regla de flujo de trabajo

1. Vaya a Configuración > Automatización > Automatización de flujo de trabajo > Reglas.
2. En la página Reglas de flujo de trabajo, haga clic en Crear regla.
3. En la pestaña Crear nueva regla, especifique los parámetros de la regla de flujo de trabajo.
4. En Acciones instantáneas, seleccione función.
   
5. En la página de configuración de funciones, seleccione una función de la galería, funciones (creadas por los usuarios de su organización) o la opción escribir sus propias funciones usando Deluge Script.
6. Haga clic en Funciones (creadas por los usuarios de su organización).
   
7. Seleccione la función que se debe activar y haga clic en Configurar.
   
8. En la página de configuración de funciones personalizadas, complete los siguientes pasos:
   • Seleccione el módulo con el que la desea asociar.
   • En la sección de asignación de argumentos, asigne el argumento con el nombre de campo correspondiente en el módulo de CRM.
     
   • Haga clic en Guardar y asociar.
     Ahora, podrá asociar la función personalizada de la galería con la regla de flujo de trabajo.
9. Haga clic Guardar en la página de la regla de flujo de trabajo.
   Ahora, su función personalizada estará asociada con la regla de flujo de trabajo. Cuando se active la regla de flujo de trabajo, la función personalizada se ejecutará automáticamente.