Comment récupérer les métriques de ticket dans Zoho Desk

Les métriques de ticket dans Zoho Desk sont disponibles via un unique endpoint REST qui retourne les données de performance pour n'importe quel ticket individuel — sans navigation dans le tableau de bord.

Pourquoi c'est important

Lorsque vous devez auditer les temps de réponse, mesurer la conformité aux SLA ou extraire des données de performance brutes dans un pipeline de reporting, l'API Zoho Desk vous offre un accès programmatique direct aux métriques par ticket. C'est particulièrement utile pour les équipes qui créent des tableaux de bord personnalisés ou automatisent des contrôles qualité sans parcourir manuellement l'interface agent de Desk.

Étape par étape

Étape 1. Vérifiez que votre token OAuth contient les scopes Desk corrects avant d'effectuer tout appel API. Vous avez besoin au minimum de Desk.tickets.READ dans votre liste de scopes autorisés — des options plus larges telles que Desk.tickets.ALL satisfont également cette exigence. ^[3]

Étape 2. Identifiez le ticket_id numérique du ticket dont vous souhaitez obtenir les métriques. Vous pouvez le trouver dans l'URL du portail agent Zoho Desk, qui suit le modèle https://desk.zoho.{dc}/agent/{portal}/tickets/details/{TicketId}, ou en interrogeant d'abord l'endpoint de liste des tickets. ^[4]

Étape 3. Envoyez une requête GET vers l'endpoint des métriques, en substituant l'ID de votre ticket dans le chemin :

GET /api/v1/tickets/{ticket_id}/metrics

L'endpoint accepte ticket_id comme paramètre de chemin obligatoire et un paramètre optionnel p pour toute option de requête supplémentaire que vous souhaitez transmettre. ^[1]

Étape 4. En Python, l'appel ressemble à ceci en utilisant le wrapper ZohoDeskApi :

metrics = api.get_ticket_metrics(ticket_id="12345")

Passez un dictionnaire optionnel comme second argument (p) si vous devez inclure des paramètres de requête supplémentaires. ^[1]

Étape 5. Analysez le dictionnaire de réponse retourné. Notre équipe recommande d'afficher ou de journaliser la réponse complète pendant le développement afin de voir exactement quels champs de métriques votre organisation Desk retourne — la disponibilité des champs peut varier selon le plan et la configuration. ^[5]

Étape 6. Si vous créez un workflow conversationnel ou automatisé, le modèle d'assistant Zoho Desk consiste à toujours appeler l'outil avec des données réelles plutôt que de deviner les valeurs. Confirmez que vous disposez du ticket_id avant d'invoquer l'endpoint ; s'il est manquant, demandez-le explicitement avant de continuer. ^[5]

Erreurs courantes

• Scopes OAuth manquants ou incorrects. Si votre token a été généré sans Desk.tickets.READ (ou Desk.tickets.ALL), l'API retournera une erreur d'autorisation. Vérifiez la chaîne de scopes dans votre configuration OAuth — chaque scope doit être séparé par une virgule sans espaces superflus. ^[3]

• Tokens d'accès expirés. Les tokens d'accès Zoho expirent (généralement après une heure). La couche API doit se rafraîchir automatiquement en utilisant le refreshtoken stocké ; si vous constatez des erreurs 401, vérifiez que votre logique de rafraîchissement de token écrit bien le nouvel accesstoken dans votre store de connexion avant de réessayer. ^[8]

• Mauvais domaine de centre de données. Desk est hébergé sur plusieurs centres de données régionaux. L'URL de base change selon votre DC — par exemple https://desk.zoho.com pour les comptes .com contre https://desk.zoho.{dc} pour les régions EU, IN, AU et autres. Utiliser le mauvais domaine entraînera des erreurs de connexion ou des erreurs 404. ^[4]

• Org ID non défini. Le ZohoDeskClient nécessite un en-tête orgid valide pour chaque requête. Si votre enregistrement de connexion ne contient pas encore deskorg_id, le client tentera de le découvrir automatiquement en appelant l'endpoint des organisations lors de la première utilisation. Assurez-vous que cette étape de découverte se termine avec succès avant d'appeler l'endpoint des métriques. ^[8]

Ce qu'il faut vérifier

• Vérifiez que la réponse contient les champs de métriques attendus (par ex. temps de réponse, temps de résolution) et qu'aucun n'est null en raison du ticket encore ouvert ou non assigné.
• Confirmez que vos scopes OAuth incluent au moins Desk.tickets.READ et que le token a été rafraîchi s'il a plus d'une heure. ^[3]
• Comparez le ticket_id retourné dans l'URL du portail agent Desk pour vous assurer d'avoir interrogé le bon ticket. ^[4]

---

*Beam Help fournit des conseils d'experts indépendants sur les produits Zoho et ne constitue pas le support officiel de Zoho.*