Come recuperare le preferenze di chiamata in Zoho

Recuperare le preferenze di chiamata in Zoho CRM è semplice tramite l'endpoint API delle impostazioni di telefonia, che restituisce la configurazione di telefonia attuale della tua organizzazione in un'unica richiesta.

Perché è importante

Quando si creano integrazioni o si verifica la configurazione di Zoho CRM, potrebbe essere necessario ispezionare a livello programmatico come sono configurati la telefonia e l'instradamento delle chiamate. Questo è particolarmente utile prima di applicare aggiornamenti, in modo da poter confrontare le preferenze esistenti con le modifiche previste. Aiuta inoltre i team di supporto — come il nostro di Beam Help (supporto esperto indipendente per Zoho, non supporto ufficiale Zoho) — a diagnosticare impostazioni di chiamata errate senza dover navigare manualmente nell'interfaccia utente.

Procedura passo dopo passo

Passaggio 1. Assicurati di avere una connessione valida e autenticata a Zoho CRM. Il tuo token di accesso deve essere aggiornato — il sistema verifica la scadenza e aggiorna automaticamente il token utilizzando un refresh token memorizzato se mancano meno di 120 secondi alla scadenza, in modo che le credenziali non aggiornate vengano gestite correttamente prima che la richiesta venga effettuata. ^[5]

Passaggio 2. Invia una richiesta GET all'endpoint /settings/telephony utilizzando la versione 6 dell'API. Questa è l'operazione designata per recuperare le preferenze di chiamata da Zoho CRM. ^[1]

Passaggio 3. In Python, la chiamata è incapsulata come segue — richiama il metodo getcallpreferences sull'istanza del client CRM, che internamente esegue una GET verso /settings/telephony alla versione 6: ^[1]

result = crm_client.get_call_preferences()

Passaggio 4. Analizza l'oggetto di risposta restituito dall'API. Questo conterrà i dati di configurazione della telefonia della tua organizzazione, che puoi ispezionare, registrare o utilizzare come riferimento di base prima di apportare eventuali aggiornamenti. ^[1]

Passaggio 5. Se hai bisogno di modificare le preferenze dopo averle esaminate, l'operazione di aggiornamento corrispondente utilizza una richiesta PUT allo stesso endpoint /settings/telephony, passando un dizionario di valori aggiornati come corpo della richiesta. ^[6]

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

Errori comuni

• Scadenza del token durante la richiesta: Se il tuo token di accesso scade esattamente nel momento in cui la richiesta viene inviata, potresti ricevere un errore 401. Il livello di connessione tenta di aggiornare i token in modo proattivo (120 secondi prima della scadenza), ma assicurati che il tuo archivio di token sia aggiornato e che il refresh token stesso non sia scaduto. ^[5]

• Versione API errata: L'endpoint delle impostazioni di telefonia richiede specificamente la versione 6. L'utilizzo di un numero di versione diverso nella richiesta potrebbe restituire un errore 404 o un formato di risposta inatteso. ^[1]

• Record di connessione mancante: Se non esiste alcuna connessione Zoho per l'utente autenticato nel tuo sistema, il client API restituirà None anziché generare un errore esplicito, quindi verifica sempre che una connessione sia presente prima di tentare la chiamata. ^[4]

Cosa verificare

• Conferma che la risposta di GET /settings/telephony contenga i campi di telefonia previsti per la tua organizzazione prima di considerare i dati come autorevoli. ^[1]
• Verifica che il tuo token di accesso sia stato aggiornato correttamente se riscontri errori di autenticazione — controlla che il refresh_token memorizzato sia ancora valido. ^[5]
• Se prevedi di effettuare un aggiornamento successivo, confronta i campi restituiti dalla risposta GET con il dizionario che intendi passare a updatecallpreferences per evitare di sovrascrivere impostazioni in modo non intenzionale. ^[6]