De Knowledge Base-widget stelt je gebruikers in staat om je kennisbank te zoeken en te bladeren zonder je website of applicatie te verlaten. In plaats van een nieuw tabblad te openen of contact op te nemen met support, krijgen gebruikers direct toegang tot relevante artikelen precies waar ze zijn — waardoor het aantal tickets wordt verminderd en de algehele supportervaring verbetert.
Je kunt tot 10 kennisbank-widgets in een project configureren. Je kunt echter maar één Knowledge Base-widget per domein of website configureren.
Wanneer je de kennisbank-widget gebruikt
De widget is nuttig in elke situatie waarin gebruikers contextuele hulp nodig hebben zonder de applicatie te hoeven verlaten:
- Gebruikersonboarding — Nieuwe gebruikers kunnen de basis leren, zoals het aanmaken van een account, het navigeren door de interface en het uitvoeren van veelvoorkomende taken, allemaal zonder van context te wisselen.
- Technische ondersteuning — Gebruikers die een fout of probleem tegenkomen, kunnen direct binnen de app naar een oplossing zoeken in plaats van een supportticket aan te vragen.
- Feature-ontdekking — Wanneer je nieuwe mogelijkheden uitbrengt, kunnen gebruikers via de widget relevante artikelen openen om te begrijpen wat er is veranderd en hoe ze het moeten gebruiken.
- Aangepaste bronlinking — Je kunt aangepaste links toevoegen in de widget om gebruikers naar externe bronnen zoals downloadbare gidsen, Google Sheets of andere ondersteuningskanalen te leiden.
Voordat je begint
- Je moet Project Owner of Admin-toegang hebben in Document360.
- Om Eddy AI binnen de widget in te schakelen, zorg ervoor dat je een actief Eddy AI-plan hebt en toegang hebt tot de instellingen van Eddy AI.
Hoe Eddy AI in te schakelen in de kennisbankwidget
Om AI-gestuurde ondersteunende zoekopdracht binnen de widget te activeren, voltooi je de volgende twee fasen.
Fase 1: Schakel Eddy AI in voor widgets in AI-instellingen
- Navigeer naar Instellingen () in de linker navigatiebalk van het kennisbankportaal.
- Klik in het linker navigatiepaneel, onder AI-instellingen, op Eddy AI-instellingen.
- Selecteer in de AI-hulpzoeksectie het vakje KB-widgets, chatbots en extensies aan.
Fase 2: Schakel AI-ondersteunend zoeken in de widget in
- Ga in de linker navigatiebalk naar de widget Connections > Knowledge Base.
- Om een nieuwe widget aan te maken, klik je op Widget toevoegen en voer je een naam in.
- Om een bestaande widget te bewerken, zweef je eroverheen en klik je op Bewerken ().
- Schakel in het tabblad Configure & Connect de AI Assistive zoekschakelaar in.
.png)
- Klik op Opslaan.
Er zijn drie contentniveaus beschikbaar bij het instellen van de widget: Project, Werkruimte en Categorie. Wanneer je categorie selecteert, wordt het dropdown Werkruimte niet weergegeven in de widgetconfiguratie.
Wat lezers met de widget kunnen doen
Zodra de widget live is, kunnen lezers deze gebruiken om:
- Zoek naar artikelen — Voer een trefwoord in om relevante artikelen te vinden zonder het huidige scherm te verlaten. Overeenkomende zoekwoorden worden in de resultaten gemarkeerd.
- Neem contact op met support — Gebruik aangepaste links om een e-mailadres of een supportlink toe te voegen, waardoor het aantal stappen om hulp te krijgen wordt verminderd.
- Bekijk voorgestelde artikelen — Contextuele artikelsuggesties verschijnen op basis van de pagina waarop de lezer zich momenteel bevindt, waarbij nuttige inhoud proactief naar voren komt.
- Toegang tot aangepaste links — Leid lezers naar elke externe bron, zoals een eBook-download of een spreadsheet, via aangepaste links die aan de widget zijn toegevoegd.
De widget opent in de standaard browsertaal van de gebruiker. Als die taal niet beschikbaar is in de widget, wordt in plaats daarvan de standaardtaal van de kennisbank gebruikt.
Widgetspecificaties
| Limiet | Detail |
|---|---|
| Maximale widgets per project | 10 |
| Widgets per domein/website | 1 |
| Configuratie-cacheverversing | Elke 15 minuten |
| Private KB-embedding | Niet direct ondersteund; gebruik de widget met JWT voor private kennisbases |
| Ondersteunde Eddy AI-talen | Engels (en-US, en-GB), Frans (fr), Spaans (es), Duits (de), Noors (no), Nederlands (nl) |
Configureerbare widgetinstellingen
De volgende instellingen zijn beschikbaar onder de widgetconfiguratie:
- Installatie & installatie — Kopieer en installeer de widget JavaScript-code
- Aangepaste CSS — Pas aangepaste stijlen toe die aansluiten bij het ontwerp van je product
- Aangepaste JavaScript — Voeg aangepaste scripts toe om het gedrag van widgets uit te breiden
- URL mapping — Toon specifieke artikelen of categorieënlijsten op basis van de pagina-URL
De optie autosave is beschikbaar bij het navigeren tussen deze tabbladen.
De widget gebruikt een cache van 15 minuten. Configuratiewijzigingen gaan in nadat de cache is ververst.
Best practices
-
Gebruik één widget per domein. Het configureren van meer dan één widget op hetzelfde domein kan onverwacht gedrag veroorzaken.
-
Scope content-toegang. Gebruik de instellingen voor content-toegang om widgetresultaten te beperken tot een specifieke werkruimte of categorie, vooral wanneer de widget in een gefocust productgebied is ingebed.
-
Beperk widget tot vertrouwde domeinen. Voeg je domein toe aan de sectie Widgetbeveiliging om ongeoorloofd gebruik van de widget API-sleutel te voorkomen.
-
Gebruik URL-mapping voor contextuele suggesties. Koppel relevante artikelen of categorielijsten aan specifieke pagina's zodat gebruikers content zien die relevant is voor hun huidige taak.
-
Gebruik JWT voor privékennisbanken. Als je kennisbank privé of beperkt is, configureer dan JWT-authenticatie in de widget om naadloze single sign-on toegang mogelijk te maken.
FAQ
Hoe is de kennisbank-widget nuttig voor gebruikers?
De widget helpt in drie hoofdscenario's: onboarding (nieuwe gebruikers kunnen de app leren kennen zonder van context te wisselen), technische ondersteuning (gebruikers zoeken naar oplossingen zonder contact op te nemen met support), en feature discovery (gebruikers leren over nieuwe mogelijkheden zodra deze worden uitgebracht).
Moet ik de widget opnieuw instellen bij het overschakelen van een publieke naar een private kennisbank?
Nee, je hoeft de widget niet opnieuw in te stellen. Gebruikers moeten echter inloggen om artikelen op de kennisbanksite te bekijken. Om de inlogvereiste te omzeilen, configureer je de JWT (JSON Web Token) functie in de widget-instellingen.
Hoe integreer ik een privékennisbasis in een andere applicatie?
Het direct inbedden van een privékennisbank in een andere applicatie wordt niet ondersteund. Gebruik de knowledge base-widget met JWT-authenticatie om je private knowledge base in je applicatie te integreren.
Is het mogelijk om meerdere kennisbank-widgets te configureren?
Ja, je kunt tot 10 knowledge base-widgets in een project configureren. Echter, er kan slechts één widget per domein of website worden geconfigureerd voor optimale prestaties.