Comment lister les tickets par produit dans Zoho Desk

Lister les tickets par produit dans Zoho Desk est simple dès lors que vous disposez d'un identifiant de produit valide et des scopes OAuth appropriés — un seul appel API retourne tous les tickets associés à ce produit.

Pourquoi c'est important

Lorsque votre support couvre plusieurs produits, filtrer les tickets par produit permet aux agents et aux responsables de se concentrer sur la bonne file d'attente sans parcourir des demandes non pertinentes. C'est particulièrement utile pour le reporting, les workflows de triage et la création de tableaux de bord spécifiques à chaque produit. Si vous intégrez Zoho Desk avec une application personnalisée ou un assistant IA, cet endpoint est la manière la plus propre de limiter les données de tickets à une seule ligne de produits.

Étape par étape

Étape 1. Vérifiez que votre token OAuth inclut les scopes de tickets Zoho Desk nécessaires. Vous avez au minimum besoin de Desk.tickets.READ autorisé pour votre application connectée ; les intégrations plus larges incluent généralement aussi Desk.tickets.ALL ainsi que des scopes pour les contacts, les tâches et les paramètres. ^[4]

Étape 2. Identifiez le product_id du produit dont vous souhaitez récupérer les tickets. Il s'agit de l'identifiant unique que Zoho Desk attribue à chaque enregistrement de produit dans votre portail. Vous pouvez le trouver en accédant à Configuration → Produits dans votre portail Desk, ou en interrogeant d'abord l'endpoint des produits si vous travaillez de manière programmatique.

Étape 3. Effectuez une requête GET vers l'endpoint suivant, en remplaçant l'identifiant de produit par le vôtre :

GET /api/v1/products/{product_id}/tickets

Le nom de l'opération pour cet appel est listticketsby_products, et il accepte un paramètre optionnel p sous forme d'objet pour la pagination ou des filtres supplémentaires. ^[2]

Étape 4. Transmettez les paramètres de requête dont vous avez besoin (tels que le numéro de page ou l'ordre de tri) dans le dictionnaire p lors de la construction de la requête. Un appel Python minimal ressemble à ceci :

result = desk_client.list_tickets_by_products(
    product_id="your_product_id_here",
    p={"page": 1}
)

La méthode client émet la requête GET vers /api/v1/products/{product_id}/tickets et retourne la réponse analysée. ^[2]

Étape 5. Une fois la réponse obtenue, affichez les enregistrements de tickets à vos utilisateurs. Les champs clés à afficher incluent le sujet du ticket, le statut, l'agent assigné et la date de création. Notre équipe recommande de formater la sortie avec des sauts de ligne clairs — Sujet, Statut, Propriétaire/Agent — et d'omettre les champs vides ou les identifiants internes pour garder la vue lisible. ^[6]

Étape 6. Si vous construisez une couche d'interface utilisateur par-dessus, créez des liens directs vers les tickets individuels en utilisant le modèle d'URL Zoho Desk :

https://desk.zoho.{dc}/agent/{portal}/tickets/details/{ticket_id}

Remplacez {dc} par votre suffixe de centre de données (par ex. com, eu, in), {portal} par le nom de votre portail ou l'ID de votre organisation, et {ticket_id} par l'identifiant de chaque ticket. ^[3]

---

Erreurs courantes

• Scope OAuth manquant ou incorrect. 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 liste des scopes dans la configuration de votre application connectée et régénérez le token si nécessaire. ^[4]

• Identifiant de produit incorrect. Passer un product_id invalide ou incorrect retournera un ensemble de résultats vide ou une erreur de type 404 plutôt qu'un message explicite. Validez toujours l'identifiant par rapport à la liste des produits de votre portail avant d'appeler l'endpoint. ^[2]

• Mauvais centre de données dans les URLs. Zoho Desk est hébergé sur plusieurs centres de données régionaux. Si votre portail se trouve sur le centre de données EU ou IN, l'URL de base change de https://desk.zoho.com à https://desk.zoho.eu ou https://desk.zoho.in respectivement. Utiliser la mauvaise URL de base fera échouer toutes les requêtes. ^[3]

• Portail vs. ID d'organisation dans les liens directs. Lors de la construction des URLs de tickets, le chemin utilise le nom de votre portail s'il est configuré ; sinon, il utilise l'ID d'organisation numérique. Les confondre génère des liens brisés. ^[3]

---

Points à vérifier

• Couverture des scopes : Vérifiez que Desk.tickets.READ (au minimum) apparaît dans la liste des scopes de votre token OAuth actif avant d'effectuer l'appel. ^[4]
• Structure de la réponse de l'endpoint : Confirmez que la réponse contient un tableau data d'objets tickets et que le product_id dans chaque enregistrement correspond à celui que vous avez interrogé. ^[2]
• Exactitude des liens directs : Ouvrez au moins une URL de ticket générée dans un navigateur pour confirmer que le suffixe du centre de données et le segment du portail sont corrects pour votre environnement Zoho Desk. ^[3]

---

*Beam Help est une ressource d'assistance experte indépendante pour les produits Zoho et ne constitue pas le support officiel de Zoho. Pour les problèmes de facturation ou de compte, contactez Zoho directement.*