Le widget de la base de connaissances permet à vos utilisateurs de rechercher et de parcourir votre base sans quitter votre site web ou application. Au lieu d’ouvrir un nouvel onglet ou de contacter le support, les utilisateurs ont un accès instantané aux articles pertinents là où ils se trouvent — réduisant le volume des tickets et améliorant l’expérience globale du support.
Vous pouvez configurer jusqu’à 10 widgets de la base de connaissances dans un projet. Cependant, vous ne pouvez configurer qu’un seul widget de base de connaissances par domaine ou site web.
Quand utiliser le widget de la base de connaissances
Le widget est utile dans tout scénario où les utilisateurs ont besoin d’aide contextuelle sans quitter l’application :
- Intégration des utilisateurs — Les nouveaux utilisateurs peuvent apprendre les bases, comme créer un compte, naviguer dans l’interface et accomplir des tâches courantes, le tout sans changer de contexte.
- Support technique — Les utilisateurs rencontrant une erreur ou un problème peuvent rechercher une solution directement dans l’application au lieu de lancer un ticket de support.
- Découverte de fonctionnalités — Lorsque vous publiez de nouvelles fonctionnalités, les utilisateurs peuvent accéder aux articles pertinents via le widget pour comprendre ce qui a changé et comment l’utiliser.
- Lien personnalisé vers des ressources — Vous pouvez ajouter des liens personnalisés dans le widget pour orienter les utilisateurs vers des ressources externes telles que des guides téléchargeables, Google Sheets ou d’autres canaux de support.
Avant que tu commences
- Vous devez avoir un accès Propriétaire de projet ou Administrateur dans Document360.
- Pour activer Eddy AI dans le widget, assurez-vous d’avoir un plan Eddy AI actif et d’accéder aux paramètres Eddy AI.
Comment activer Eddy AI dans le widget de la base de connaissances
Pour activer la recherche assistée alimentée par IA dans le widget, complétez les deux étapes suivantes.
Étape 1 : Activer Eddy AI pour les widgets dans les paramètres IA
- Naviguez dans Paramètres () dans la barre de navigation de gauche du portail de la base de connaissances.
- Dans le panneau de navigation de gauche, dans les paramètres IA, cliquez sur Paramètres IA de Eddy.
- Dans la section recherche assistée par IA , sélectionnez la case widgets de la base de données, chatbots et extensions .
Étape 2 : Activez la recherche assistée par IA dans le widget
- Dans la barre de navigation de gauche, naviguez jusqu’au widget Connexions > Base de connaissances.
- Pour créer un nouveau widget, cliquez sur Ajouter widget et saisissez un nom.
- Pour modifier un widget existant, survolez la souris et cliquez sur Modifier ().
- Dans l’onglet Configurer & Connecter , activez le bouton de recherche assistée par IA .
.png)
- Cliquez sur Enregistrer.
Trois niveaux de contenu sont disponibles lors de la configuration du widget : Projet, Espace de travail et Catégorie. Lorsque vous sélectionnez Catégorie, le menu déroulant de l’espace de travail n’apparaît pas dans la configuration du widget.
Ce que les lecteurs peuvent faire avec le widget
Une fois le widget en ligne, les lecteurs peuvent l’utiliser pour :
- Recherchez des articles — Saisissez un mot-clé pour trouver des articles pertinents sans quitter l’écran actuel. Les mots-clés correspondants sont mis en évidence dans les résultats.
- Contactez le support — Utilisez des liens personnalisés pour ajouter une adresse e-mail ou un lien de support, réduisant ainsi les étapes nécessaires pour obtenir de l’aide.
- Voir les articles suggérés — Les suggestions d’articles contextuels apparaissent en fonction de la page sur laquelle se trouve le lecteur, faisant remonter de manière proactive le contenu utile.
- Accéder à des liens personnalisés — Dirigez les lecteurs vers toute ressource externe, comme un téléchargement d’eBook ou un tableur, en utilisant des liens personnalisés ajoutés au widget.
Le widget s’ouvre dans le langage de navigateur par défaut de l’utilisateur. Si ce langage n’est pas disponible dans le widget, le langage par défaut de la base de connaissances est utilisé à la place.
Spécifications des widgets
| Limite | Détails |
|---|---|
| Widgets maximaux par projet | 10 |
| Widgets par domaine/site web | 1 |
| Rafraîchissement du cache de configuration | Toutes les 15 minutes |
| Intégration privée de la base de connaissances | Non supporté directement ; utilise le widget avec JWT pour des bases de connaissances privées |
| Langages d’IA Eddy pris en charge | Anglais (EN-US, EN-GB), Français (fr), Espagnol (es), Allemand (de), Norvégien (no), Dutch (nl) |
Paramètres de widgets configurables
Les réglages suivants sont disponibles dans la configuration du widget :
- Installation et configuration — Copier et installer le code JavaScript du widget
- CSS personnalisé — Appliquez des styles personnalisés pour correspondre au design de votre produit
- JavaScript personnalisé — Ajouter des scripts personnalisés pour étendre le comportement des widgets
- Mappage d’URL — Afficher des articles spécifiques ou des listes de catégories en fonction de l’URL de la page
L’option de sauvegarde automatique est disponible lors de la navigation entre ces onglets.
Le widget utilise un cache de 15 minutes. Les modifications de configuration prennent effet après le rafraîchissement du cache.
Meilleures pratiques
-
Utilisez un widget par domaine. Configurer plus d’un widget sur le même domaine peut provoquer des comportements inattendus.
-
Limitez l’accès au contenu. Utilisez les paramètres d’accès au contenu pour limiter les résultats des widgets à un espace de travail ou une catégorie spécifique, surtout lorsque le widget est intégré dans une zone de produit ciblée.
-
Restreignez le widget aux domaines de confiance. Ajoutez votre domaine dans la section Sécurité des widgets pour éviter toute utilisation non autorisée de la clé API du widget.
-
Utilisez la cartographie d’URL pour des suggestions contextuelles. Associez les articles ou listes de catégories pertinents à des pages spécifiques afin que les utilisateurs voient le contenu pertinent pour leur tâche en cours.
-
Utilisez JWT pour des bases de connaissances privées. Si votre base de connaissances est privée ou restreinte, configurez l’authentification JWT dans le widget pour permettre un accès simple à connexion unique sans faille.
FAQ
En quoi le widget de la base de connaissances est-il utile pour les utilisateurs ?
Le widget aide dans trois scénarios principaux : l’intégration (les nouveaux utilisateurs peuvent apprendre l’application sans changer de contexte), le support technique (les utilisateurs recherchent des solutions sans contacter le support) et la découverte de fonctionnalités (les utilisateurs découvrent de nouvelles fonctionnalités au fur et à mesure qu’elles sont publiées).
Dois-je reconfigurer le widget lorsque je passe d’une base de connaissances publique à une base de connaissances privée ?
Non, vous n’avez pas besoin de configurer à nouveau le widget. Cependant, les utilisateurs devront se connecter pour consulter les articles sur le site de la base de connaissances. Pour contourner l’exigence de connexion, configurez la fonctionnalité JWT (JSON Web Token) dans les paramètres du widget.
Comment puis-je intégrer une base de connaissances privée dans une autre application ?
L’intégration directe d’une base de connaissances privée dans une autre application n’est pas prise en charge. Utilisez le widget de base de connaissances avec authentification JWT pour intégrer votre base de connaissances privée dans votre application.
Est-il possible de configurer plusieurs widgets de base de connaissances ?
Oui, vous pouvez configurer jusqu’à 10 widgets de base de connaissances dans un projet. Cependant, un seul widget peut être configuré par domaine ou site web pour des performances optimales.