Passer au contenu principal
L’assistant nécessite un forfait Pro ou Enterprise.
Lorsque l’assistant ne peut pas répondre à une question à partir de votre documentation, il peut transmettre l’utilisateur à votre équipe. Les utilisateurs disposent ainsi d’un moyen de joindre une personne au lieu de se retrouver dans une impasse. Choisissez où vont les questions de support dans le menu Support de la section Gestion des réponses, sur la page Assistant de votre tableau de bord : Si vous utilisez un help desk autre que Plain ou Zendesk, utilisez Link pour envoyer les utilisateurs vers sa page de contact ou son centre d’aide.

​
Envoyer les questions par e-mail

Dans le menu Support, sélectionnez Email, puis renseignez l’une ou les deux adresses suivantes :
  • Support email : Pour les questions que l’assistant ne peut pas résoudre à partir de votre documentation.
  • Ventes : Pour les questions sur les tarifs, les offres ou les achats.
Lorsque l’assistant détecte une question correspondante, un formulaire de contact s’affiche dans le chat. Le formulaire demande le prénom, le nom, l’entreprise, l’e-mail professionnel et un message de l’utilisateur. Mintlify envoie la soumission par e-mail à l’équipe appropriée, qui peut répondre directement à l’e-mail de l’utilisateur. Le même formulaire de contact est disponible dans le widget de l’assistant intégré sur d’autres sites.
Si vous préférez rediriger les questions de support vers vos canaux existants, désactivez Contact form dans la section Gestion des réponses.Lorsque vous désactivez le formulaire de contact, l’assistant redirige les utilisateurs vers votre adresse e-mail de support en texte brut au lieu d’afficher le formulaire dans le chat. Les questions commerciales continuent d’utiliser le formulaire dans le chat lorsque vous configurez un e-mail commercial.
Dans le menu Support, sélectionnez Link pour envoyer les utilisateurs vers votre plateforme de support existante, comme un centre d’aide, un portail de tickets ou un forum communautaire, au lieu de collecter leur e-mail via un formulaire dans le chat. Saisissez l’URL complète de votre destination de support. L’URL doit utiliser http ou https et ne peut pas contenir d’identifiants. Lorsque l’assistant détecte une question de support, il affiche à l’utilisateur une carte contenant un lien vers votre URL de support. Mintlify ajoute l’identifiant du fil de conversation de l’assistant en tant que paramètre de requête threadId, afin que votre outil de support puisse joindre la transcription de la conversation au ticket créé. Récupérez la transcription avec l’endpoint Obtenir un fil de conversation de l’assistant. Lorsque Link est sélectionné, l’assistant n’affiche pas le formulaire de contact et ne redirige pas les questions commerciales.

​
Créer des tickets dans Plain ou Zendesk

L’assistant peut enregistrer les demandes de support sous forme de tickets dans Plain ou Zendesk au lieu de les envoyer par e-mail. Avant de connecter Plain, créez une clé d’API Plain avec ces autorisations :
  • customer:create
  • customer:edit
  • customer:read
  • thread:create
  • thread:read
  1. Dans la section Response handling du menu Support, sélectionnez Direct support ticketing.
  2. Sélectionnez une Ticketing platform : Plain ou Zendesk.
  3. Sur la carte de la plateforme, cliquez sur Connect et terminez la connexion dans la fenêtre qui s’ouvre. Pour Plain, utilisez la clé d’API que vous avez créée.
Mintlify n’enregistre la création directe de tickets de support qu’une fois la plateforme connectée. D’ici là, votre option de support actuelle reste active. La connexion est une intégration partagée pour votre organisation. Lorsque l’assistant détecte une question de support, il affiche le formulaire de contact dans le chat. Mintlify crée un ticket dans votre plateforme connectée à partir de la soumission. Le ticket inclut les coordonnées et le message de l’utilisateur, ainsi que jusqu’aux trois premiers messages de la conversation avec l’assistant. Si la conversation est plus longue, le ticket renvoie vers la conversation complète dans votre dashboard. Si vous avez enregistré une adresse Ventes sous Email, les questions commerciales sont toujours envoyées par e-mail à cette adresse. S’il manque à la clé d’API Plain l’une des autorisations requises, la carte de la plateforme affiche Scopes misconfigured. Cliquez sur Configure pour voir les autorisations manquantes, puis ajoutez-les à la clé d’API dans Plain.