--- title: "URL-mapping" slug: "url-mapping" description: "With the Knowledge base assistant, you can display specific articles depending on the page the end-user is on with Document360's URL mapping feature. " tags: ["contextual help", "Premium", "Widget"] updated: 2026-08-17T08:56:22Z published: 2026-08-17T08:56:22Z canonical: "docs.document360.com/url-mapping" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.document360.com/llms.txt > Use this file to discover all available pages before exploring further. # URL-mapping 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. VOORZICHTIGHEID 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](https://docs.document360.com/help/docs/nl/installing-the-knowledge-base-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](https://docs.document360.com/docs/nl/content-access-for-the-knowledge-base-widget) 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 | OPMERKING 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. --- ## Voeg een URL-mapping toe ![Animated walkthrough showing how to add a URL mapping in the knowledge base widget](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/url%20mapping%20widget.gif) 1. Ga in de linker navigatiebalk naar **Connections** () > **Knowledge base-widget**. 2. Beweeg je muis over de gewenste widget en klik **op Bewerken** (). 3. Klik op het tabblad **URL-toewijzing** . 4. 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. OPMERKING Je 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. OPMERKING Mappencategorieën zijn niet beschikbaar om te selecteren. Er zijn alleen **pagina-** en **indexcategorieën** beschikbaar. 5. 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 1. Navigeer naar **Connections** () > **Knowledge base-widget**. 2. Beweeg je muis over de gewenste widget en klik **op Bewerken** (). 3. Vind in het tabblad **URL-mapping** de lijst met beschikbare mappings. 4. Beweeg je muis over de gewenste mapping en klik **op Bewerken** (). 5. Het **URL bijwerken paneel** verschijnt. 6. Werk de gewenste informatie bij en klik op **Updaten**. --- ## URL-toewijzingen verwijderen 1. Navigeer naar **Connections** () > **Knowledge Base-widget**. 2. Beweeg je muis over de gewenste widget en klik **op Bewerken** (). 3. Vind in het tabblad **URL-mapping** de lijst met beschikbare mappings. 4. Beweeg je muis over de gewenste mapping en klik **op Verwijderen** (). 5. 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. ![URL mapping settings panel showing the two default behavior options](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/url%20mapping%20settings%20new.png) 1. Ga naar **Connections** () > **Knowledge Base-widget**. 2. Beweeg je muis over de gewenste widget en klik **op Bewerken** (). 3. Klik op het tabblad **Geavanceerde instellingen** . 4. Vouw de **sectie voor URL-toewijzingsinstellingen** uit. 5. 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. 6. 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. ![Widget configuration interface showing URL mapping and contextual AI assistance options](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/contextual%20AI%20assistance%20new.png) OPMERKING 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. ![Configuration options for contextual AI assistance showing button-based prompting setup](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/button%20based%20prompting.png) 1. In de sectie **Contextuele AI-hulp Configureren** , laat je het vinkje **Pagina-niveau inschakelen** niet aangevinkt. 2. Voer je **zoekopdracht** in. 3. 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** '. 4. 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 `d360AIHelp` attribuut: ![Instructions for adding URL mapping and contextual AI assistance in a widget interface](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/trigger%20key%20info.png) ``` ``` 1. Als je een nieuwe knop aanmaakt, klik dan **op Code kopiëren** naast Installatiecode en plak het fragment in de HTML van je pagina. ![Instructions for configuring contextual AI assistance with a widget installation code](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/copy%20code%20info.png) 1. 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 ![Configuration options for a widget including page-level prompting settings](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/button%20based%20prompting.png) 1. Selecteer het vakje **'Pagina-niveau prompt' inschakelen** . 2. Voer je in het **zoekpromptveld** je zoekopdracht in. 3. **Druk Enter** om de prompt te valideren. - Groen **antwoord gevonden** = antwoord beschikbaar. - Rood **antwoord niet gevonden** = geen match. 4. 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. 5. 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$ ``` OPMERKING Wanneer je je URL regex test op [https://regex101.com,](https://regex101.com) voeg je een achterwaartse slash (`\`) toe vóór elke voorwaartse slash (`/`). --- ## Overwegingen - 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. OPMERKING 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; } ``` 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. ## Related - [Het installeren van de Knowledge Base-widget](/installing-the-knowledge-base-widget.md) - [Eddy AI Assistant voor widget](/knowledge-base-widget-getting-started.md) - [Widget bewerken, klonen en verwijderen](/edit-clone-and-delete.md)