Stapsgewijze handleiding Integraties

Een chatbot toevoegen aan WordPress met een blok, widget of shortcode

Een gedetailleerde handleiding na installatie voor het kiezen van de juiste plaatsing, het configureren van paginaspecifieke assistenten en het testen van de complete bezoekerservaring.

Beginner30 min leestijd16 juli 2026
Een chatbot toevoegen aan WordPress met een blok, widget of shortcode

Om betrouwbaar een chatbot aan WordPress toe te voegen, koppelt u één standaardassistent, kiest u de juiste plaatsing en test u de complete openbare bezoekerservaring.

Deze handleiding begint nadat de WebChatAgent WordPress-plugin actief is. Er wordt precies uitgelegd hoe u de standaardassistent koppelt, kiest tussen een sitebrede zwevende widget en een inline-chat, en de chat plaatst met het native Gutenberg-blok of een shortcode.

Het gecontroleerde voorbeeld gebruikt WordPress 7.0.2, WebChatAgent-plugin 1.1.4, een Engelse Light Mode-assistent en twee fictieve pagina's op Northstar Support Demo. Elke plaatsing wordt geladen op de echte WordPress-frontend; het uiteindelijke chatantwoord wordt opgehaald uit een geïndexeerde testbron.

Gebruik één standaard Chatbot ID wanneer dezelfde assistent de hele site bedient. Voeg alleen een ID per blok of per shortcode toe wanneer een pagina doelbewust een andere assistent nodig heeft, en documenteer die uitzondering zodat redacteuren niet per ongeluk twee verschillende bots tonen.

Privacyvriendelijke speler met tweestapsactivering

Een chatbot toevoegen aan WordPress (blok, widget en shortcode)

Voeg een chatbot toe aan WordPress met de WebChatAgent-plugin: koppel de assistent, kies een widget, Gutenberg-blok of shortcode en test direct.

YouTube · 4:10 · Engels

De YouTube-speler blijft geblokkeerd totdat u op Afspelen klikt. Door het laden maakt uw browser verbinding met YouTube en kunnen technische gegevens naar Google worden verzonden.

Rechtstreeks openen op YouTube

Wat u aan het einde heeft bereikt

  • Een standaardassistent gekoppeld aan WordPress
  • Een duidelijke beslissing tussen zwevende en inline plaatsing
  • Een gepubliceerde Gutenberg-pagina met inline-chat
  • Een herbruikbare shortcode voor paginabouwers en widgets
  • Een gedocumenteerde afwijking van de Chatbot ID per pagina
  • Geen onbedoelde dubbele chatplaatsing
  • Een geverifieerd, op bronnen gebaseerd bezoekersantwoord

Voordat u begint

  • De officiële WebChatAgent WordPress-plugin is geïnstalleerd en actief
  • Een WebChatAgent-assistent met één voltooide kennisbron
  • De exacte WordPress-hostnaam staat vermeld onder Allowed websites
  • WordPress-beheerders- of redacteurstoegang
  • Een staging- of testpagina voor de eerste publicatietest
  • Toestemming om optimalisatie- en CDN-caches te legen

Eén assistent, drie plaatsingsopties

In de algemene instellingen wordt de standaard Chatbot ID opgeslagen. De zwevende schakelaar voegt een sitebrede knop toe; het Gutenberg-blok en de shortcode renderen alleen een inline-chat waar redacteuren deze plaatsen.

De inline-methoden werken onafhankelijk van de zwevende schakelaar. Die flexibiliteit is handig, maar het betekent ook dat één pagina beide plaatsingen kan tonen, tenzij u een bewuste keuze maakt.

Koppel de standaardassistentKies en publiceer een plaatsingTest één echt bezoekersantwoord

01–08

Stap voor stap instellen

1

Koppel de standaardassistent en begrijp wat WordPress opslaat

De plugin slaat de Chatbot ID en de schakelaar voor de zwevende widget op; het assistentontwerp en de antwoorden blijven in WebChatAgent.

Open WordPress Admin → WebChatAgent → General. Plak de volledige UUID in Chatbot ID, schakel de widget alleen in als u een sitebrede zwevende knop wilt en selecteer Save Settings. De alleen-lezen titel en het voorbeeld moeten worden bijgewerkt naar de beoogde assistent.

Het blauwe informatiepaneel is belangrijk: weergave, positie, berichten, kennis en antwoordgedrag worden beheerd in het WebChatAgent-dashboard. WordPress moet geen tweede, conflicterende configuratiebron worden.

Een succesvolle opslag bewijst lokale opslag. Een geladen assistenttitel en voorbeeld tonen daarnaast aan dat de ID, het openbare configuratieverzoek en het Allowed websites-item met elkaar overeenkomen.

De plugin slaat de Chatbot ID en de schakelaar voor de zwevende widget op; het assistentontwerp en de antwoorden blijven in WebChatAgent.
2

Kies voor een zwevende widget, Gutenberg-blok of shortcode

Stem de plaatsing af op de taak van de bezoeker in plaats van elke optie in te schakelen.

Gebruik de zwevende widget voor sitebrede ondersteuning die beschikbaar moet blijven terwijl bezoekers tussen pagina's navigeren. Gebruik een inline-chat wanneer het gesprek thuishoort op een specifieke support-, tarieven-, onboarding- of kennispagina.

Open Inline Embed om de twee redactiemethoden te zien. Gutenberg-gebruikers kunnen het beste WebChatAgent Inline Chat gebruiken, omdat redacteuren dit visueel kunnen ontdekken en een optionele paginaspecifieke ID kunnen instellen. Gebruikers van de Classic Editor, Elementor, Divi en tekstwidgets kunnen `[webchatagent_inline]` in een element plakken dat shortcodes ondersteunt.

Beide inline-methoden hergebruiken standaard de Chatbot ID uit General. Dit houdt latere assistentwijzigingen gecentraliseerd en vermindert het onderhoud.

Stem de plaatsing af op de taak van de bezoeker in plaats van elke optie in te schakelen.
3

Bekijk een voorbeeld van de sitebrede zwevende widget op een echte pagina

Controleer de openbare pagina, niet alleen het voorbeeld in de plugin.

Open een normale frontend-pagina en controleer of de chatknop binnen de veilige zone rechtsonder blijft zonder cookieknoppen, afrekenacties of mobiele navigatie te overlappen. Open deze één keer en controleer de assistenttitel, welkomsttekst, kleuren en toetsenbordfocus.

De zwevende widget laadt overal waar het actieve thema `wp_footer()` aanroept. Als deze wel in het beheerdersvoorbeeld verschijnt maar niet op de site, controleer dan de themavoettekst en de optimalisatieplugin voordat u de Chatbot ID wijzigt.

Test de homepage, één gecachte subpagina en een privésessie in de browser. Een actieve beheerderssessie kan problemen met toestemming, caching en persistentie verbergen.

Controleer de openbare pagina, niet alleen het voorbeeld in de plugin.
4

Voeg het native WebChatAgent-blok toe in Gutenberg

Zoek naar “chat”, selecteer het merkblok en plaats het na nuttige context.

Maak of bewerk de doelpagina, open de Block Inserter en zoek naar “chat”. Selecteer WebChatAgent Inline Chat onder Embeds. Voeg vóór het blok een duidelijke kop toe en één zin die bezoekers vertelt wat ze kunnen vragen.

De editor toont een placeholder in plaats van de live externe widget te laden. Dat is een bewuste keuze: het voorkomt dat er bezoekerssessies worden gestart of chatverkeer wordt verbruikt terwijl een redacteur de inhoud aanpast.

Publiceer eerst op staging. Open de openbare URL en controleer de volledige chathoogte op desktop en mobiel; beoordeel de uiteindelijke lay-out niet uitsluitend op basis van de placeholder in de editor.

Zoek naar “chat”, selecteer het merkblok en plaats het na nuttige context.
5

Gebruik alleen een paginaspecifieke Chatbot ID wanneer dat nodig is

Een afwijkende ID kan ervoor zorgen dat de inline-chat verschilt van de zwevende assistent.

Laat Chatbot ID leeg in de zijbalk van het blok om de instellingen uit General over te nemen. Voer alleen een volledige UUID in wanneer deze pagina doelbewust een gespecialiseerde assistent nodig heeft—bijvoorbeeld hulp bij onboarding binnen het onboardingportaal, terwijl de zwevende bot voor algemene ondersteuning blijft dienen.

Noteer de pagina-URL, de assistentnaam en de beheerder van de afwijking in uw documentatie. Wanneer een assistent wordt verwijderd of vervangen, worden verborgen afwijkingen anders gemakkelijk over het hoofd gezien.

Als inline en zwevende chats verschillend antwoorden, vergelijk dan eerst hun openbare assistentnamen en ID's voordat u kennis- of modelinstellingen gaat debuggen.

Een afwijkende ID kan ervoor zorgen dat de inline-chat verschilt van de zwevende assistent.
6

Sluit de chatbot in met een shortcode in paginabouwers

Gebruik eerst de standaard shortcode; voeg alleen een ID-attribuut toe voor een gedocumenteerde uitzondering.

Voeg een Shortcode- of HTML-module toe en plak `[webchatagent_inline]`. Dit is de veiligste keuze voor Classic Editor, Elementor, Divi, herbruikbare widgets en templates die WordPress-shortcodes uitvoeren.

Gebruik `[webchatagent_inline chatbot-id="UUID"]` voor een doelbewuste gespecialiseerde assistent. De alias `chatbot_id="UUID"` bestaat voor builders die koppeltekens uit attribuutnamen verwijderen.

Plak het ruwe JavaScript-installatiefragment niet op dezelfde pagina als de plugin actief is. De plugin laadt het inline-bestand al alleen waar het blok of de shortcode wordt gerenderd.

Gebruik eerst de standaard shortcode; voeg alleen een ID-attribuut toe voor een gedocumenteerde uitzondering.
7

Voorkom dubbele chats en stem toestemmings- en cacheregels op elkaar af

De zwevende schakelaar staat los van elke inline plaatsing.

Als een inline-pagina slechts één chat mag bevatten, schakel dan de globale zwevende schakelaar voor de hele site uit of verwijder het inline-blok van die pagina. Omdat de plugin geen zwevende uitsluiting per pagina heeft, moeten gecombineerde strategieën vóór de uitrol worden gepland.

Laad optionele chat- of trackingopslag pas na de toestemmingsstatus die door uw beleid wordt vereist. De WebChatAgent-widget accepteert de toestemmingsstatus, maar uw WordPress-toestemmingsbeheerder bepaalt nog steeds wanneer optionele scripts mogen worden uitgevoerd. Documenteer de rechtsgrond, bewaartermijn en verwerkersinformatie voor uw implementatie.

Sluit `web-chat-agent.js` en `chat-widget-inline.js` uit van vertraging, scriptcombinatie en agressieve minificatie. Leeg WordPress-, paginabouwer-, reverse-proxy- en CDN-caches na het wijzigen van de plaatsing of ID.

De zwevende schakelaar staat los van elke inline plaatsing.
8

Controleer één onderbouwd antwoord op de openbare WordPress-pagina

Een zichtbare widget is slechts het begin van de acceptatietest.

Open de gepubliceerde pagina in een nieuwe bezoekerssessie. Controleer of er één inline widget is, de bedoelde zwevende status, Engelse bedieningselementen, een leesbare mobiele breedte en geen horizontale overloop. Stel vervolgens een vraag waarvan het exacte antwoord in een geïndexeerde bron staat.

Geverifieerde invoer: “What is the exact onboarding code for the WordPress embed lab?” Verwacht en waargenomen resultaat: `WP-EMBED-47`. De echte inline widget antwoordde: “The exact onboarding code for the WordPress embed lab is WP-EMBED-47.”

Herhaal dezelfde vraag na wijzigingen in de plugin, het thema, de cache, toestemmingen, de assistent of de kennisbank. Test ook één niet-ondersteunde vraag en verlang een eerlijk antwoord dat er geen informatie is, in plaats van een aannemelijke gok.

Een zichtbare widget is slechts het begin van de acceptatietest.

Voorbeeld en resultaat

Bekijk de praktijktest en het resultaat

Elke tutorial bevat een vaste invoer, het verwachte resultaat en een transparant overzicht van wat daadwerkelijk lokaal is geverifieerd.

Praktijkvoorbeeld: Hoe u een chatbot toevoegt aan WordPress met een widget, Gutenberg-blok of shortcode

Dit exacte scenario is doorlopen met het tijdelijke tutorial-account.

End-to-end geverifieerd

Exacte testinvoer

Open the published Northstar Support WordPress page and ask: “What is the exact onboarding code for the WordPress embed lab?”

Verwacht resultaat

De inline widget laadt in het Engels en retourneert de exacte waarde WP-EMBED-47 uit de geïndexeerde testbron.

Wat er daadwerkelijk is geverifieerd

De tijdelijke WordPress-pagina rendeerde het echte WebChatAgent inline-onderdeel en antwoordde: “The exact onboarding code for the WordPress embed lab is WP-EMBED-47.”

De tijdelijke WordPress-pagina rendeerde het echte WebChatAgent inline-onderdeel en antwoordde: “The exact onboarding code for the WordPress embed lab is WP-EMBED-47.”

Tips en trucs

Maak de inrichting betrouwbaar

Test met realistische voorbeelden, leg uw startpunt vast en wijzig één instelling tegelijk. Zo worden echte verbeteringen zichtbaar.

Behoud één standaardassistent

De meeste sites hebben één standaard-ID nodig. Gebruik afwijkende ID's alleen voor duidelijke gespecialiseerde bezoekerstrajecten en controleer ze bij elke assistentmigratie.

Ontwerp de inline-chat als pagina-inhoud

Introduceer wat bezoekers kunnen vragen, zorg voor voldoende hoogte en plaats alternatieve contactopties in de buurt. Een leeg chatvenster zonder context wekt minder vertrouwen.

Test de openbare URL opnieuw na elke cachewijziging

Optimalisatieplugins kunnen de twee widgetbestanden vertragen of combineren. Controleer dit in een nieuwe privésessie na elke wijziging in de prestatieregels.

Wanneer iets niet werkt

Problemen oplossen

Controleer status, machtigingen en testgegevens systematisch voordat u het model of de prompt aanpast.

Instellingen worden opgeslagen, maar de assistenttitel laadt niet

Vergelijk de volledige UUID en de exacte hostnaam onder Allowed websites. Productie-, `www`- en staging-hosts zijn afzonderlijke vermeldingen. Sla WebChatAgent eerst op, herlaad WordPress en controleer de getoonde titel voordat u verdergaat.

Het Gutenberg-blok is zichtbaar in de editor maar leeg op de pagina

Controleer of er een standaard of blokspecifieke Chatbot ID is, leeg alle caches en sluit het inline-widgetbestand uit van scriptvertraging. Controleer vervolgens de openbare pagina op `web-chat-agent-inline` en browserfouten.

Er verschijnen twee chatinterfaces op één pagina

De zwevende schakelaar en de inline plaatsing zijn beide actief. Bepaal of deze pagina globale toegang, ingesloten context of beide nodig heeft; schakel vervolgens één plaatsing uit en leeg de caches.

De shortcode wordt als tekst weergegeven

Gebruik een WordPress Shortcode-blok of een element uit de paginabouwer dat shortcodes uitvoert. Gewone code-, paragraaf- en ge-escapete HTML-modules tonen de tekens zonder de handler uit te voeren.

De taal van de widget is onjuist

Stel de brondetectie voor de chattaal in op HTML lang en zorg ervoor dat de WordPress-pagina de beoogde taal declareert. Wis gecachte widgetbestanden en test opnieuw in een nieuwe sessie.

Klaar voor een test op productieniveau

Publiceer de gekozen plaatsing op staging, voer de tests voor bekende antwoorden en eerlijke onbekende situaties uit op desktop en mobiel, documenteer elke paginaspecifieke ID-afwijking en herhaal de uitrol pas daarna op productie.

Gerelateerde bronnen