Vous pouvez créer plus d’un widget de base de connaissances au sein d’un même projet Document360. Un cas d’usage courant est de maintenir un widget de test séparé en parallèle d’un widget de production en direct, afin de pouvoir expérimenter en toute sécurité les modifications de configuration sans affecter les lecteurs.
Quand utiliser plusieurs widgets
- Vous avez besoin d’un widget de staging pour tester le style, le mappage d’URL ou les modifications d’accès au contenu avant de les appliquer à la production.
- Vous servez différents publics (produits, régions ou niveaux d’accès différents) et souhaitez des configurations de widgets séparées pour chacun.
Paramètres qui restent isolés par widget
Chaque widget a sa propre configuration indépendante pour :
- Nom du widget
- Style (couleur, icône, position, message de bienvenue, masquer le widget, masquer les articles les plus recherchés)
- Accès au contenu (espace de travail, langue, visibilité par catégorie)
- Liens personnalisés
- Restriction de domaine
Les modifications apportées à l’un des paramètres ci-dessus sur un widget n’affectent aucun autre widget du projet.
Paramètres partagés entre widgets
Si l’authentification JWT est activée, le secret client est partagé entre tous les widgets et chatbots compatibles JWT dans le même projet, quel que soit le widget dont vous le régénérez.
Régénérer le secret client sur un widget — y compris un widget de test — cassera immédiatement l’authentification sur tous les autres widgets compatibles JWT du projet jusqu’à ce que toutes les intégrations backend soient mises à jour avec le nouveau secret.
Si vous utilisez un widget de test pour essayer des modifications liées à JWT, évitez de régénérer le secret client à moins d’être prêt à mettre à jour toutes les intégrations backend en même temps.
Pour tous les détails de configuration de JWT, voir Configurer JWT pour le widget de la base de connaissances.
Meilleures pratiques
- Utilisez une convention de nommage claire pour distinguer les widgets de test et de production (par exemple « Widget — Production », « Widget — Test »).
- Utilisez une restriction de domaine sur le widget de production pour s’assurer qu’il ne charge que sur votre domaine en ligne, tandis que le widget de test peut être limité à un domaine de staging.
FAQ
J’ai apporté des modifications à mon widget de test et mon widget live a cassé. Pourquoi ?
La plupart des paramètres des widgets (style, accès au contenu, liens, restriction de domaine) sont isolés par widget et n’affectent pas les autres widgets. La seule exception est le secret client JWT, qui est partagé entre tous les widgets et chatbots compatibles JWT du projet. Si le secret client a été régénéré sur votre widget de test, cela invalide également l’authentification sur votre widget en ligne jusqu’à ce que le nouveau secret soit mis à jour dans son intégration backend.
Le widget de la base de connaissances ne se charge pas sur le site de la base de connaissances. Comment puis-je régler ça ?
Le widget peut ne pas se charger si la clé API du script intégré est obsolète. Copiez le script actuel depuis le widget Connections > Knowledge Base > Copy script et remplacez le script obsolète sur votre site.