Analyses
Comprenez les questions que posent vos visiteurs et améliorez votre contenu à partir de données réelles.
:::info Accès aux formules
Depuis /dashboard, ouvrez un chatbot, puis choisissez Conversations. Les vues Analyses et Questions sans réponse sont incluses dans les offres Pro et Business ; les vues indisponibles affichent une invitation à passer à une offre supérieure. Historique et Tester le chatbot sont disponibles sur toutes les formules. Ces vues concernent le projet, et non les indicateurs Aperçu de l’espace de travail.
:::
Utilisez la checklist de lancement pour valider votre déploiement, puis comparez les offres et limites avant de choisir votre parcours d’évaluation.
Vue d’ensemble du tableau de bord
Ouvrez Conversations → Analyses (/chatbot/<projectId>?tab=analytics). Le tableau de bord utilise les 30 derniers jours et au plus les 5 000 interactions enregistrées les plus récentes. Cette fenêtre de reporting ne définit pas la durée de conservation des données. Cet onglet ne propose ni sélecteur de dates ni export complet ; en cas de volume élevé, les résultats peuvent donc être plafonnés et ne pas couvrir tout le trafic de la période.
Le tableau de bord affiche :
- Nombre total de questions - Interactions enregistrées sur cette période, dans la limite du plafond
- Répondues - Interactions pour lesquelles la génération a réussi et que le détecteur de lacunes n’a pas signalées
- Sans réponse - Autres interactions enregistrées, notamment les réponses de repli faute de contexte et les échecs de génération
- Taux de réponse - Interactions répondues divisées par le total des interactions enregistrées
Il s’agit de classifications automatiques, pas d’une mesure vérifiée de l’exactitude des réponses, de la satisfaction client, des visiteurs uniques ni des tickets évités. Les lacunes de contenu sont un sous-ensemble des interactions sans réponse : les échecs de génération peuvent être comptés sans créer de lacune. Le détecteur examine le contexte des sources, certaines formulations de repli et certains termes propres à la question ; il peut se tromper. Tester le chatbot contribue aussi à ces chiffres et consomme le quota de messages du propriétaire. Ce n’est ni un rapport réservé aux visiteurs ni le registre d’utilisation de la facturation ; les requêtes échouées ne produisent pas nécessairement d’enregistrement analytique.
Conversations et journaux
Ouvrez Conversations → Historique (?tab=logs) pour parcourir les conversations enregistrées du projet. Sélectionnez une ligne pour lire les messages et leurs horodatages dans une vue séparée en lecture seule ; sélectionnez-la à nouveau ou utilisez Historique dans cette vue pour revenir à la liste. Vous pouvez supprimer une conversation ou toutes les conversations après confirmation. Historique regroupe les tests du tableau de bord et le chat public ; ce n’est pas le journal interne des requêtes et erreurs d’API. La vue charge les 100 premiers messages enregistrés ; le nombre total indiqué sur une ligne peut donc être supérieur au nombre de messages affichés.
Tester le chatbot (?tab=test) permet aussi de sélectionner des conversations enregistrées, de démarrer une nouvelle conversation, de copier des réponses et de supprimer l’historique. Dans l’interface de test, ouvrez Conversations pour sélectionner une conversation enregistrée ou rechercher dans ses aperçus. La recherche filtre la page actuellement chargée, pas tous les messages du projet. Nouvelle conversation démarre une nouvelle conversation sans supprimer l’historique existant ; Effacer est une action destructive distincte. Avec le même conversationId, le générateur reçoit jusqu’à 12 messages enregistrés récents, chacun limité à 2 000 caractères. Ce contexte est limité et ne contient pas toute la transcription : ajoutez les détails plus anciens si nécessaire et gardez des identifiants de conversation distincts pour les visiteurs sans lien entre eux.
La suppression d’une conversation supprime ses messages, mais pas les enregistrements analytiques, les enregistrements de lacunes de contenu ni l’utilisation de messages déjà consommée. Les requêtes HTTP du widget utilisant une Idempotency-Key peuvent aussi laisser, après la suppression de la conversation, un enregistrement de rejeu distinct contenant l’empreinte de la requête (y compris le message) et la réponse. Ces enregistrements expirent après 24 heures ; leur nettoyage est séparé et peut avoir lieu plus tard.
Questions les plus fréquentes
Consultez les 10 textes de question les plus fréquents parmi les interactions enregistrées au cours des 30 derniers jours, dans la limite des 5 000 interactions les plus récentes. Avant le regroupement, le texte est débarrassé des espaces en début et en fin, converti en minuscules et tronqué à 500 caractères ; les questions formulées différemment ne sont pas regroupées sémantiquement. Utilisez cette liste pour :
- Comprendre ce qui intéresse le plus les visiteurs
- Prioriser les améliorations de contenu
- Identifier des opportunités de FAQ
Détection des lacunes de contenu
Ouvrez Conversations → Questions sans réponse (?tab=gaps) pour examiner les questions signalées par le détecteur de lacunes de contenu. Une lacune n’est pas liée à une phrase de repli précise : un contexte source manquant, une formulation de refus reconnue et certaines réponses trop générales peuvent tous produire une lacune. La vue affiche :
- Question - Ce que le visiteur a demandé
- Nombre - Le nombre de fois où cette question a été posée
- Dernière question posée - La dernière fois où cette question a été posée
Utilisez-les comme pistes à examiner, pas comme preuve qu’une page manque. Vérifiez d’abord la sélection des sources, la récupération, la formulation et la réponse réelle. Après avoir ajouté du contenu, relancez l’exploration dans les limites de votre quota de rafraîchissement, puis testez et sélectionnez Résoudre. La résolution est un indicateur de suivi manuel : elle n’entraîne pas le chatbot et ne vérifie pas la nouvelle réponse. Supprimer efface l’enregistrement de la lacune.
La liste masque les lacunes résolues par défaut. Sélectionnez Inclure les lacunes résolues. pour les afficher, puis Annuler pour en rouvrir une. Une occurrence ultérieure de la même question normalisée incrémente son compteur, mais ne la rouvre pas automatiquement. La liste prend les 100 enregistrements correspondants les plus récents, puis trie ce sous-ensemble par nombre d’occurrences ; le badge des lacunes non résolues est plafonné à 500. Ces enregistrements sont indépendants de la fenêtre de 30 jours de l’onglet Analyses.
Utilisez ces lacunes avec le guide de mesure de la réduction des tickets pour tester la couverture des questions répétées et comparer tout impact sur le support avec votre propre référence, plutôt que de supposer un résultat.
Heures de pointe
Consultez les cinq plages horaires ayant le plus d’interactions dans la même fenêtre analytique. Les heures sont enregistrées côté serveur et affichées sans conversion dans le fuseau horaire du visiteur ; elles ne permettent pas d’identifier celui de votre audience. Cela vous aide à :
- Planifier les mises à jour de contenu pendant les périodes de faible trafic
- Comparer les heures chargées et calmes sur une base cohérente
- Anticiper vos besoins en capacité si vous approchez des limites
Pages populaires
Le panneau s’appelle Déclencheurs populaires : il affiche les 10 URL des pages d’où proviennent les questions enregistrées, pas les pages de documentation les plus citées ni les pages vues. Le widget hébergé widget.js, y compris celui monté avec Chattybox.mountWidget(), envoie automatiquement le contexte de page avec les requêtes de chat : le pathname est conservé, mais pas les paramètres de requête ni le fragment. Évitez de charger ou de laisser le widget actif sur les routes sensibles ou privées. Dans une SPA, exclure une route du déclencheur de chargement initial ne retire pas un widget déjà initialisé ; démontez-le explicitement lorsque nécessaire.
Le SDK headless publié en version 0.1.4 accepte message, conversationId et idempotencyKey dans sendMessage(). Le code source actuel prend également en charge uiLocale pour les textes de repli gérés par le produit. Ni l’un ni l’autre ne prend en charge sourceUrl ou sourcePath. N’ajoutez pas d’option SDK non prise en charge pour obtenir une attribution de page. Tester le chatbot du tableau de bord n’a pas non plus d’URL de page source ; ses questions peuvent donc être comptées alors que Déclencheurs populaires est vide.
Pour une intégration HTTP directe, POST /chat accepte sourceUrl et/ou sourcePath en option. Le contexte de page nécessite une origine de requête HTTP(S), obtenue depuis Origin ou, à défaut, depuis l’origine de Referer ; sourceUrl doit correspondre à cette origine et ne pas contenir d’identifiants. Un sourcePath fourni doit commencer par / (et non //), ne contenir ni query string ni fragment et, si les deux champs sont envoyés, correspondre au pathname de l’URL. Le serveur supprime les query strings et fragments, puis normalise l’URL avant de l’enregistrer. Ne transmettez jamais de chemins privés ni de données sensibles concernant les visiteurs comme contexte de page. Le contexte de page sert aux analyses, y compris à la télémétrie des interactions ; il ne modifie pas les sources indexées récupérées par l’assistant.
Citations des sources
Les réponses peuvent inclure des liens cliquables vers les pages utilisées comme contexte récupéré. Ces liens peuvent aider les visiteurs à examiner les contenus pertinents, mais ne vérifient pas que chaque affirmation est étayée ou exacte. Comparez les affirmations importantes aux pages sources. Les liens vers les sources peuvent :
- Aider les visiteurs à évaluer la réponse
- Permettre aux utilisateurs de confronter les informations aux pages pertinentes
- Orienter les visiteurs vers ces pages
Le widget présente les citations dans une section déroulante native. Les visiteurs peuvent développer Sources pour consulter les liens cités sans interrompre la lecture de la réponse.
Améliorer votre taux de réponse
Conseils pour augmenter le nombre de questions auxquelles le bot répond :
- Examinez régulièrement les lacunes de contenu - Ajoutez les informations manquantes à votre site
- Extrayez davantage de pages - Incluez les pages de FAQ, la documentation d’aide et les articles de blog
- Utilisez des titres clairs - Un contenu bien structuré est plus facile à retrouver
- Gardez le contenu à jour - Activez l’exploration automatique selon la fréquence de votre formule et votre budget mensuel d’actualisation
- Retestez avant de résoudre - Vérifiez la réponse et ses citations au lieu de considérer un taux de réponse plus élevé comme une preuve d’exactitude