Cómo listar todas las zonas horarias en Zoho Desk

Recuperar la lista completa de zonas horarias disponibles en Zoho Desk es una única llamada autenticada a la API que devuelve todas las zonas horarias que tu organización puede utilizar para la configuración de programación y localización.

Por qué es importante

Al configurar perfiles de agentes, horarios comerciales o políticas de SLA en Zoho Desk, es necesario proporcionar un identificador de zona horaria válido. En lugar de adivinar la cadena exacta que Zoho Desk espera, puedes consultar el endpoint de zonas horarias para obtener la lista oficial. Esto resulta especialmente útil al crear integraciones o automatizaciones que establecen campos de zona horaria de forma programática en nombre de los usuarios.

Paso a paso

Paso 1. Asegúrate de que tu token OAuth incluye los scopes correctos de Zoho Desk antes de realizar cualquier llamada a la API. Como mínimo, necesitarás Desk.basic.READ en tu lista de scopes, que cubre datos organizativos y de referencia como las zonas horarias. ^[2]

Paso 2. Autentica tu cliente utilizando el flujo estándar de OAuth de Zoho. Si tu token de acceso ha expirado, el cliente debería actualizarlo automáticamente usando el token de actualización almacenado antes de continuar. ^[5]

Paso 3. Envía una solicitud GET al endpoint de zonas horarias de Zoho Desk:

GET /api/v1/timeZones

Esta operación — identificada internamente como listalltime_zones — acepta un diccionario de parámetros de consulta opcionales (p) si necesitas pasar algún filtro o indicación de paginación, aunque no se requiere ningún parámetro para un listado básico. ^[1]

Paso 4. Si trabajas en Python y ya tienes una instancia de ZohoDeskApi configurada (consulta el Paso 2), puedes llamar al método directamente:

time_zones = api.list_all_time_zones()

Pasa un diccionario al argumento p si deseas incluir parámetros de consulta opcionales; de lo contrario, déjalo vacío. ^[1]

Paso 5. Analiza la respuesta. El payload devuelto contendrá los registros de zonas horarias que admite tu organización de Zoho Desk. Almacena o muestra las cadenas de identificadores relevantes para poder reutilizarlas al crear o actualizar registros que requieran un campo de zona horaria. ^[1]

Errores comunes

• Scope faltante. Si tu token OAuth se generó sin Desk.basic.READ, la API rechazará la solicitud con un error de autorización. Verifica la cadena completa de scopes en la configuración de tu entorno y regenera el token si es necesario. ^[2]
• orgId faltante. La API de Zoho Desk requiere que se proporcione un ID de organización válido en la mayoría de las solicitudes. Si tu cliente aún no ha obtenido el orgId, intentará recuperarlo automáticamente desde el endpoint de organizaciones en la primera llamada; pero si eso también falla (por ejemplo, debido a un scope incorrecto), las llamadas posteriores, incluida la solicitud de zonas horarias, también podrían fallar. Confirma que deskorgid esté almacenado y no esté vacío antes de realizar la llamada. ^{[4] [5]}
• Dominio base incorrecto. Zoho Desk está disponible en múltiples regiones de centros de datos (US, EU, AU, IN, etc.). Asegúrate de que el api_domain utilizado por tu cliente coincida con la región donde está alojado tu portal de Desk; de lo contrario, el endpoint devolverá una redirección o un error en lugar de datos. ^[5]

Qué verificar

• Comprueba que Desk.basic.READ (y cualquier otro scope requerido) aparezca en la lista de scopes de tu token OAuth activo antes de llamar a GET /api/v1/timeZones. ^[2]
• Confirma que un deskorgid válido esté disponible para tu cliente de API, de modo que la solicitud se enrute a la organización correcta de Zoho Desk. ^[4]
• Inspecciona el payload de la respuesta para asegurarte de que contiene una lista no vacía de entradas de zonas horarias antes de utilizar cualquier identificador en llamadas posteriores de creación o actualización de registros. ^[1]

---

*Beam Help ofrece soporte experto independiente para productos Zoho y no es el soporte oficial de Zoho. Consulta siempre la documentación más reciente de la API de Zoho Desk para conocer cualquier cambio en el comportamiento de los endpoints o en los requisitos de scopes de OAuth.*