Cómo recuperar las preferencias de llamada en Zoho

Recuperar las preferencias de llamada en Zoho CRM es sencillo a través del endpoint de la API de configuración de telefonía, que devuelve la configuración de telefonía actual de tu organización en una sola solicitud.

Por qué esto es importante

Al crear integraciones o auditar tu configuración de Zoho CRM, puede que necesites inspeccionar de forma programática cómo están configurados la telefonía y el enrutamiento de llamadas. Esto es especialmente útil antes de aplicar actualizaciones, para poder comparar las preferencias existentes con los cambios previstos. También ayuda a los equipos de soporte — como el nuestro en Beam Help (soporte experto independiente para Zoho, no soporte oficial de Zoho) — a diagnosticar configuraciones de llamada incorrectas sin navegar manualmente por la interfaz.

Paso a paso

Paso 1. Asegúrate de tener una conexión válida y autenticada con Zoho CRM. Tu token de acceso debe estar vigente — el sistema verifica la expiración y actualiza automáticamente el token usando un refresh token almacenado si está a menos de 120 segundos de expirar, por lo que las credenciales caducadas se gestionan correctamente antes de realizar la solicitud. ^[5]

Paso 2. Realiza una solicitud GET al endpoint /settings/telephony usando la versión 6 de la API. Esta es la operación designada para obtener las preferencias de llamada de Zoho CRM. ^[1]

Paso 3. En Python, la llamada se encapsula de la siguiente manera — invoca el método getcallpreferences en tu instancia del cliente CRM, que internamente ejecuta un GET contra /settings/telephony en la versión 6: ^[1]

result = crm_client.get_call_preferences()

Paso 4. Analiza el objeto de respuesta devuelto por la API. Este contendrá los datos de configuración de telefonía de tu organización, que puedes inspeccionar, registrar o usar como referencia antes de realizar cualquier actualización. ^[1]

Paso 5. Si necesitas modificar las preferencias después de revisarlas, la operación de actualización correspondiente utiliza una solicitud PUT al mismo endpoint /settings/telephony, pasando un diccionario de valores actualizados como cuerpo de la solicitud. ^[6]

crm_client.update_call_preferences({"key": "value"})

Errores comunes

• Expiración del token durante la solicitud: Si tu token de acceso expira justo cuando se ejecuta la solicitud, puedes recibir un error 401. La capa de conexión intenta actualizar los tokens de forma proactiva (120 segundos antes de la expiración), pero asegúrate de que el almacenamiento de tu token esté actualizado y de que el refresh token en sí no haya expirado. ^[5]

• Versión de API incorrecta: El endpoint de configuración de telefonía requiere específicamente la versión 6. Usar un número de versión diferente en tu solicitud puede resultar en un error 404 o en un formato de respuesta inesperado. ^[1]

• Registro de conexión ausente: Si no existe ninguna conexión de Zoho para el usuario autenticado en tu sistema, el cliente de la API devolverá None en lugar de generar un error explícito, por lo que siempre debes validar que existe una conexión antes de intentar la llamada. ^[4]

Qué verificar

• Confirma que la respuesta de GET /settings/telephony contiene los campos de telefonía esperados para tu organización antes de tratar los datos como definitivos. ^[1]
• Verifica que tu token de acceso se haya actualizado correctamente si encuentras errores de autenticación — comprueba que el refresh_token almacenado sigue siendo válido. ^[5]
• Si planeas realizar una actualización a continuación, compara los campos devueltos por la respuesta GET con el diccionario que pretendes pasar a updatecallpreferences para evitar sobrescribir configuraciones de forma no intencionada. ^[6]