Comment récupérer les règles de scoring dans Zoho

La récupération des règles de scoring dans Zoho CRM est simple dès lors que vous connaissez le bon endpoint API et le paramètre de module qu'il requiert.

Pourquoi c'est important

Les règles de scoring dans Zoho CRM vous permettent de classer automatiquement les leads, contacts, opportunités et autres enregistrements selon des critères que vous définissez. Si vous développez des intégrations, auditez votre configuration CRM ou synchronisez la logique de scoring avec un système externe, vous aurez besoin d'un moyen fiable pour extraire ces règles par programmation. Comprendre l'endpoint exact et ses paramètres vous fait gagner du temps et évite les appels API mal configurés.

Étape par étape

Étape 1. Assurez-vous que votre connexion OAuth inclut les scopes Zoho CRM nécessaires avant d'effectuer tout appel API. Le groupe de scopes requis pour les paramètres au niveau de l'organisation est ZohoCRM.org.ALL, qui couvre la lecture des données de configuration CRM telles que les règles de scoring. ^[3]

Étape 2. Authentifiez votre client et obtenez un jeton d'accès valide. Le jeton est récupéré en échangeant un code d'autorisation ou en actualisant un jeton existant via l'endpoint OAuth de Zoho. Une fois obtenu, le jeton d'accès est transmis en tant que jeton Bearer dans l'en-tête Authorization de chaque requête suivante. ^[7]

Étape 3. Appelez l'endpoint des règles de scoring via une requête HTTP GET :

GET /settings/scoring_rules

Cet endpoint est classé dans les paramètres de scoring et d'affectation de Zoho CRM. ^[1]

Étape 4. Transmettez le paramètre module pour spécifier les règles de scoring du module CRM que vous souhaitez récupérer. Par exemple, pour récupérer les règles de scoring du module Leads, fournissez module=Leads comme paramètre de requête. Ce paramètre est obligatoire — l'omettre ne retournera pas de résultats pertinents. ^[1]

Étape 5. Si vous travaillez en Python, l'appel peut être encapsulé comme indiqué ci-dessous. La méthode accepte le nom du module sous forme de chaîne de caractères (m) et effectue la requête GET avec {"module": m} comme paramètres de requête :

def get_scoring_rules(self, m: str):
    return self.c.request("GET", "/settings/scoring_rules", {"module": m})

Ce modèle maintient le nom du module flexible afin que vous puissiez itérer sur plusieurs modules (par exemple, Leads, Contacts, Deals) sans dupliquer le code. ^[1]

Étape 6. Analysez la réponse. L'API retournera les règles de scoring configurées pour le module spécifié. Stockez-les ou traitez-les selon vos besoins — par exemple, en les journalisant pour une piste d'audit ou en les comparant à une configuration de référence.

Erreurs courantes

• Scope manquant ou incorrect. Si votre jeton OAuth a été généré sans ZohoCRM.org.ALL, l'API retournera une erreur d'autorisation. Vérifiez toujours les scopes inclus dans votre jeton avant de déboguer l'endpoint lui-même. ^[3]
• Omission du paramètre module. L'endpoint attend une valeur module. Appeler GET /settings/scoring_rules sans spécifier de module peut retourner une réponse vide ou une erreur. Transmettez toujours un nom de module CRM valide tel que Leads, Contacts ou Deals. ^[1]
• Jetons d'accès expirés. Les jetons d'accès Zoho expirent (généralement après 3 600 secondes). Votre intégration doit détecter l'expiration et utiliser le flux de jeton d'actualisation pour obtenir un nouveau jeton d'accès avant de relancer la requête. ^[5]
• Incompatibilité de centre de données. Zoho opère sur plusieurs centres de données (.com, .eu, .in, etc.). Assurez-vous que l'URL de base de votre API correspond au centre de données où votre organisation CRM est hébergée, sinon les requêtes échoueront ou retourneront des résultats inattendus. ^[5]

Points à vérifier

• Couverture des scopes : Confirmez que ZohoCRM.org.ALL est présent dans les scopes utilisés lors de la génération de votre jeton OAuth. ^[3]
• Exactitude du nom de module : Vérifiez que le nom de module que vous transmettez correspond exactement au nom API utilisé dans votre instance Zoho CRM (par exemple, Leads et non Lead). ^[1]
• Validité du jeton : Vérifiez que votre jeton d'accès n'a pas expiré avant d'effectuer l'appel, et que votre logique d'actualisation fonctionne correctement. ^[5]

---

*Beam Help est une ressource d'assistance experte indépendante pour Zoho — nous ne sommes pas le support officiel de Zoho. Pour les problèmes au niveau de la plateforme, référez-vous toujours à la documentation officielle de Zoho.*