Come elencare tutti i fusi orari in Zoho Desk

Recuperare l'elenco completo dei fusi orari disponibili in Zoho Desk richiede una singola chiamata API autenticata che restituisce tutti i fusi orari supportati che la tua organizzazione può utilizzare per le impostazioni di pianificazione e localizzazione.

Perché è importante

Quando configuri i profili degli agenti, gli orari di lavoro o le policy SLA in Zoho Desk, devi fornire un identificatore di fuso orario valido. Invece di indovinare la stringa esatta attesa da Zoho Desk, puoi interrogare l'endpoint dei fusi orari per ottenere l'elenco ufficiale. Questo è particolarmente utile quando si creano integrazioni o automazioni che impostano programmaticamente i campi del fuso orario per conto degli utenti.

Procedura passo dopo passo

Passaggio 1. Assicurati che il tuo token OAuth includa gli scope corretti di Zoho Desk prima di effettuare qualsiasi chiamata API. Come minimo avrai bisogno di Desk.basic.READ nel tuo elenco di scope, che copre i dati organizzativi e di riferimento come i fusi orari. ^[2]

Passaggio 2. Autentica il tuo client utilizzando il flusso OAuth standard di Zoho. Se il tuo token di accesso è scaduto, il client dovrebbe aggiornarlo automaticamente utilizzando il refresh token memorizzato prima di procedere. ^[5]

Passaggio 3. Invia una richiesta GET all'endpoint dei fusi orari di Zoho Desk:

GET /api/v1/timeZones

Questa operazione — identificata internamente come listalltime_zones — accetta un dizionario di parametri di query opzionale (p) se hai bisogno di passare filtri o suggerimenti di paginazione, anche se non sono richiesti parametri per un elenco di base. ^[1]

Passaggio 4. Se stai lavorando in Python e hai già un'istanza ZohoDeskApi configurata (vedi Passaggio 2), puoi chiamare il metodo direttamente:

time_zones = api.list_all_time_zones()

Passa un dizionario all'argomento p se vuoi includere parametri di query opzionali; altrimenti lascialo vuoto. ^[1]

Passaggio 5. Analizza la risposta. Il payload restituito conterrà i record dei fusi orari supportati dalla tua organizzazione Zoho Desk. Memorizza o visualizza le stringhe degli identificatori rilevanti in modo che possano essere riutilizzate durante la creazione o l'aggiornamento di record che richiedono un campo fuso orario. ^[1]

Errori comuni

• Scope mancante. Se il tuo token OAuth è stato generato senza Desk.basic.READ, l'API rifiuterà la richiesta con un errore di autorizzazione. Verifica la stringa completa degli scope nella configurazione del tuo ambiente e rigenera il token se necessario. ^[2]
• orgId mancante. L'API di Zoho Desk richiede che un ID organizzazione valido venga passato con la maggior parte delle richieste. Se il tuo client non ha ancora individuato l'orgId, tenterà di recuperarlo automaticamente dall'endpoint delle organizzazioni alla prima chiamata — ma se anche questo fallisce (ad esempio a causa di uno scope mancante), le chiamate successive, inclusa la richiesta dei fusi orari, potrebbero anch'esse fallire. Verifica che deskorgid sia memorizzato e non vuoto prima di effettuare la chiamata. ^{[4] [5]}
• Dominio base errato. Zoho Desk è disponibile in più regioni di data center (US, EU, AU, IN, ecc.). Assicurati che l'api_domain utilizzato dal tuo client corrisponda alla regione in cui è ospitato il tuo portale Desk, altrimenti l'endpoint restituirà un reindirizzamento o un errore invece dei dati. ^[5]

Cosa verificare

• Verifica che Desk.basic.READ (e qualsiasi altro scope richiesto) compaia nell'elenco degli scope del tuo token OAuth attivo prima di chiamare GET /api/v1/timeZones. ^[2]
• Conferma che un deskorgid valido sia disponibile per il tuo client API in modo che la richiesta venga instradata alla corretta organizzazione Zoho Desk. ^[4]
• Esamina il payload della risposta per assicurarti che contenga un elenco non vuoto di voci di fuso orario prima di utilizzare qualsiasi identificatore nelle successive chiamate di creazione o aggiornamento di record. ^[1]

---

*Beam Help fornisce supporto esperto indipendente per i prodotti Zoho e non è il supporto ufficiale Zoho. Fai sempre riferimento alla documentazione più recente dell'API di Zoho Desk per eventuali modifiche al comportamento degli endpoint o ai requisiti degli scope OAuth.*