Cómo recuperar las preferencias de servicio en Zoho

La recuperación de las preferencias de servicio en Zoho CRM se realiza mediante una única solicitud GET autenticada al endpoint /settings/service_preferences, que devuelve la configuración de servicio actual de tu organización.

Por qué esto es importante

Cuando construyes integraciones o automatizaciones sobre Zoho CRM, a menudo necesitas inspeccionar cómo están configurados los servicios antes de tomar decisiones posteriores. El endpoint de preferencias de servicio te proporciona una instantánea programática de esos ajustes sin necesidad de navegar por la interfaz. Esto resulta especialmente útil durante auditorías de incorporación, comparaciones de entornos o cuando depuras comportamientos inesperados del servicio. Como soporte experto independiente (no soporte oficial de Zoho), Beam Help documenta estos patrones para que tu equipo pueda avanzar más rápido.

Paso a paso

Paso 1. Asegúrate de que tu usuario tiene una conexión activa y autenticada con Zoho CRM. Antes de realizar cualquier llamada a la API, el sistema verifica el registro de conexión almacenado y actualiza automáticamente el token OAuth si está a menos de 120 segundos de expirar, por lo que nunca deberías necesitar activar manualmente una actualización durante una solicitud. ^[7]

Paso 2. Si el token de acceso necesita actualizarse, la capa OAuth intercambia el token de actualización almacenado por uno nuevo y actualiza tanto accesstoken como tokenexpiresat en el registro de conexión. Confirma que accesstoken está presente en la respuesta antes de continuar; si está ausente, la actualización ha fallado y la llamada debe cancelarse. ^[8]

Paso 3. Instancia tu cliente de la API de Zoho CRM utilizando la conexión autenticada. Pasa el apidomain, el accesstoken actual y un callback token_refresher para que cualquier expiración durante la solicitud pueda gestionarse de forma transparente sin interrumpir la llamada. ^[2]

Paso 4. Llama al endpoint de preferencias de servicio emitiendo una solicitud GET a /settings/service_preferences usando la versión 6 de la API. En Python tiene este aspecto:

def get_service_preferences(self):
    return self.c.request("GET", "/settings/service_preferences", version=6)

El método devuelve el payload completo de preferencias de servicio para tu organización de CRM. ^[1]

Paso 5. Analiza el cuerpo de la respuesta. Los datos devueltos reflejan la configuración de servicios actual. Almacena o registra el resultado según sea necesario para tu lógica de auditoría o integración. ^[1]

Errores comunes

• Token ausente o expirado. Si accesstoken no está presente tras un intento de actualización, el cliente de la API no tendrá credenciales válidas y la solicitud fallará con un 401. Valida siempre que la actualización del token devolvió una clave accesstoken correcta antes de continuar. ^[8]

• Versión de API incorrecta. La llamada getservicepreferences apunta explícitamente a la versión 6 de la API de Zoho CRM. Usar un número de versión diferente puede devolver un 404 o una estructura de respuesta inesperada. ^[1]

• No se encontró el registro de conexión. Si el usuario no ha completado el flujo OAuth, getzohoconnection devuelve None y la instancia de la API no puede crearse. Gestiona este caso solicitando al usuario que vuelva a conectarse antes de intentar recuperar cualquier configuración. ^{[2] [7]}

• Discrepancia de dominio. Zoho opera en múltiples centros de datos (p. ej., .com, .eu, .in). El api_domain almacenado en el registro de conexión debe coincidir con el centro de datos donde está alojada la organización de CRM; de lo contrario, las solicitudes se enrutarán incorrectamente. ^[2]

Qué verificar

• Validez del token: Confirma que accesstoken está presente y que tokenexpires_at es una fecha futura antes de enviar la solicitud. ^[7]
• Versión de la API: Verifica que tu cliente está pasando explícitamente version=6 al llamar a /settings/service_preferences. ^[1]
• Integridad del registro de conexión: Comprueba que tanto apidomain como refreshtoken están rellenos en la conexión almacenada; un refresh_token ausente impedirá la recuperación ante cualquier expiración del token. ^{[7] [8]}