Récupérer les conversations de l'Assistant

Utilisez cet endpoint pour exporter l’historique des conversations de l’Assistant IA à partir de votre documentation. Chaque conversation inclut la requête de l’utilisateur, la réponse de l’Assistant IA, les sources citées, le statut de résolution et la catégorie de la requête.

Parcourez les résultats à l’aide du paramètre cursor renvoyé dans la réponse. Continuez à récupérer les données tant que hasMore vaut true.

Filtrez les conversations par plage de dates à l’aide des paramètres dateFrom et dateTo.

Chaque conversation comprend :

• query : la question de l’utilisateur
• response : la réponse de l’Assistant
• sources : les pages référencées dans la réponse, avec leur title et leur URL
• resolutionStatus : indique si l’Assistant a répondu correctement à la question. La valeur est answered ou unanswered. Utilisez ce champ pour suivre et analyser les lacunes de la documentation mises en évidence par les questions des utilisateurs auxquelles l’Assistant n’a pas pu répondre.
• queryCategory : la classification du type de requête (si disponible)
• pageUrl : URL complète de la page de documentation où la conversation a démarré, ou null si aucun chemin de page n’est disponible. Utilisez ce champ pour attribuer les conversations à une page spécifique.

Cet endpoint autorise 100 requêtes par organisation et par heure. Tous les endpoints d’analytics partagent cette limite.