Hoe een AI-chatbot trainen op een WordPress-kennisbank: praktijkcase

Verander je WordPress-website in een AI-assistent die antwoordt

We hadden een probleem. Ons WordPress-thema Listeo heeft 130 documentatie-artikelen, en toch bleven klanten supporttickets openen met vragen die al in de documentatie beantwoord werden. Klinkt bekend?

Of je nu een SaaS-bedrijf runt met een WordPress kennisbank, een WooCommerce-winkel met product-FAQ’s, een ledensite met een helpcentrum of digitale producten verkoopt met installatiehandleidingen, je hebt waarschijnlijk hetzelfde meegemaakt. Je documentatie bevat de antwoorden. Gebruikers kunnen (of willen) ze alleen niet vinden.

Dus we hebben een AI-chatbot getraind op onze WordPress-kennisbank om klantenondersteuning automatisch af te handelen. Na 30 dagen: 482 gesprekken, 4.670 berichten, en een aanzienlijke daling in repetitieve supporttickets.

Deze casestudy laat zien hoe we een RAG-aangedreven AI-assistent voor WordPress-documentatie hebben opgezet, welke vragen deze afhandelde en hoe jij hetzelfde kunt doen voor elke op WordPress gebaseerde knowledge base.

We gebruikten AI Chat & Search Pro – onze eigen chatbot, van de grond af ontwikkeld met WordPress-gebruikers in gedachten. Hij werkt op elke WordPress-website.

Waarom we een AI-assistent nodig hadden voor onze WordPress-documentatie

Listeo is een directory- en marketplace-WordPress-thema met een hoop features: boekingssystemen, betalingsgateways, aangepaste velden, Elementor-integratie, Dokan-ondersteuning. We hebben alles gedocumenteerd in 130 kennisbankartikelen.

Maar klanten doorzoeken de documentatie niet. Ze willen direct antwoord. Daar komt een AI-gestuurde knowledge base-chatbot om de hoek kijken.

Maar hier is het punt: klanten lezen geen documentatie. Of, nauwkeuriger gezegd, ze willen niet door documentatie heen zoeken. Ze willen nú antwoord.

Dit is niet uniek voor WordPress-thema’s. Als je het volgende uitvoert:

• Een SaaS-product met WordPress-gebaseerde documentatie
• Een WooCommerce-winkel met product-FAQ’s en verzendvoorwaarden
• Een online cursus of ledensite met how-to gidsen
• Een softwarebedrijf dat WordPress gebruikt voor je helpcentrum
• Elk dienstverlenend bedrijf met een WordPress FAQ-sectie

…je hebt waarschijnlijk met hetzelfde probleem te maken. De documentatie bestaat. Niemand leest haar. 😅

Wil je het zelf testen? Probeer het hier in onze documentatie →

Voor de chatbot zag onze typische supportflow er als volgt uit:

1. Klant heeft een vraag
2. Klant probeert misschien de zoekbalk (misschien)
3. Klant vindt niet meteen het antwoord
4. Klant opent een supportticket
5. We antwoorden met een link naar het documentatieartikel dat hun vraag beantwoordt
6. Herhaal 50 keer per week

We fungeerden in feite als menselijke zoekmachines. Dat is geen goede besteding van iemands tijd.

Het 10-minuten installatieproces

Dit is het deel dat ons het meest heeft verrast: het opzetten van de chatbot kostte ongeveer 10 minuten. Geen uren. Geen dagen. Tien minuten. Hier is een kort overzicht, maar als je de volledige handleiding nodig hebt, bekijk dan de stap-voor-stap tutorial hier:

We gebruikten onze eigen AI Chat & Search Pro plugin (ja, we gebruiken onze eigen tools), maar het proces is vergelijkbaar voor elke RAG-gebaseerde WordPress-chatbot:

Stap 1: Installeer de plugin en voeg een API-sleutel toe

Download AI Chat & Search →

We kozen voor het Gemini 3 Flash-model – het is snel en biedt uitstekende contextbegrip tegen lage kosten. Je kunt ook GPT gebruiken als je dat liever hebt. Het instellen van de API-sleutel duurt ongeveer 1 minuut.

Stap 2: Selecteer inhoud om op te trainen

AI Chat & Search ondersteunt custom post types, dus als je website/kennisbank CPT gebruikt – geen probleem.

AI Chat & Search handles custom post types, so if your website/knowledge base use CPT – no problems.

Stap 3: Klik op “Start Training”

De plugin verwerkte alle 130 artikelen in minder dan 5 minuten. Hij maakte embeddings voor elk deel van de content en sloeg alles op in de lokale MySQL-database.

Stap 4: Configureer de systeem-prompt

Dit is waar je de AI vertelt hoe hij zich moet gedragen. We hebben context over Listeo, gangbare terminologie en instructies toegevoegd, zoals:

You are a helpful support assistant for Listeo WordPress theme.
Focus on answering questions about theme features, settings, and troubleshooting.
If you can't find the answer in the documentation, suggest the user contact support.

Dat is alles. De chatbot stond live en beantwoordde vragen op basis van daadwerkelijke documentatie-inhoud.

Bovendien hebben we deze eenvoudige regel toegevoegd voor het LLM om de semantische overeenkomst te verbeteren wanneer een gebruiker in een andere taal dan Engels vraagt:

CRITICAL RULE when searching:
- If user question is NOT in English → translate query to English before searching
- If user question IS in English → use as-is (add keywords if needed)

De AI vertaalt de query naar de taal van onze KB, doorzoekt de vector-database en reageert daarna in de oorspronkelijke taal van de gebruiker. Betere semantische overeenkomst, geen noodzaak om vertaalde documenten te onderhouden.

Real Results: 30 Days of Data

Na één week hadden we solide gegevens om te analyseren. Dit zijn de ruwe cijfers:

Metric	Value
Total conversations	482
Total messages exchanged	4670
Average messages per conversation	9.7
Simple questions resolved by AI	~80%
Complex questions resolved by AI	~30%
Documentation articles trained	130
Setup time	10 minutes
API cost for the week	~$5

Het oplossingspercentage van 80% voor eenvoudige vragen was de grote winst. Dit waren vragen waarvan het antwoord al in onze documentatie stond, maar die gebruikers niet konden vinden (of niet wilden zoeken). De AI vond het binnen enkele seconden voor hen.

Het oplossingspercentage van 30% voor complexe vragen is wat we verwachtten. Sommige vragen vereisen menselijke beoordeling, inloggen op de website van de klant, aangepaste codefragmenten of onderzoek naar specifieke siteconfiguraties. De AI identificeerde deze gevallen correct en stelde voor om contact op te nemen met support.

Wat gebruikers echt vroegen

We hebben alle 250+ vragen gecategoriseerd om te begrijpen waar gebruikers mee worstelen:

• Betalingen & Monetisatie (Meest Voorkomend): PayPal-configuratie, verwerkingstijden voor uitbetalingen, commissiekosten, pakketten voor betaalde vermeldingen, valuta-instellingen. Gebruikers willen weten hoe zij worden uitbetaald en hoe het platform geld verdient. De AI ging hier goed mee om omdat we gedetailleerde documentatie hebben voor elk scenario.
• Instellingen & Configuratie: “Hoe schakel ik X in?”-vragen waarbij er een toggle is die ze niet konden vinden. Klassiek voorbeeld: gebruiker vraagt hoe zijbalkfilters in te schakelen zijn, het antwoord is één selectievakje in de instellingen. De AI werd een conversationele zoekmachine die naar exacte menupaden verwijst.
• Integratievragen: “Waarom werkt plugin A niet met plugin B?” Uitleggen hoe twee producten samenwerken. Onze vragen over Dokan + Listeo vereisten vaak specifieke configuratiestappen die de AI uit de documentatie kon halen.
• Zoeken & Kaarten: Hoe gebruikers content vinden op directory-sites. Vragen over standaardinstellingen voor straalzoeken (50 km), problemen met het centreren van de kaart, filtergedrag. Bleek dat het uitleggen van standaardinstellingen een veelvoorkomend AI-antwoord was.
• Randgevallen: Zeer specifieke vragen zoals “Hoe vertaal ik aangepaste veld-checkboxwaarden naar het Spaans met Loco Translate?” Diep weggestopt in de documentatie, maar de AI vond het direct.

Het patroon in alle categorieën: gebruikers stellen vragen op hun eigen manier, zonder exact dezelfde terminologie te gebruiken als in je documentatie. Iemand vraagt “waarom toont mijn kaart New York” in plaats van te zoeken naar “standaardlocatie kaartcentrum.” Traditioneel zoeken schiet hier tekort. AI begrijpt de intentie.

Gegevensanalyse

Onze AI-assistent biedt zoekanalyses. Elke zoekopdracht die door de AI wordt uitgevoerd, wordt opgeslagen. Deze gegevens kunnen via CSV worden geëxporteerd en dieper worden geanalyseerd om zwakke punten te vinden in je kennisbank.

De “Aha-moment” patronen

Uit analyse van deze gesprekken bleek iets belangrijks: de meeste vragen vielen in voorspelbare patronen. En deze patronen zijn van toepassing op vrijwel elke WordPress-kennisbank, niet alleen die van ons.

Patroon 1: De “Ontbrekende Instelling”-vraag

Gebruiker vraagt: “Hoe doe ik X?” Realiteit: Er is een schakelaar in de Listeo Core-instellingen die ze niet konden vinden. AI-antwoord: “Ga naar Dashboard → Listeo Core → [specifiek tabblad] → schakel [optie] in”

Dit waren de makkelijkste successen. De AI werd in wezen een meer conversational zoekmachine voor instellingen.

Voor andere bedrijven: Dit is vergelijkbaar met “Waar wijzig ik mijn abonnementsplan?” (SaaS), “Hoe volg ik mijn bestelling?” (e-commerce), of “Hoe krijg ik toegang tot mijn cursusmateriaal?” (lidmaatschapssites). Gebruikers kunnen niet vinden wat recht voor hun neus staat.

Patroon 2: De “integratiefrictie”-vraag

Gebruiker vraagt: “Waarom werkt [Plugin A] niet met [Plugin B]?” Werkelijkheid: De twee producten hebben verschillende verwachtingen of conflicterende instellingen. AI-antwoord: Legt de specifieke configuratie uit die nodig is om beide plugins samen te laten werken.

Vragen over Dokan + Listeo vielen vaak in deze categorie.

Voor andere bedrijven: “Werkt dit met Zapier?” “Hoe koppel ik dit aan mijn e‑mailmarketingtool?” “Is er een WooCommerce-integratie?” Elk product met koppelingen van derden krijgt dit soort vragen.

Patroon 3: De “Zeer Specifieke Randgeval”-vraag

Gebruiker vraagt: “Hoe vertaal ik de checkboxwaarde ‘Yes’ naar het Spaans voor custom fields?” Realiteit: Dit staat diep weggestopt in de documentatie over Loco Translate. AI-antwoord: Vindt ofwel het specifieke artikel of geeft toe dat het menselijke hulp nodig heeft.

Deze longtailvragen zijn precies waar AI-chatbots in uitblinken. Geen mens wil keer op keer dezelfde ultraspecifieke vraag beantwoorden.

Voor andere bedrijven: “Wat is het retourbeleid voor artikelen die tijdens een uitverkoop zijn gekocht?” “Kan ik mijn abonnement pauzeren in plaats van opzeggen?” “Verzenden jullie naar postbussen in Alaska?” De vreemde, specifieke vragen die technisch gezien wel in je documentatie worden beantwoord, maar die niemand kan vinden.

---

Hoe het RAG-systeem eigenlijk werkt

Voor wie nieuwsgierig is naar de technische kant: dit is wat er gebeurt wanneer een gebruiker een vraag stelt:

1. Gebruiker typt een vraag zoals “Hoe stel ik PayPal in?”
2. De AI maakt een embedding van die vraag (zet deze om in een vector van getallen die de betekenis weergeven)
3. Semantisch zoeken werkt op alle 130 documentatie-artikelen en vindt de meest relevante inhoud op basis van betekenis, niet alleen trefwoorden
4. De AI ontvangt context van de best overeenkomende artikelen
5. Het LLM genereert een antwoord op basis van die context en reageert in natuurlijke taal

Dit wordt Retrieval-Augmented Generation (RAG) genoemd. Het belangrijkste verschil met eenvoudige chatbots is dat de AI je content daadwerkelijk leest voordat hij antwoord geeft, in plaats van reacties te hallucineren.

We hebben een uitgebreid artikel gemaakt waarin we uitleggen hoe RAG-chatbots stap voor stap werken →

---

AI-chatbot vs. traditionele kennisbankzoekfunctie: vergelijking

Functie	Traditional KB Search	AI Chatbot on Website
Zoekopdrachten in natuurlijke taal	❌ Keywords only	✅ Full sentences
Understanding intent	❌ Exact match	✅ Semantic understanding
Multi-step questions	❌ One search at a time	✅ Conversation context
Finding buried answers	❌ Depends on user patience	✅ Searches entire KB
Handling “I don’t know what to call it”	❌ User must know terms	✅ Understands descriptions
Response personalization	❌ Static articles	✅ Tailored answers
24/7 availability	✅ Always accessible	✅ Always accessible

De kern: AI-chatbots zijn beter in het vinden van antwoorden op vragen die gebruikers niet goed kunnen verwoorden. Traditionele zoekfunctionaliteit is goedkoper, maar vereist dat gebruikers precies weten waar ze naar op zoek zijn.

---

Kostenoverzicht: Wat dit je werkelijk kost

Let’s talk money. Here’s the real cost for our 7-day period. Plugin cost: $59 one-time (we used AI Chat & Search Pro). API costs for 560 messages: ~$1 (cost varies but each message sent to LLM contains ~3000 words from docs articles to provide AI context).

Dat is ongeveer $0,002 per bericht. Voor een maand met vergelijkbaar verkeer zou je ongeveer $8-10 aan API-kosten uitgeven.

Vergelijk dat eens met abonnementsgebaseerde chatbotplatforms:

• Tidio: $29-99/month
• Intercom: $74+/month
• Zendesk: $55+/month

Over een jaar bespaart het eenmalige betalingsmodel voor de meeste kleine tot middelgrote sites $500-1000+.

---

Pro-tips voor betere resultaten

Na dit een week te hebben gedraaid, is dit wat we hebben geleerd:

• Tip 1: Houd je documentatie up-to-date De AI is maar zo goed als de content waarop hij is getraind. Verouderde documentatie = verouderde antwoorden.
• Tip 2: Gebruik de systeemprompt als spiekbrief Veelgestelde vragen kun je rechtstreeks in de systeemprompt opnemen. De AI kan dan antwoorden zonder zelfs maar in de database te zoeken.
• Tip 3: Maak een aparte FAQ-pagina Schrijf één uitgebreide FAQ-pagina waarin je de meest voorkomende vragen behandelt. De AI zal deze snel vinden.
• Tip 4: Bekijk wekelijks de chattranscripten Kijk naar welke vragen de AI moeite heeft. Verbeter je documentatie of voeg die antwoorden toe aan de systeemprompt.
• Tip 5: Stel verwachtingen Maak duidelijk aan gebruikers dat ze met een AI praten. Transparantie bouwt vertrouwen op.

---

Veelgestelde vragen

---

Wie zou een chatbot moeten trainen op zijn WordPress-kennisbank?

Onze casestudy richtte zich op een WordPress-thema, maar deze aanpak werkt voor elke WordPress-site met documentatie- of FAQ-inhoud. Dit zijn de belangrijkste doelgroepen:

WooCommerce-winkeleigenaren

Je hebt al productbeschrijvingen, veelgestelde vragen, verzendvoorwaarden en retourinformatie op je site. Train een chatbot met deze content en klanten krijgen direct antwoord op vragen als “Verzenden jullie naar Canada?” of “Welke maat moet ik bestellen?” zonder te hoeven wachten op een reactie van een medewerker. P.S. We hebben een chatbot-vergelijkingsartikel voor WooCommerce-eigenaren gemaakt

SaaS-bedrijven die WordPress gebruiken voor documentatie

Veel softwarebedrijven hosten hun documentatie op WordPress (vaak met plugins zoals BetterDocs of Heroic Knowledge Base). In plaats van dat gebruikers door zoekresultaten moeten spitten, stellen ze hun vragen op een natuurlijke manier: “Hoe maak ik verbinding met Zapier?” of “Wat is de API-rate limit?”

Online cursusmakers en lidmaatschapsites

Studenten stellen voortdurend dezelfde vragen: “Hoe krijg ik toegang tot Module 3?” “Waar staan de bonusmaterialen?” “Kan ik video’s downloaden om offline te bekijken?” Als deze antwoorden in je WordPress-inhoud staan, kan een chatbot ze afhandelen.

Dienstverlenende bedrijven met FAQ-pagina’s

Advocatenkantoren, bureaus, consultants, iedereen met een WordPress-site en veelgestelde vragen. In plaats van een statische FAQ-pagina krijgen bezoekers een conversational assistant die het juiste antwoord vindt.

Plugin- en themamakers (zoals wij)

Als je WordPress-producten met documentatie verkoopt, ken je de ondersteuningslast al. Een getrainde chatbot wordt je eerste verdedigingslinie tegen terugkerende vragen.

De rode draad: je hebt waardevolle content in WordPress die gebruikers moeilijk kunnen vinden. De chatbot maakt die content toegankelijk.

---

De Conclusie

Een AI-chatbot trainen op je WordPress-kennisbank is niet ingewikkeld. Onze setup duurde 10 minuten, kostte minder dan $60 voor de eerste maand (inclusief de plugin) en loste 80% van de eenvoudige documentatievragen op zonder menselijke tussenkomst.

De kerninzichten: gebruikers willen niet door documentatie zoeken. Ze willen antwoorden. Een AI-chatbot die is getraind op jouw content geeft ze precies dat, in hun eigen woorden, 24/7 beschikbaar.

Of je nu een WooCommerce-winkel beheert, een SaaS-documentatiesite, een ledenplatform, of – zoals wij – WordPress-producten verkoopt, de rekensom blijft hetzelfde. Je documentatie wordt eindelijk gebruikt. Je supportwachtrij wordt korter. Je gebruikers krijgen sneller antwoord.

Als je WordPress-content hebt die klantvragen beantwoordt, heb je alles wat je nodig hebt om dit in te stellen.

---

Klaar om het zelf te proberen? Bekijk onze AI Chat & Search Pro plugin of lees de volledige stap-voor-stap installatiegids.