Beam Help — support expert indépendant pour Zoho. Cet article présente des moyens pratiques de récupérer des produits dans Zoho Desk afin que les agents ou les scripts clients puissent afficher les enregistrements de produits pour les tickets ou les widgets[8][7].
Pourquoi c'est important
Les agents doivent souvent lier un produit à un ticket afin que l'historique du support et le contexte de l'actif accompagnent la conversation[8]. Les développeurs et les administrateurs créant des widgets côté client peuvent avoir besoin de récupérer des listes de produits (par exemple, par catégorie) et de renvoyer les éléments sélectionnés à l'appelant[7].
Étape par étape
- Ouvrez le module Produits dans Zoho Desk pour afficher les produits de l'entreprise. Les produits sont gérés au niveau de l'organisation et sont disponibles pour les agents afin de les associer aux tickets[8].[8]
- Utilisez les champs de produit sur un ticket pour lier un article. Les entrées du module Produits peuvent être associées à des tickets afin que les agents enregistrent le produit concerné par un ticket[8].[8]
- Lorsque vous avez besoin d'un sélecteur personnalisé ou d'une liste filtrée, créez un widget qui interroge le module Produits. Les widgets peuvent récupérer des produits en fonction d'une catégorie de produit sélectionnée et afficher les résultats dans l'interface utilisateur du widget pour la sélection[7].[7]
- Préparez le code du widget pour capturer et renvoyer les sélections au script client. Dans l'exemple de widget, les produits récupérés sont stockés dans une variable (searchresponse), rendus dans le HTML du widget, et les éléments sélectionnés sont collectés dans un tableau avant d'être renvoyés avec $Client.close(selectedproducts)[7].[7]
- Téléchargez le zip du widget et créez-le à partir de Configuration > Espace développeur > Widgets. Accédez à Configuration, ouvrez Espace développeur, choisissez Widgets, et cliquez sur Créer un nouveau widget pour télécharger l'application HTML packagée[7].[7]
- Définissez l'hébergement du widget sur Zoho et spécifiez la page d'entrée HTML ; choisissez le type de bouton pour le rendu du script client. Le flux de création d'un nouveau widget nécessite que l'Hébergement soit défini sur "Zoho", le nom de la page que vous avez téléchargée, et que le widget utilise le type "bouton" lorsque vous prévoyez de le lancer à partir d'un script client[7].[7]
- Appelez le widget à partir de votre script client et recevez les produits sélectionnés. L'exemple de widget se termine en appelant $Client.close(selected_products) pour transmettre les produits choisis au script client et fermer la fenêtre du widget[7].[7]
- Vérifiez la disponibilité des produits et l'accès des agents dans les Paramètres de l'entreprise si les articles n'apparaissent pas. La configuration des produits au niveau de l'entreprise et les contrôles d'association se trouvent dans les Paramètres de l'entreprise de Desk, sous Ajout et Association de produits aux tickets, ce qui affecte la manière dont les produits sont disponibles pour les agents[8].[8]
Pièges courants
- Si votre widget renvoie une liste vide, vérifiez la logique de filtrage par catégorie de produit dans le widget plutôt que de supposer que Desk a bloqué la requête ; l'exemple stocke les résultats dans une variable search_response avant le rendu[7].[7]
- Si les agents ne peuvent pas lier de produits aux tickets, vérifiez que les produits existent dans la liste des produits de l'entreprise et que vos paramètres d'organisation exposent les produits aux agents comme prévu[8].[8]
Ce qu'il faut vérifier
- Confirmez que le produit apparaît dans votre liste de produits de l'entreprise Zoho Desk et qu'il est configuré pour être utilisé avec les tickets[8].[8]
- Si vous utilisez un widget, vérifiez que votre widget est téléchargé via Configuration > Espace développeur > Widgets, que l'hébergement est défini sur Zoho, et que le type de widget est "bouton" lorsqu'il est appelé à partir d'un script client[7].[7]
- Assurez-vous que votre widget renvoie les sélections à l'aide de $Client.close(selected_products) afin que le script client reçoive les objets produit choisis[7].[7]