La récupération des règles d'escalade des cas dans Zoho CRM peut être effectuée de manière programmatique à l'aide de l'outil dédié getcaseescalation_rules disponible dans la couche de service CRM. Cet article vous explique concrètement ce que cela signifie et comment l'invoquer correctement.
Pourquoi c'est important
Les règles d'escalade des cas définissent comment et quand les cas d'assistance sont automatiquement transmis à des files d'attente de priorité supérieure ou assignés à des agents seniors. Si vous construisez un tableau de bord personnalisé, un script d'audit ou une intégration qui doit refléter la logique d'escalade de votre organisation, vous aurez besoin d'un moyen fiable d'extraire ces règles de manière programmatique plutôt que de naviguer manuellement dans l'interface à chaque fois. Comprendre le bon appel de méthode aide également les développeurs travaillant avec les fonctionnalités d'extensibilité de Zoho CRM à maintenir un code cohérent et facile à entretenir.
> Remarque : Beam Help est une ressource d'assistance experte indépendante — nous ne sommes pas le support officiel de Zoho. Vérifiez toujours le comportement par rapport à votre édition CRM et à votre version d'API spécifiques.
---
Étape par étape
Étape 1. Confirmez que vous disposez des autorisations appropriées avant toute tentative de récupération programmatique. Dans Zoho CRM, l'accès aux configurations de métadonnées — y compris les règles — nécessite généralement un profil administrateur ou un profil utilisateur avec l'option Gérer l'extensibilité activée sous Autorisations développeur. Sans cela, l'appel sera bloqué au niveau de la plateforme. [4]
Étape 2. Identifiez l'outil ou la méthode appropriés pour votre contexte d'intégration. L'opération dédiée à cette tâche est getcaseescalationrules, qui appartient au service crm. Son implémentation principale consiste à appeler self.getcaseescalationrules() sur l'objet de service CRM. [5]
Étape 3. Invoquez la méthode dans l'environnement d'exécution de votre choix. Si vous travaillez dans une Fonction Zoho CRM (script serverless basé sur Deluge), instanciez ou référencez l'objet de service CRM et appelez la méthode directement. Les fonctions dans Zoho CRM prennent en charge les connexions aux métadonnées CRM internes, ce qui en fait un hôte naturel pour ce type de logique de récupération. [4]
Étape 4. Si vous travaillez dans un contexte JavaScript côté client — par exemple, dans un widget ou un onglet web CRM — utilisez la version appropriée du SDK JavaScript Zoho CRM pour encapsuler vos appels de service. Le SDK fournit un accès structuré aux API CRM et est disponible en plusieurs versions (V2, V2.1, V6, V7, V8) selon la version d'API configurée dans votre organisation. Choisissez la version du SDK qui correspond à votre version d'API CRM avant de construire votre intégration. [1]
Étape 5. Traitez l'objet de réponse retourné par getcaseescalation_rules. La méthode retourne les données des règles d'escalade pour les cas configurés dans votre organisation CRM. Analysez la réponse pour extraire les noms des règles, les critères d'escalade, les seuils de temps et les responsables assignés selon les besoins de votre logique en aval. [5]
Étape 6. Testez votre implémentation dans un environnement sandbox avant de déployer en production. Étant donné que les fonctions et les outils d'extensibilité peuvent opérer sous une portée système — contournant potentiellement les autorisations au niveau de l'utilisateur individuel — il est fortement recommandé de valider toute logique de récupération de métadonnées dans une organisation hors production en premier lieu. [4]
---
Pièges courants
- Autorisations insuffisantes : Si le profil exécutant la fonction ou l'appel SDK ne dispose pas de l'option Gérer l'extensibilité sous Autorisations développeur, l'appel échouera silencieusement ou retournera une erreur d'autorisation. Vérifiez les paramètres du profil dans Configuration > Utilisateurs et contrôle > Profils. [4]
- Incompatibilité de version du SDK : L'utilisation d'une version du SDK JavaScript qui ne correspond pas à la version d'API active de votre CRM peut entraîner des échecs inattendus. Par exemple, un appel SDK V8 vers un point de terminaison API V6 peut ne pas se comporter comme documenté. Faites toujours correspondre la version du SDK à votre version d'API CRM. [1]
- Portée d'exécution : Les fonctions dans Zoho CRM s'exécutent sous une portée système, ce qui signifie qu'elles disposent d'un accès élevé aux métadonnées. Bien que cela simplifie la récupération des règles d'escalade, cela signifie également que des erreurs dans votre code pourraient affecter par inadvertance les configurations en production. Une utilisation responsable et des tests en sandbox sont essentiels. [4]
---
Points à vérifier
- Niveau d'autorisation : Vérifiez que le profil utilisateur ou le contexte système exécutant l'appel dispose de l'option Gérer l'extensibilité activée sous Autorisations développeur dans Zoho CRM. [4]
- Nom de méthode correct : Confirmez que vous appelez
self.getcaseescalation_rules()sur l'objet de servicecrm— et non une méthode de règle de scoring ou de mise en page portant un nom similaire. [5] - Alignement de l'environnement : Assurez-vous que votre version du SDK (si vous utilisez JavaScript côté client) correspond à la version d'API CRM active dans votre organisation avant la mise en production. [1]