Come recuperare le regole di escalation dei casi in Zoho CRM

Il recupero delle regole di escalation dei casi in Zoho CRM può essere effettuato in modo programmatico utilizzando lo strumento dedicato getcaseescalation_rules disponibile nel livello di servizio CRM. Questo articolo ti guida attraverso il significato pratico di questa operazione e come invocarla correttamente.

Perché è importante

Le regole di escalation dei casi definiscono come e quando i casi di supporto vengono automaticamente elevati a code ad alta priorità o assegnati ad agenti senior. Se stai costruendo una dashboard personalizzata, uno script di audit o un'integrazione che deve riflettere la logica di escalation della tua organizzazione, avrai bisogno di un modo affidabile per recuperare quelle regole in modo programmatico, anziché navigare manualmente nell'interfaccia utente ogni volta. Comprendere la chiamata al metodo corretta aiuta inoltre gli sviluppatori che lavorano con le funzionalità di estensibilità di Zoho CRM a mantenere il codice manutenibile e coerente.

> Nota: Beam Help è una risorsa di supporto esperto indipendente — non siamo il supporto ufficiale di Zoho. Verifica sempre il comportamento in base alla tua specifica edizione di CRM e alla versione API.

---

Procedura passo dopo passo

Passaggio 1. Verifica di disporre delle autorizzazioni appropriate prima di tentare qualsiasi recupero programmatico. In Zoho CRM, l'accesso alle configurazioni dei metadati — incluse le regole — richiede in genere un profilo amministratore o un profilo utente con Gestisci estensibilità abilitato nelle Autorizzazioni sviluppatore. Senza questo, la chiamata verrà bloccata a livello di piattaforma. ^[4]

Passaggio 2. Identifica lo strumento o il metodo corretto per il tuo contesto di integrazione. L'operazione dedicata per questo compito è getcaseescalationrules, che appartiene al servizio crm. La sua implementazione principale si risolve chiamando self.getcaseescalationrules() sull'oggetto del servizio CRM. ^[5]

Passaggio 3. Invoca il metodo nell'ambiente di esecuzione scelto. Se stai lavorando all'interno di una Funzione di Zoho CRM (script serverless basato su Deluge), istanzia o fai riferimento all'oggetto del servizio CRM e chiama il metodo direttamente. Le Funzioni in Zoho CRM supportano le connessioni ai metadati CRM interni, rendendole un host naturale per questo tipo di logica di recupero. ^[4]

Passaggio 4. Se invece stai lavorando in un contesto JavaScript lato client — ad esempio, all'interno di un widget o di una scheda web CRM — utilizza la versione appropriata dell'SDK JavaScript di Zoho CRM per racchiudere le tue chiamate al servizio. L'SDK fornisce accesso strutturato alle API CRM ed è disponibile in più versioni (V2, V2.1, V6, V7, V8) a seconda della versione API configurata nella tua organizzazione. Scegli la versione dell'SDK che corrisponde alla tua versione API CRM prima di costruire l'integrazione. ^[1]

Passaggio 5. Gestisci l'oggetto risposta restituito da getcaseescalation_rules. Il metodo restituisce i dati delle regole di escalation per i casi configurati nella tua organizzazione CRM. Analizza la risposta per estrarre i nomi delle regole, i criteri di escalation, le soglie temporali e i proprietari assegnati, secondo le necessità della tua logica a valle. ^[5]

Passaggio 6. Testa la tua implementazione in un ambiente sandbox prima di distribuirla in produzione. Poiché le funzioni e gli strumenti di estensibilità possono operare in ambito di sistema — potenzialmente bypassando le autorizzazioni a livello di singolo utente — è fortemente consigliato validare tutta la logica di recupero dei metadati in un'organizzazione non di produzione. ^[4]

---

Errori comuni

• Autorizzazioni insufficienti: Se il profilo che esegue la funzione o la chiamata SDK non dispone di Gestisci estensibilità nelle Autorizzazioni sviluppatore, la chiamata fallirà silenziosamente o restituirà un errore di autorizzazione. Verifica le impostazioni del profilo in Configurazione > Utenti e controllo > Profili. ^[4]

• Versione SDK non corrispondente: L'utilizzo di una versione dell'SDK JavaScript che non è allineata con la versione API attiva del tuo CRM può causare errori imprevisti. Ad esempio, una chiamata SDK V8 verso un endpoint API V6 potrebbe non comportarsi come documentato. Assicurati sempre che la versione dell'SDK corrisponda alla tua versione API CRM. ^[1]

• Ambito di esecuzione: Le Funzioni in Zoho CRM vengono eseguite in ambito di sistema, il che significa che hanno accesso elevato ai metadati. Sebbene ciò renda semplice il recupero delle regole di escalation, significa anche che gli errori nel codice potrebbero inavvertitamente influire sulle configurazioni attive. L'uso responsabile e i test in sandbox sono essenziali. ^[4]

---

Cosa verificare

• Livello di autorizzazione: Verifica che il profilo utente o il contesto di sistema che esegue la chiamata abbia Gestisci estensibilità abilitato nelle Autorizzazioni sviluppatore in Zoho CRM. ^[4]
• Nome del metodo corretto: Conferma di chiamare self.getcaseescalation_rules() sull'oggetto del servizio crm — e non un metodo di punteggio o di regola di layout con nome simile. ^[5]
• Allineamento dell'ambiente: Assicurati che la versione dell'SDK (se utilizzi JavaScript lato client) corrisponda alla versione API CRM attiva nella tua organizzazione prima di andare in produzione. ^[1]