URL-mapping stelt je in staat om te configureren wat de Knowledge Base-widget pagina voor pagina toont. Voor elke URL op je website of applicatie kun je een specifiek artikel, een categorielijst, een zoekbalk met een aangepaste placeholder, of de widget volledig verbergen. Dit maakt de widget contextbewust — gebruikers zien de meest relevante hulpcontent op basis van waar ze zich bevinden in je product.
Om URL-mapping te laten werken, moet de Knowledge Base-widget binnen je site of app zijn geïnstalleerd. Voor meer informatie, lees het artikel over het installeren van de kennisbank-widget.
Wanneer URL mapping te gebruiken
- Zet een specifiek artikel direct in de widget naar boven op een pagina waar gebruikers het vaak nodig hebben.
- Toon een zorgvuldig samengestelde lijst van artikelen uit een categorie wanneer een gebruiker zich in een specifieke productmodule bevindt.
- Verberg de widget op pagina's waar deze niet zou moeten verschijnen (bijvoorbeeld inlogpagina's, afrekenstromen).
- Toon een aangepaste zoekplaatsvervanger om gebruikers te begeleiden waar ze naar moeten zoeken in een bepaalde context.
- Gebruik AI-gestuurde contextuele ondersteuning (pagina-niveau prompting) voor specifieke URL's.
Voordat je begint
De inhoud die je wilt mappen (artikelen of categorieën) moet binnen het geconfigureerde contenttoegangsdomein van de widget vallen.
Acties
Er zijn vijf acties die je kunt uitvoeren met URL-mapping:
| Actie | Wat het doet |
|---|---|
| Show-artikel | Toont één artikel op de opgegeven URL |
| Toon lijst van artikelen | Geeft geselecteerde artikelen op onder de sectie Aanbevolen binnen de widget op de opgegeven URL |
| Contextuele AI-ondersteuning | Hiermee kun je AI-gestuurde prompts binnen de widget maken en gebruiken |
| Toon zoekresultaten | Stelt een specifieke zoekterm in om je kennisbank te doorzoeken, waarbij relevante resultaten worden teruggegeven op de opgegeven URL |
| Widget verbergen | Voorkomt dat het widget-icoon op de opgegeven URL verschijnt |
De actie 'Toon lijst van artikelen' toont inhoud in het gedeelte Meest gezocht artikelen van de widget. Als de schakelaar 'Meest gezochte artikelen verbergen ' is ingeschakeld in de widgetinstellingen, wordt deze sectie verborgen en verschijnt de lijst met toegewezen artikelen niet. Zorg ervoor dat deze instelling is uitgeschakeld zodat URL-mapping zoals verwacht werkt.
URL-parameters
Bij het configureren van de widget-URL kun je drie soorten parameters toevoegen:
- Neem het pad op:
/thisis/a/path - Vraag toevoegen:
?animal=bear - Hash opnemen:
#inbox
Je kunt ook de schakelaar Is Regex inschakelen om reguliere expressies in je URL-configuraties te integreren.
Hoe voeg je een URL-mapping toe
.gif)
-
Ga in de linker navigatiebalk naar Connections () > Knowledge base-widget.
-
Beweeg je muis over de gewenste widget en klik op Bewerken ().
-
Klik op het tabblad URL-toewijzing .
-
Klik op Nieuwe URL mapping en specificeer het volgende:
-
Naam — De URL-mappingnaam wordt alleen weergegeven op het URL-mappingrecord binnen Document360.
-
URL-structuur — Selecteer het gewenste URL-parametertype (Pad opnemen / Query opnemen / Hash insluiten). Je moet minstens één URL-parameter inschakelen. Voer de URL in waarop je wilt dat het artikel of de actie verschijnt.
OPMERKINGJe domeinnaam is niet opgenomen in het URL-pad. Bijvoorbeeld, voor
https://document360.com/ebook/rapid-guide/, zou het URL-pad zijn/ebook/rapid-guide/. -
Actie — Selecteer de gewenste actie.
-
Selecteer werkruimte — Selecteer de gewenste versie (als je meerdere versies hebt).
-
Taal naar — Selecteer de gewenste taal (als je meerdere talen hebt).
-
Artikel om te tonen — Selecteer in de zoekbalk de artikelen of categorieën die je wilt tonen.
OPMERKINGMappencategorieën zijn niet beschikbaar om te selecteren. Er zijn alleen pagina- en indexcategorieën beschikbaar.
-
-
Klik op Aanmaken.
Zodra een eindgebruiker de opgegeven URL opent en de widget opent, ziet hij het toegewezen artikel of de categorie. Deze inhoud blijft behouden terwijl ze navigeren tussen de widgettabbladen binnen dezelfde versie en taal.
URL-mappings bewerken

- Navigeer naar Connections () > Knowledge Base-widget.
- Beweeg je muis over de gewenste widget en klik op Bewerken ().
- Vind in het tabblad URL-mapping de lijst met beschikbare mappings.
- Beweeg je muis over de gewenste mapping en klik op Bewerken ().
- Het URL bijwerken paneel verschijnt.
- Werk de gewenste informatie bij en klik op Updaten.
URL-toewijzingen verwijderen
.png)
- Navigeer naar Connections () > Knowledge base-widget.
- Beweeg je muis over de gewenste widget en klik op Bewerken ().
- Vind in het tabblad URL-mapping de lijst met beschikbare mappings.
- Beweeg je muis over de gewenste mapping en klik op Verwijderen ().
- Klik op Ja in de bevestigingsprompt Verwijderen .
URL-mappinginstellingen (standaardgedrag)
Je kunt het gedrag van de widget definiëren voor URL's zonder geconfigureerde mapping.

- Navigeer naar Connections () > Knowledge Base-widget.
- Beweeg je muis over de gewenste widget en klik op Bewerken ().
- Klik op het tabblad Configureren & verbinden .
- Onder Instellingen instellen wilt u de sectie URL-mappinginstellingen uitbreiden.
- Selecteer de gewenste optie:
- Ga naar de help/kennisbank van de pagina — Toon het artikel of de categorie in het tabblad Paginahulp of Kennisbank in de widget.
- Breng geen wijzigingen aan aan de bestaande opstelling — Toon het laatst geopende artikel of de categorie in de widget.
- Klik op Opslaan.
Contextuele AI-ondersteuning configureren
De Contextuele AI-hulpactie stelt je in staat AI-gestuurde prompts in de widget weer te geven op basis van de paginacontext. Prompts kunnen verschijnen wanneer gebruikers op een knop klikken of automatisch wanneer ze een specifieke pagina openen.

Om contextuele AI-ondersteuning te configureren, zorg ervoor dat AI-ondersteunend zoeken voor de widget is ingeschakeld.
Je kunt Contextuele AI-ondersteuning op twee manieren configureren:
- Knopgebaseerde prompting — Toont contextbewuste hulp wanneer lezers op specifieke knoppen op je website of app klikken.
- Pagina-niveau prompting — Biedt automatisch AI-gestuurde hulp wanneer gebruikers een specifieke pagina openen, zonder dat er een knop hoeft te interacteren.
Knopgebaseerde prompting
Elke prompt die je toevoegt genereert een unieke Trigger-toets. De prompt wordt automatisch gevalideerd door Enter in te drukken om te bevestigen of er een antwoord is gevonden in de gekoppelde bronnen. Je kunt tot 5 button–prompt-mappings per URL configureren.

- In de sectie Contextuele AI-hulp Configureren , laat je het vinkje Pagina-niveau inschakelen niet aangevinkt.
- Voer je zoekopdracht in.
- Druk Enter om te valideren.
- Als een antwoord wordt gevonden, verschijnt er een groen label 'Antwoord gevonden '.
- Als er geen antwoord wordt gevonden, verschijnt er een rood label 'Antwoord niet gevonden '.
- Als je een bestaande knop bijwerkt, kopieer dan de Trigger-toets en voeg deze toe aan de code van de knop met behulp van het
d360AIHelpattribuut:

<button d360AIHelp="no6gNpyDqtyBhCVFMhYDXhugZ">Need help?</button>
- Als je een nieuwe knop aanmaakt, klik dan op Code kopiëren naast Installatiecode en plak het fragment in de HTML van je pagina.

- Om een nieuwe prompt toe te voegen, klik je op Meer toevoegen en herhaal je. Om een prompt te verwijderen, klik op Verwijderen.
Pagina-niveau prompting

- Selecteer het vakje 'Pagina-niveau prompt' inschakelen .
- Voer je in het zoekpromptveld je zoekopdracht in.
- Druk Enter om de prompt te valideren.
- Groen antwoord gevonden = antwoord beschikbaar.
- Rood antwoord niet gevonden = geen match.
- Om een extra prompt toe te voegen, klik je op Meer toevoegen. Je kunt tot 5 prompts per URL toevoegen.
- De eerste prompt verschijnt als de primaire vraag.
- Overige prompts verschijnen als voorgestelde zoekopdrachten.
- Om een prompt te verwijderen, klik je naast de prompt op Verwijderen .
Eenmaal geconfigureerd, klik dan op Aanmaken.
Je kunt standaard URL-mappingacties (zoals artikel tonen) combineren met contextuele AI-ondersteuning over verschillende URL's om een op maat gemaakte, intelligente gebruikerservaring te bieden.
Regex gebruiken in URL-mapping
Het begrijpen van URL-matching is belangrijk voor effectieve URL-mapping. Schakel de schakelaar Is Regex in bij het toevoegen of bewerken van een mapping om reguliere expressies te gebruiken.
Veelvoorkomende regexpatronen
| URL-structuur | Regex-configuratie |
|---|---|
/buckets |
/buckets$ (matcht URL's die eindigen op buckets) |
/buckets?isCreatingBucket |
/buckets\?[a-z]* (koppelt URL's aan willekeurige tekst na de queryparameter) |
Kaart een URL-patroon zoals /users/{id}:
^/users/[0-9]+$
Kaart /blog/* (joker):
^/blog/.*?$
Kaart /search?q={query}:
^/search?q=[a-zA-Z0-9]+$
Map subdomein-URL's:
^https?://?[a-zA-Z0-9-]+.example.com$
Wanneer je je URL regex test op https://regex101.com, voeg dan een achterwaartse slash (\) toe vóór elke voorwaartse slash (/).
Beperkingen en beperkingen
- URL-mappings moeten content gebruiken binnen het content-toegangsbereik van de widget. Als de scope verandert, kunnen bestaande mappings ongeldig worden verklaard.
- Configuratiewijzigingen worden tot 15 minuten gecached. Wis de applicatiecache om direct wijzigingen te zien.
De schakelaar 'Meest gezochte artikelen verbergen ', indien ingeschakeld, schakelt ook URL-gebaseerde artikellijstmapping uit. Als je URL-mapping gebruikt om categorielijsten te bevoorraden, houd die schakelaar dan uit.
Best practices
- Kaart eerst je meest bezochte supportpagina's in kaart — analytics laat zien waar gebruikers het vaakst naar hulp zoeken.
- Gebruik de actie Verbergen op pagina's met veel wrijving (inloggen, betalen, eerste installatie) waar de widget eerder afleidt dan helpt.
- Gebruik Is Regex voor patroongebaseerde mappings die meerdere vergelijkbare URL's moeten dekken.
FAQ
Wat is URL-mapping?
URL-mapping stelt je in staat te bepalen wat de kennisbank-widget toont — of of deze überhaupt verschijnt — op specifieke pagina's van uw website of applicatie. Je kunt artikelen, categorielijsten, een zoekbalk mappen of de widget voor elke URL verbergen.
Waarom lijkt een geconfigureerde URL-mapping kapot?
Dit gebeurt meestal wanneer het contenttoegangsfilter van de widget is gewijzigd. Als het filter de werkruimte of categorie die in de mapping is gebruikt niet meer bevat, wordt de mapping ongeldig. Controleer de instellingen voor contenttoegang en werk de mapping bij of maak het opnieuw aan.
Hoe kan ik direct wijzigingen in URL-mapping zien zonder 15 minuten te wachten?
De widgetconfiguratie wordt 15 minuten gecachet voor de prestaties. Om direct wijzigingen te zien, wis je de cache van de applicatie in je browser of de cachelaag van je webapplicatie.
Kan ik reguliere expressies (regex) toevoegen in URL-mapping?
Ja. Schakel de schakelaar Is Regex in bij het toevoegen of bewerken van een URL-mapping om reguliere expressiepatronen te gebruiken. Regex maakt het mogelijk dat één mapping meerdere vergelijkbare URL's omvat.
Kan ik URL-mapping toevoegen voor categorieën?
Ja. URL-mapping ondersteunt categorieën — het geldt alleen voor pagina- en indexcategorieën. Mappencategorieën zijn niet beschikbaar om te selecteren.
Hoe kan ik het Pagina-helptabblad en de zoekbalk uit de widget verwijderen wanneer de URL-mapping voor één artikel is geconfigureerd?
Navigeer naar Connections > Knowledge Base-widget > Bewerken. Plak het volgende in het tabblad Custom CSS :
li#page-help-tab { display: none; }
.article-header .article-back-icon { display: none; }
.search-container { display: none !Important; }
Plak vervolgens het volgende in het tabblad Aangepaste JavaScript en klik op Opslaan:
setTimeout(function() { $('.search-container').hide(); }, 2000);
setTimeout(function() { $("#knowledge-base-tab").click(); }, 2000);
Dit verbergt het Pagina-helptabblad en de zoekbalk in de widget wanneer URL-mapping voor één artikel is geconfigureerd.
Wat is regex?
Regex (reguliere expressie) is een reeks tekens die een zoekpatroon definieert dat wordt gebruikt om tekststrings te matchen en te manipuleren. Bij URL-mapping kun je door regex een enkele mapping te configureren om meerdere URL's met vergelijkbare patronen te dekken. In plaats van bijvoorbeeld individuele mappings toe te voegen voor https://example.com/drive-General, https://example.com/drive-settings, enzovoort, kun je docs/drive met de optie Pad opnemen ze allemaal in één mapping combineren.