WordPress-chattbotplugin
Använd ChattyBox officiella WordPress-plugin när du vill ha en kodfri installation som laddar den hostade widgeten utan att redigera temafiler. Den här guiden beskriver den operativa konfigurationen. Sidan WordPress AI-chattbot förklarar strategin för innehåll och crawling, medan landningssidan för WordPress-pluginet ger en snabb överblick över produkten.
Innan installation
Slutför först flödet Kom igång: anslut din offentliga WordPress-URL, granska indexerade sidor och verifiera representativa svar i Test Chat. Skapa sedan en webbläsarsäker offentlig nyckel under Public Keys och kopiera den från projektets flik Embed.
Installera pluginet
Pluginet har inga beroenden av Composer, npm eller något byggsteg. Det distribueras för närvarande från det offentliga ChattyBox GitHub-repositoriet, inte via WordPress.org Plugin Directory, så använd WordPress-flödet Upload Plugin i stället för att söka i katalogen. Kataloghanterade automatiska uppdateringar är ännu inte tillgängliga.
- Ladda ner den versionslåsta ZIP-filen för ChattyBox WordPress-pluginet 0.2.0, eller granska det offentliga källrepositoriet.
- Öppna Plugins > Add New > Upload Plugin i WordPress, ladda upp ZIP-filen och aktivera ChattyBox AI Chatbot. Vid manuell serverinstallation kopierar du först pluginets katalog till
wp-content/plugins/. - Öppna Settings > ChattyBox.
- Klistra in widgetens offentliga API-nyckel från projektets flik Embed.
- Aktivera chattboten och spara inställningarna.
Pluginet lagrar widgetens offentliga nyckel och visningsinställningar i WordPress-alternativen. Klistra aldrig in en ChattyBox-autentiseringsuppgift för administration i pluginet.
Konfigurera laddning
Produktionsstandardvärdena är:
- Widgetskript:
https://chattybox.ai/widget.js - API-slutpunkt: konfigureras automatiskt av pluginet
- Språk: följer projektets språkpolicy; Auto-läge använder sidans
<html lang>före webbläsarens språk och Fixed-läge använder projektets standardspråk
Pluginet laddar widgeten vid offentliga frontendförfrågningar. Det hoppar avsiktligt över wp-admin, feeds, REST-förfrågningar och AJAX-förfrågningar, så att administrativa svar och svar som inte gäller sidor inte får skriptet. Dessa request-guards kontrollerar inte varje frontendsidas integritets- eller medlemsstatus; uteslut checkout-, konto-, lösenordsskyddade och medlemsrutter uttryckligen vid behov.
Undanta ytterligare rutter
Använd filtret chattybox_load_widget från ett platsspecifikt plugin eller ett barntema när en offentlig rutt inte ska visa widgeten:
add_filter(
'chattybox_load_widget',
static function ( $should_load ) {
return $should_load && ! is_page( array( 'checkout', 'account' ) );
}
);
Behåll först pluginets standardbeteende aktiverat och lägg sedan bara till de ruttundantag som webbplatsen behöver. Testa både en undantagen rutt och en vanlig offentlig sida efter att du ändrat filtret.
Manuell skriptfallback
Använd pluginet som standardväg. Om ditt WordPress-team redan hanterar skript via ett tema, barntema, skriptplugin eller Google Tag Manager kan du i stället ladda den hostade widgeten manuellt:
<script
src="https://chattybox.ai/widget.js"
data-api-key="YOUR_API_KEY"
data-api-url="YOUR_WIDGET_API_URL"
async
></script>
Aktivera inte pluginet och lägg inte till samma widgetkod samtidigt. Välj en enda loader så att besökarna inte får dubbla startknappar.
Verifiera installationen
Efter att du har konfigurerat pluginet:
- Öppna en offentlig WordPress-sida i ett inkognitofönster.
- Bekräfta att startknappen visas en gång.
- Ställ en riktig besökarfråga.
- Kontrollera att ett svar som stöds innehåller relevanta källhänvisningar till indexerade offentliga WordPress-sidor och att en fråga som inte stöds får reservsvaret, som kan sakna källor.
- Kontrollera webbläsarkonsolen efter saknade
data-api-key,data-api-urleller nyckelfel. - Testa en checkout-, account- eller privat rutt om du har konfigurerat ett undantag.
Fortsätt med checklistan inför lansering innan du tillkännager chattboten. Använd Analytics och Content Gaps för att förbättra WordPress-innehållet när riktiga frågor börjar komma in.
Det låsta 0.2.0-paketet deklarerar WordPress 5.8+ och PHP 7.4+; testa din version och ditt tema. Pluginet startar avstängt, använder inbyggd produktions-API-slutpunkt och en ändrad loader-URL byter inte API. Locale-override kräver projektets tillåtelse. Publika nycklar fungerar från origins som standard; exakt originbegränsning är frivillig.