Externe kennisbronnen koppelen

Twee routes naar het zoeken in je Help Center: de webcrawler, zonder ontwikkelaars, en de Federated Search API, waarvoor iemand middleware onderhoudt.

Er zijn precies twee manieren om de inhoud van een ander systeem in het zoeken van je Help Center te krijgen: de webcrawler, waarvoor je geen ontwikkelaars nodig hebt, en de Federated Search API, waarvoor iemand een middlewarelaag bouwt en onderhoudt. Welke je kunt gebruiken wordt meestal bepaald door de inhoud en niet door voorkeur.

De keuze tussen beide

Staat de inhoud op een openbare site, begin dan met de crawler. Staat die er niet, dan is de API de enige route, en dat is een project en geen instelling.

De koppeling die je misschien zoekt is een andere functie

Aanmelden bij een systeem als Confluence en daar spaces of mappen kiezen, is een aparte mogelijkheid die de gegenereerde antwoorden van een AI-agent voedt. Die inhoud komt daarmee niet in het zoeken van je Help Center voor eindgebruikers. Zoek in je zoekinstellingen niet naar een aanmeldstroom, want die is er niet.

Die oudere manier om bronnen te koppelen kreeg op 31 juli 2025 de status legacy en werkt niet meer na 10 december 2026. Put een AI-agent van jou uit inhoud die zo gekoppeld is, dan is de overstap naar de huidige kennisbronnen een klus met een datum en niet een die kan blijven liggen.

Wat de huidige koppelingen van je vragen

Een account kan maximaal 50 externe inhoudsbronnen bevatten. Voor de systemen die Zendesk ondersteunt zijn er kant-en-klare koppelingen, en voor de rest een universele koppeling voor elke bron met een bruikbare REST API. Die universele route vraagt een Knowledge admin om hem in te richten en ververst elke vierentwintig uur volledig, dus een correctie in het bronsysteem staat er niet dezelfde middag in.

Voor Confluence meld je je aan met een account dat de juiste rechten heeft op de inhoud die je wilt, en geef je de site op. Persoonlijke spaces kun je niet koppelen, en daar loopt iedereen tegenaan die de documentatie in zijn eigen space heeft geschreven en nooit heeft verplaatst.

Elk record draagt een bron en een type

Externe inhoud wordt gekoppeld aan een content source, dus waar het vandaan komt, en een content type, dus wat voor soort het is. Die twee zijn geen administratie: zoekresultaten groeperen externe inhoud onder de bron, en lezers kunnen hun zoekopdracht op type filteren. Je kunt daarnaast instellen welke externe bronnen worden meegenomen of uitgesloten.

Kies de namen voor bron en type dus alsof een klant ze leest, want een klant leest ze.

Bak het smal af

Dit is de stap die bepaalt of dit helpt of schaadt. Een crawler die op een hele site is gericht haalt concepten, oude campagnepagina's en de vacaturesectie binnen, en dat alles concurreert vervolgens met je artikelen.

Richt hem op het deel van de site met actuele, beoordeelde inhoud, en op niets anders.

De vraag die je eerst beantwoordt

Zou je een klant met een gerust hart naar die inhoud sturen zoals die er nu bij staat? Is het eerlijke antwoord nee, dan zet koppelen die inhoud toch voor hem neer. Een bron die het koppelen waard is, is er een die iemand onderhoudt.

Let op wat het verdringt

Elk extern resultaat concurreert met dat van uzelf om dezelfde aandacht. Verschijnen je artikelen ineens onder documentatie van elders, verklein dan de bron of verbeter het artikel.

Zie ook

• Gefedereerd zoeken: externe inhoud meenemen
• Een webcrawler instellen om externe inhoud te indexeren
• Wie ziet wat: gebruikerssegmenten uitgelegd