Ga naar de hoofdinhoud

WordPress-chatbotplug-in

Gebruik de officiële ChattyBox WordPress-plug-in als je een installatie zonder code wilt die de gehoste widget laadt zonder themabestanden te bewerken. Deze handleiding behandelt de operationele configuratie. De WordPress AI-chatbotpagina legt de strategie voor content en crawlen uit, terwijl de landingspagina van de WordPress-plug-in het product in vogelvlucht beschrijft.

Kan ik ChattyBox op WordPress zonder branding gebruiken?​

Ja. De officiële plug-in laadt de gehoste ChattyBox-widget op je WordPress-site. Free behoudt de voettekst ‘Powered by ChattyBox’. Met Starter, Pro en Business kun je die verwijderen door ChattyBox-branding tonen uit te schakelen onder Aanpassen → ChattyBox-vermelding. Zie widgetaanpassing voor de instelling en prijzen voor de abonnementen.

Voordat je installeert​

Doorloop eerst Aan de slag: koppel je openbare WordPress-URL, bekijk geïndexeerde pagina's en controleer representatieve antwoorden in Chatbot testen. Bekijk of maak onder Installeren → Sleutels en domeinen een openbare widget-sleutel aan en controleer de origininstellingen. Selecteer onder Installeren → Installatie op website een geschikte sleutel en kopieer het gegenereerde installatiesnippet.

De plug-in installeren​

De plug-in heeft geen afhankelijkheid van Composer, npm of een buildstap. De plug-in wordt momenteel verspreid vanuit de openbare ChattyBox GitHub-repository, niet via de WordPress.org Plugin Directory. Gebruik daarom de WordPress-flow Upload Plugin in plaats van te zoeken in de directory. Automatische updates vanuit de directory zijn nog niet beschikbaar.

Het vastgezette pakket 0.2.0 declareert WordPress 5.8+ en PHP 7.4+ en testmetadata tot WordPress 6.8. Test je werkelijke WordPress-/PHP-versie en thema; deze metadata zijn geen garantie voor iedere nieuwere release.

  1. Download de vastgezette ZIP van versie 0.2.0 van de ChattyBox WordPress-plug-in of bekijk de openbare bronrepository.
  2. Open in WordPress Plugins > Add New > Upload Plugin, upload de ZIP en activeer ChattyBox AI Chatbot. Kopieer bij een handmatige serverinstallatie eerst de map van de plug-in naar wp-content/plugins/.
  3. Open Settings > ChattyBox.
  4. Plak de openbare widget-API-sleutel uit het installatiesnippet.
  5. Schakel de chatbot in en sla de instellingen op.

De plug-in slaat de openbare widget-sleutel en weergave-instellingen op in de WordPress-opties. Plak nooit een ChattyBox-beheerdersreferentie in de plug-in.

Laden configureren​

De standaardinstellingen voor productie zijn:

  • Widgetscript: https://chattybox.ai/widget.js
  • API-eindpunt: automatisch geconfigureerd door de plug-in
  • Ingeschakeld: uit totdat je de chatbot inschakelt met een niet-lege openbare sleutel
  • Locale-override: leeg; de widget volgt het projectbeleid (standaard Automatisch detecteren)

In de huidige broncode van de gehoste widget probeert de modus Automatisch detecteren eerst een ondersteunde paginataal uit <html lang>, daarna ondersteunde browsertalen, de geconfigureerde standaardlocale en Engels. Vast gebruikt de standaardlocale van het project. De optionele plug-inoverride wordt data-locale en wint alleen wanneer script-overschrijving is toegestaan. Gebruik een ondersteunde locale-code in kleine letters; aangepaste kop- en welkomsttekst wordt niet automatisch vertaald. Controleer de versie van de afzonderlijk uitgerolde loader als je op dit gedrag vertrouwt.

Het API-eindpunt is in deze pluginversie ingebouwd en wordt niet uit de sleutel afgeleid. Als je Widget script URL wijzigt, verandert dat eindpunt niet. Gebruik de handmatige scriptintegratie als het installatiesnippet voor de website naar een andere API-deployment verwijst. URL's van externe loaders moeten HTTPS gebruiken; HTTP is alleen toegestaan voor lokale ontwikkelhosts (localhost, 127.0.0.1 en ::1).

De plug-in registreert de widget bij WordPress-frontendverzoeken voor het in de wachtrij plaatsen van scripts en slaat feeds, REST-verzoeken en AJAX-verzoeken expliciet over. Deze controles inspecteren niet elk responstype en stellen niet vast of elke frontendpagina openbaar is. Dit is geen privacycontrole voor elke frontendpagina: sluit checkout-, account-, wachtwoord- en ledenpagina’s expliciet uit. Controleer ook of je thema de WordPress-footerscripts uitvoert. De plug-in crawlt of synchroniseert geen WordPress-berichten; het indexeren en vernieuwen van content gebeurt in ChattyBox.

Sleutels die zonder beperkingen zijn aangemaakt, werken vanaf verschillende browserorigins; een sleutel die voor een website is voorbereid, kan al beperkt zijn tot de origin van die site. Optionele beperkingen onder Installeren → Sleutels en domeinen vereisen elke beoogde combinatie van schema, hostnaam en poort. Bij beperkte sleutels geeft een ontbrekende of niet-toegestane effectieve aanvraagorigin 401 Invalid API key; als de Origin-header ontbreekt, kan de server de origin afleiden uit een geldige Referer. Originbeperkingen zijn extra beveiliging, geen bezoekersauthenticatie. Test de productiepagina, niet alleen het dashboard.

Extra routes uitsluiten​

Gebruik het filter chattybox_load_widget vanuit een site-specifieke plug-in of een child theme als een openbare route de widget niet mag tonen:

Het filter wordt toegepast wanneer de plug-in op een geschikt frontendverzoek de widget wil laden; het verwijdert geen widget die al is geïnitialiseerd tijdens client-side navigatie.

add_filter(
    'chattybox_load_widget',
    static function ( $should_load ) {
        return $should_load && ! is_page( array( 'checkout', 'account' ) );
    }
);

Laat eerst het standaardgedrag van de plug-in ingeschakeld en voeg daarna alleen de route-uitsluitingen toe die je site nodig heeft. Test na het wijzigen van het filter zowel een uitgesloten route als een normale openbare pagina.

Handmatige scriptfallback​

Gebruik de plug-in als standaardoptie. Als je WordPress-team scripts al beheert via een thema, child theme, scriptplug-in of Google Tag Manager, kun je de gehoste widget in plaats daarvan handmatig laden:

<script
  src="https://chattybox.ai/widget.js"
  data-api-key="YOUR_API_KEY"
  data-api-url="YOUR_WIDGET_API_URL"
  async
></script>

Schakel de plug-in niet in en voeg niet tegelijkertijd hetzelfde widgetfragment toe. Kies één loader, zodat bezoekers geen dubbele launchers ontvangen.

De installatie controleren​

Nadat je de plug-in hebt geconfigureerd:

  • Open een openbare WordPress-pagina in een incognitovenster.
  • Controleer of de launcher één keer verschijnt.
  • Stel een echte bezoekersvraag.
  • Controleer dat een ondersteund antwoord geïndexeerde WordPress-pagina’s citeert en dat een niet-ondersteunde vraag de fallback toont, die geen bronnen kan hebben. De geciteerde pagina’s moeten openbaar zijn.
  • Controleer de browserconsole op ontbrekende data-api-key, data-api-url of sleutelfouten.
  • Test een checkout-, account- of privéroute bij een uitsluiting. Wis na wijzigingen relevante WordPress-/CDN-caches en test een nieuwe pagina-aanvraag. Uitsluitingen aan de serverzijde verwijderen geen widget die al is geïnitialiseerd tijdens client-side navigatie. Controleer op gevoelige routes en bij het intrekken van toestemming welke loaderversie is uitgerold, en verwijder de widget actief via een integratie die door die loader wordt ondersteund; alleen het script verwijderen of de widget met CSS verbergen is geen volledige teardown. Daarmee kun je verzoeken die de server al heeft verwerkt niet ongedaan maken.
  • De automatische plug-inloader controleert niet of de bezoeker toestemming heeft gegeven voordat de widget in de wachtrij wordt geplaatst. Als toestemming vereist is, gebruik dan een integratie die laden voorkomt totdat toestemming is gegeven en controleer hoe het intrekken van toestemming werkt met de uitgerolde loader.

Doorloop vóór de aankondiging van de chatbot de lanceringschecklist. Gebruik Gesprekken → Geschiedenis, beschikbaar in elk abonnement, om gesprekken te bekijken. Gebruik met Pro of Business Gesprekken → Analyses en Gesprekken → Onbeantwoorde vragen om verbeterpunten te bekijken nadat er echte vragen zijn binnengekomen.