Cómo recuperar la próxima mejor experiencia de ZIA en Zoho CRM

La función Next Best Experience (NBX) de Zia en Zoho CRM muestra recomendaciones de acciones contextuales impulsadas por IA para un registro determinado — y puedes recuperar esas sugerencias de forma programática a través de un endpoint de API dedicado.

Por qué esto es importante

Los equipos de ventas que trabajan con pipelines extensos necesitan orientación oportuna e inteligente sobre qué acción tomar a continuación para cada oportunidad o lead. En lugar de acceder manualmente a las sugerencias de NBX desde la interfaz del CRM, los desarrolladores e integradores pueden llamar directamente al endpoint de NBX para incorporar esas recomendaciones en paneles externos, flujos de trabajo de automatización o aplicaciones personalizadas. Esto resulta especialmente útil cuando deseas activar lógica de venta guiada fuera de la interfaz estándar de Zoho CRM.

Paso a paso

Paso 1. Comprende qué devuelve el endpoint.

La API de Zia NBX recupera la recomendación de próxima mejor experiencia para un registro específico del CRM. Zia analiza cada punto de contacto relevante — interacciones, señales y transacciones — para producir sugerencias accionables y contextuales que te ayudan a nutrir leads, retener clientes y optimizar tu pipeline. ^[2]

Paso 2. Identifica los dos parámetros de ruta requeridos.

El endpoint requiere exactamente dos parámetros: m (el nombre del módulo, p. ej. Leads, Contacts, Deals) y rid (el ID único del registro dentro de ese módulo). Ambos son segmentos posicionales en la ruta de la URL. ^[5]

Paso 3. Construye la solicitud HTTP.

Envía una solicitud HTTP GET al siguiente patrón de ruta:

GET /{m}/{rid}/zia/nbe

Reemplaza {m} con el nombre de API del módulo de destino y {rid} con el ID del registro. Por ejemplo, para recuperar datos de NBX de un registro de Deal, la ruta sería:

GET /Deals/4876XXXXXXXXX/zia/nbe

^[5]

Paso 4. Llama a la operación usando el helper del SDK (si corresponde).

Si utilizas el cliente Python de Zoho CRM o una capa de integración basada en zpilot, la operación se expone como getzianextbestexperience. Pasa el nombre del módulo como primer argumento (m) y el ID del registro como segundo (rid): [^1, ^5]

result = client.get_zia_next_best_experience(m="Deals", rid="4876XXXXXXXXX")

El método ejecuta internamente la solicitud GET /{m}/{rid}/zia/nbe y devuelve la respuesta procesada. ^[5]

Paso 5. Interpreta la respuesta en contexto.

El payload de NBX contendrá las acciones recomendadas por Zia para ese registro. Estas sugerencias se basan en el historial completo de puntos de contacto del registro, por lo que cuanto más ricos sean los datos en tu CRM (correos electrónicos, llamadas, transacciones, señales), más precisa será la recomendación. ^[2]

Paso 6. Opcionalmente, muestra NBX mediante botones personalizados en la interfaz.

Si prefieres un enfoque sin código, Zoho CRM también te permite asociar prompts con botones personalizados. Cuando un usuario hace clic en el botón sobre un registro, Zia ejecuta el prompt asociado y devuelve una salida contextual a ese registro específico del CRM — lo que te ofrece efectivamente una versión en la interfaz de la experiencia NBX sin necesidad de escribir llamadas a la API. ^[2]

Errores comunes

• Nombre de API del módulo incorrecto: El parámetro m debe coincidir exactamente con el nombre de API del módulo (p. ej. Leads y no Lead, Deals y no Deal). Una discrepancia resultará en una solicitud fallida. ^[5]
• ID de registro inválido o inaccesible: Si rid no corresponde a un registro al que el usuario autenticado pueda acceder, la API devolverá un error. Confirma siempre que el registro existe y que tu token OAuth tiene el scope de CRM adecuado. ^[5]
• Datos insuficientes para las recomendaciones: La calidad de NBX depende del volumen y la variedad de puntos de contacto registrados en el registro. Los registros con poca actividad pueden devolver sugerencias limitadas o ninguna. Asegurarte de que las interacciones, señales y transacciones se capturen de forma consistente mejorará la calidad de los resultados. ^[2]

Qué verificar

• Confirma que el valor de m coincide exactamente con el nombre de API del módulo de destino y que rid es un identificador de registro válido y accesible antes de realizar la llamada. ^[5]
• Verifica que tu token OAuth de Zoho CRM tenga los permisos de Zia/IA necesarios, ya que NBX es una función impulsada por IA que puede requerir que se habiliten scopes específicos. ^[1]
• Tras recibir la respuesta, contrasta la acción sugerida con la etapa actual del registro en el pipeline para asegurarte de que la recomendación se alinea con tu lógica de venta guiada esperada. ^[2]

---

*Beam Help es un recurso de soporte experto independiente para productos Zoho y no es el soporte oficial de Zoho. Valida siempre el comportamiento de la API según tu edición y plan específicos de Zoho CRM, ya que la disponibilidad de funciones puede variar.*