Comment récupérer une règle d'escalade de cas spécifique dans Zoho CRM

La récupération d'une règle d'escalade de cas spécifique dans Zoho CRM s'effectue via une seule requête GET authentifiée vers le point de terminaison des paramètres des règles d'escalade de cas, en passant l'identifiant de la règle cible comme paramètre de chemin.

Pourquoi c'est important

Lorsque vous gérez les opérations de support dans Zoho CRM, vous pouvez avoir plusieurs règles d'escalade de cas configurées et avoir besoin d'inspecter ou d'auditer une seule règle par programmation — par exemple, pour vérifier ses conditions avant de déployer une modification ou pour extraire sa configuration dans un système externe. Plutôt que de lister toutes les règles et de filtrer côté client, le point de terminaison dédié à une règle unique vous permet de récupérer exactement ce dont vous avez besoin en un seul appel.

Étape par étape

Étape 1. Identifiez le ruleid de la règle d'escalade que vous souhaitez récupérer. Il s'agit de l'identifiant unique attribué à la règle au sein de votre organisation Zoho CRM. Vous pouvez l'obtenir en appelant d'abord le point de terminaison de liste (getcaseescalationrules) pour énumérer toutes les règles d'escalade de cas disponibles et en notant l'identifiant de celle dont vous avez besoin. ^[7]

Étape 2. Construisez votre requête en utilisant la méthode HTTP GET vers le point de terminaison suivant, en remplaçant {rule_id} par l'identifiant réel que vous avez collecté à l'étape 1 : ^[3]

GET /settings/case_escalation_rules/{rule_id}

Étape 3. Envoyez la requête authentifiée. Le nom de l'opération pour cet appel est getcaseescalationrule, et il accepte un seul paramètre — ruleid — dans le chemin de l'URL. ^[3]

Étape 4. Si vous travaillez en Python avec un wrapper client CRM, l'appel correspond au modèle suivant, où rule_id est passé en tant qu'argument de type chaîne : ^[3]

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

La méthode émet en interne une requête GET vers /settings/caseescalationrules/{rule_id} et retourne la configuration de la règle dans le corps de la réponse. ^[3]

Erreurs courantes

• ruleid incorrect ou obsolète : Si l'identifiant que vous fournissez ne correspond à aucune règle existante, l'API retournera une erreur. Actualisez toujours votre liste de règles via getcaseescalationrules avant de coder un identifiant en dur. ^[7]
• Portée du point de terminaison : Ce point de terminaison est spécifiquement limité aux règles d'escalade de *cas* dans les paramètres CRM. Ne le confondez pas avec les règles d'escalade SLA dans Zoho Desk, qui constituent un produit distinct et une surface de configuration séparée. ^[6]
• Authentification : Comme tous les points de terminaison des paramètres Zoho CRM, cet appel nécessite un jeton OAuth valide avec la portée appropriée des paramètres CRM. Les requêtes sans autorisation adéquate seront rejetées avant que les données de la règle ne soient retournées. ^[3]

Ce qu'il faut vérifier

• Confirmez que la valeur ruleid que vous transmettez correspond à une règle active retournée par l'appel de liste getcaseescalationrules. ^[7]
• Vérifiez que le corps de la réponse contient les champs de configuration de règle attendus avant d'utiliser les données en aval. ^[3]
• Assurez-vous que votre jeton OAuth n'a pas expiré et qu'il dispose de la portée d'autorisation CRM correcte pour l'accès en lecture aux configurations de règles d'escalade. ^[3]

---

*Beam Help est une ressource d'assistance experte indépendante pour les produits Zoho et ne constitue pas le support officiel de Zoho. Référez-vous toujours à la documentation officielle de Zoho pour les spécifications API les plus récentes.*