Je kunt meer dan één Knowledge Base-widget maken binnen één Document360-project. Een veelvoorkomend gebruiksscenario is het onderhouden van een aparte testwidget naast een live productiewidget, zodat je veilig kunt experimenteren met configuratiewijzigingen zonder dat lezers worden beïnvloed.
Wanneer je meerdere widgets moet gebruiken
- Je hebt een staging-widget nodig om styling, URL-mapping of content-toegangswijzigingen te testen voordat je ze in productie toepast.
- Je bedient verschillende doelgroepen (verschillende producten, regio's of toegangsniveaus) en wilt aparte widgetconfiguraties voor elk.
Instellingen die per widget geïsoleerd blijven
Elke widget heeft zijn eigen onafhankelijke configuratie voor:
- Widgetnaam
- Styling (kleur, pictogram, positie, welkomstbericht, widget verbergen, meest gezochte artikelen verbergen)
- Contenttoegang (werkruimte, taal, categoriezichtbaarheid)
- Aangepaste links
- Domeinbeperking
Wijzigingen die aan een van bovenstaande instellingen op één widget worden aangebracht, hebben geen invloed op andere widgets in het project.
Instellingen gedeeld tussen widgets
Als JWT-authenticatie is ingeschakeld, wordt het clientgeheim gedeeld tussen alle JWT-geschikte widgets en chatbots in hetzelfde project, ongeacht van welke widget je het opnieuw genereert.
Het regenereren van het clientgeheim op één widget — inclusief een testwidget — zal onmiddellijk de authenticatie op alle andere JWT-geschikte widgets in het project breken totdat alle backend-integraties zijn bijgewerkt met het nieuwe geheim.
Als je een testwidget gebruikt om JWT-gerelateerde wijzigingen te proberen, vermijd dan het regenereren van het clientgeheim tenzij je klaar bent om alle backend-integraties tegelijk bij te werken.
Voor volledige details over de JWT-setup, zie JWT configureren voor de knowledge base-widget.
Best practices
- Gebruik een duidelijke naamgevingsconventie om test- en productiewidgets te onderscheiden (bijv. "Widget — Productie", "Widget — Test").
- Gebruik domeinbeperking op de productie-widget om ervoor te zorgen dat deze alleen op je live-domein laadt, terwijl de test-widget beperkt kan zijn tot een staging-domein.
FAQ
Ik heb wijzigingen aangebracht in mijn testwidget en mijn live-widget ging kapot. Waarom?
De meeste widget-instellingen (styling, content-toegang, links, domeinbeperking) zijn per widget geïsoleerd en hebben geen invloed op andere widgets. De enige uitzondering is het JWT-clientgeheim, dat gedeeld wordt door alle JWT-geschikte widgets en chatbots in het project. Als het clientgeheim opnieuw is gegenereerd op je testwidget, maakt het ook authenticatie op je live widget ongeldig totdat het nieuwe geheim is bijgewerkt in de backend-integratie.
De kennisbank-widget wordt niet geladen op de kennisbanksite. Hoe kan ik dit oplossen?
De widget laadt mogelijk niet als de API-sleutel in het ingebedde script verouderd is. Kopieer het huidige script uit de Connections > Knowledge Base-widget > Kopieer het script en vervang het verouderde script op je site.