Come recuperare una specifica regola di escalation dei casi in Zoho CRM

Il recupero di una specifica regola di escalation dei casi in Zoho CRM avviene tramite una singola richiesta GET autenticata all'endpoint delle impostazioni delle regole di escalation dei casi, passando l'ID della regola desiderata come parametro di percorso.

Perché è importante

Quando gestisci le operazioni di supporto in Zoho CRM, potresti avere più regole di escalation dei casi configurate e dover ispezionare o verificare una singola regola in modo programmatico — ad esempio, per controllarne le condizioni prima di distribuire una modifica o per importarne la configurazione in un sistema esterno. Invece di elencare tutte le regole e filtrare lato client, l'endpoint dedicato alla singola regola ti consente di recuperare esattamente ciò di cui hai bisogno in una sola chiamata.

Procedura passo dopo passo

Passaggio 1. Identifica il ruleid della regola di escalation che desideri recuperare. Si tratta dell'identificatore univoco assegnato alla regola all'interno della tua organizzazione Zoho CRM. Puoi ottenerlo chiamando prima l'endpoint di elenco (getcaseescalationrules) per enumerare tutte le regole di escalation dei casi disponibili e annotare l'ID di quella che ti serve. ^[7]

Passaggio 2. Costruisci la tua richiesta utilizzando il metodo HTTP GET verso il seguente endpoint, sostituendo {rule_id} con l'identificatore effettivo raccolto nel Passaggio 1: ^[3]

GET /settings/case_escalation_rules/{rule_id}

Passaggio 3. Invia la richiesta autenticata. Il nome dell'operazione per questa chiamata è getcaseescalationrule e accetta un singolo parametro — ruleid — come parte del percorso URL. ^[3]

Passaggio 4. Se stai lavorando in Python con un wrapper client CRM, la chiamata corrisponde al seguente schema, dove rule_id viene passato come argomento stringa: ^[3]

response = client.get_case_escalation_rule(rule_id="your_rule_id_here")

Il metodo emette internamente una richiesta GET verso /settings/caseescalationrules/{rule_id} e restituisce la configurazione della regola nel corpo della risposta. ^[3]

Errori comuni

• ruleid errato o non aggiornato: Se l'ID fornito non corrisponde ad alcuna regola esistente, l'API restituirà un errore. Aggiorna sempre l'elenco delle regole tramite getcaseescalationrules prima di inserire un ID nel codice. ^[7]
• Ambito dell'endpoint: Questo endpoint è specificamente limitato alle regole di escalation dei *casi* nelle impostazioni di CRM. Non confonderlo con le regole di escalation SLA in Zoho Desk, che sono un prodotto separato con una superficie di configurazione distinta. ^[6]
• Autenticazione: Come tutti gli endpoint delle impostazioni di Zoho CRM, questa chiamata richiede un token OAuth valido con il corretto ambito delle impostazioni CRM. Le richieste prive di un'autorizzazione adeguata verranno rifiutate prima che i dati della regola vengano restituiti. ^[3]

Cosa verificare

• Conferma che il valore ruleid che stai passando corrisponda a una regola attiva restituita dalla chiamata di elenco getcaseescalationrules. ^[7]
• Verifica che il corpo della risposta contenga i campi di configurazione della regola previsti prima di utilizzare i dati a valle. ^[3]
• Assicurati che il tuo token OAuth non sia scaduto e che disponga del corretto ambito di autorizzazione delle impostazioni CRM per l'accesso in lettura alle configurazioni delle regole di escalation. ^[3]

---

*Beam Help è una risorsa di supporto esperto indipendente per i prodotti Zoho e non rappresenta il supporto ufficiale Zoho. Fai sempre riferimento alla documentazione ufficiale di Zoho per le specifiche API più aggiornate.*