Comment récupérer les tableaux de bord dans Zoho

Récupérer les tableaux de bord dans Zoho CRM est simple dès que votre connexion API est authentifiée — une seule requête GET vers l'endpoint des paramètres renvoie toutes les données de tableau de bord disponibles.

Pourquoi c'est important

Si vous créez des intégrations, automatisez des workflows de reporting ou auditez votre configuration analytique Zoho CRM, vous aurez besoin d'un accès programmatique à vos tableaux de bord. Cela est particulièrement utile lorsque vous souhaitez inventorier les tableaux de bord existants, les synchroniser avec des outils de BI externes, ou vérifier quelles vues analytiques sont configurées pour votre organisation.

Étape par étape

Étape 1. Assurez-vous que votre connexion API Zoho CRM est active et authentifiée. Le système utilise des tokens OAuth susceptibles d'expirer ; vérifiez donc que votre accesstoken est valide avant d'effectuer des appels. Si le token a expiré, un flux de rafraîchissement utilisant votre refreshtoken stocké en obtiendra automatiquement un nouveau. ^[3]

Étape 2. Effectuez une requête GET vers l'endpoint /settings/dashboards de l'API Zoho CRM. Il s'agit de l'opération désignée — intitulée get_dashboards — qui se trouve sous la catégorie Signals & Analytics de l'API des paramètres CRM. ^[6]

GET /settings/dashboards

Étape 3. L'appel Python sous-jacent qui alimente cette opération est simple :

def get_dashboards(self):
    return self.c.request("GET", "/settings/dashboards")

Votre objet client (self.c) se charge d'ajouter l'en-tête d'autorisation et d'acheminer la requête vers le domaine du bon centre de données. ^[6]

Étape 4. Vérifiez que vos scopes OAuth incluent les permissions nécessaires pour les paramètres CRM. Le groupe de scopes requis couvre ZohoCRM.org.ALL, qui accorde l'accès aux paramètres au niveau de l'organisation, y compris la configuration analytique. Sans les scopes appropriés accordés au moment de l'autorisation OAuth, l'endpoint retournera une erreur d'autorisation. ^[8]

Étape 5. Une fois la réponse reçue, analysez le payload retourné. Si vous construisez des liens ou des références vers l'interface Zoho CRM, le modèle d'URL de base suit le format https://crm.zoho.{dc}/crm où {dc} est le suffixe de votre centre de données (par exemple, com, eu, in). ^[5]

Erreurs courantes

• Token d'accès expiré ou manquant. Si la connexion API n'est pas authentifiée, l'appel échouera immédiatement. Vérifiez toujours que la session est active avant d'exécuter la requête — un état non authentifié nécessite de relancer le flux OAuth. ^[3]
• Mauvais domaine de centre de données. Zoho CRM est hébergé sur plusieurs centres de données régionaux. Envoyer la requête à crm.zoho.com alors que votre compte est sur crm.zoho.eu, par exemple, entraînera un appel échoué ou mal dirigé. Récupérez la valeur dc depuis votre enregistrement de connexion stocké et construisez l'URL de base en conséquence. ^[5]
• Scopes OAuth insuffisants. Si les scopes n'ont pas été configurés pour inclure l'accès au niveau de l'organisation CRM lors de la première autorisation de la connexion OAuth, l'endpoint des tableaux de bord rejettera la requête. Vous devrez réautoriser la connexion avec le bon ensemble de scopes. ^[8]

Ce qu'il faut vérifier

• Confirmez que la réponse API contient une liste d'objets de tableau de bord et ne retourne pas d'erreur d'authentification ou de permission.
• Vérifiez que la valeur dc dans votre enregistrement de connexion correspond au centre de données Zoho réel sur lequel votre compte est enregistré, afin que toute construction d'URL ultérieure soit correcte. ^[5]
• Vérifiez que les scopes OAuth accordés au moment de la connexion incluent ZohoCRM.org.ALL pour garantir que les endpoints au niveau des paramètres restent accessibles. ^[8]

---

*Beam Help fournit une assistance experte indépendante pour Zoho — nous ne sommes pas le support officiel de Zoho. Pour les problèmes de facturation ou de compte au niveau de la plateforme, contactez Zoho directement.*