Cómo recuperar reglas de puntuación en Zoho

Recuperar reglas de puntuación en Zoho CRM es sencillo una vez que conoces el endpoint correcto de la API y el parámetro de módulo que requiere.

Por qué esto es importante

Las reglas de puntuación en Zoho CRM te permiten clasificar automáticamente leads, contactos, negocios y otros registros según los criterios que definas. Si estás creando integraciones, auditando tu configuración de CRM o sincronizando la lógica de puntuación con un sistema externo, necesitarás una forma fiable de obtener estas reglas de manera programática. Conocer el endpoint exacto y sus parámetros ahorra tiempo y evita llamadas a la API mal configuradas.

Paso a paso

Paso 1. Asegúrate de que tu conexión OAuth incluya los scopes necesarios de Zoho CRM antes de realizar cualquier llamada a la API. El grupo de scopes requerido para la configuración a nivel de organización es ZohoCRM.org.ALL, que cubre la lectura de datos de configuración del CRM, como las reglas de puntuación. ^[3]

Paso 2. Autentica tu cliente y obtén un token de acceso válido. El token se obtiene intercambiando un código de autorización o renovando un token existente a través del endpoint de tokens OAuth de Zoho. Una vez obtenido, el token de acceso se pasa como token Bearer en el encabezado Authorization de cada solicitud posterior. ^[7]

Paso 3. Llama al endpoint de reglas de puntuación mediante una solicitud HTTP GET:

GET /settings/scoring_rules

Este endpoint está categorizado dentro de la configuración de puntuación y asignación en Zoho CRM. ^[1]

Paso 4. Pasa el parámetro module para especificar de qué módulo de CRM deseas recuperar las reglas de puntuación. Por ejemplo, para obtener las reglas de puntuación del módulo Leads, proporciona module=Leads como parámetro de consulta. El parámetro es obligatorio: omitirlo no devolverá resultados significativos. ^[1]

Paso 5. Si trabajas en Python, la llamada puede encapsularse como se muestra a continuación. El método acepta el nombre del módulo como cadena de texto (m) y realiza la solicitud GET con {"module": m} como parámetros de consulta:

def get_scoring_rules(self, m: str):
    return self.c.request("GET", "/settings/scoring_rules", {"module": m})

Este patrón mantiene el nombre del módulo flexible para que puedas iterar sobre varios módulos (por ejemplo, Leads, Contacts, Deals) sin duplicar código. ^[1]

Paso 6. Analiza la respuesta. La API devolverá las reglas de puntuación configuradas para el módulo especificado. Almacénalas o procésalas según sea necesario; por ejemplo, registrarlas para una auditoría o compararlas con una configuración de referencia.

Errores comunes

• Scope ausente o incorrecto. Si tu token OAuth se generó sin ZohoCRM.org.ALL, la API devolverá un error de autorización. Verifica siempre los scopes incluidos en tu token antes de depurar el endpoint. ^[3]
• Omitir el parámetro module. El endpoint espera un valor de module. Llamar a GET /settings/scoring_rules sin especificar un módulo puede devolver una respuesta vacía o un error. Pasa siempre un nombre de módulo de CRM válido, como Leads, Contacts o Deals. ^[1]
• Tokens de acceso expirados. Los tokens de acceso de Zoho caducan (normalmente después de 3600 segundos). Tu integración debe detectar la expiración y usar el flujo de refresh token para obtener un nuevo token de acceso antes de reintentar la solicitud. ^[5]
• Incompatibilidad de centro de datos. Zoho opera en varios centros de datos (.com, .eu, .in, etc.). Asegúrate de que la URL base de tu API coincida con el centro de datos donde está alojada tu organización de CRM; de lo contrario, las solicitudes fallarán o devolverán resultados inesperados. ^[5]

Qué verificar

• Cobertura de scopes: Confirma que ZohoCRM.org.ALL esté presente en los scopes utilizados al generar tu token OAuth. ^[3]
• Exactitud del nombre del módulo: Verifica que el nombre del módulo que pasas coincida exactamente con el nombre de API utilizado en tu instancia de Zoho CRM (por ejemplo, Leads y no Lead). ^[1]
• Validez del token: Comprueba que tu token de acceso no haya expirado antes de realizar la llamada y que tu lógica de renovación funcione correctamente. ^[5]

---

*Beam Help es un recurso de soporte experto independiente para Zoho — no somos el soporte oficial de Zoho. Para problemas a nivel de plataforma, consulta siempre la documentación oficial de Zoho.*