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.

Kan jag använda ChattyBox på WordPress utan varumärkesmärkning?

Ja. Det officiella pluginet laddar den hostade ChattyBox-widgeten på din WordPress-webbplats. Free behåller sidfoten ”Powered by ChattyBox”. Starter, Pro och Business kan ta bort den under Anpassa → ChattyBox varumärke genom att stänga av Visa ChattyBox-varumärket. Se widgetanpassning för inställningen och priser för abonnemangen.

Innan installation

Slutför först flödet Kom igång: anslut din offentliga WordPress-URL, granska indexerade sidor och verifiera representativa svar i Testa chatbot. Under Installera → Nycklar & domäner kontrollerar du ursprungsinställningarna för en offentlig widgetnyckel och skapar en vid behov. Under Installera → Installation på webbplatsen väljer du en lämplig nyckel och kopierar den från installationssnutten.

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.

Det versionslåsta 0.2.0-paketet anger WordPress 5.8+ och PHP 7.4+, med testmetadata upp till WordPress 6.8. Testa dina faktiska WordPress-/PHP-versioner och ditt tema; metadata är ingen garanti för alla senare versioner.

1. Ladda ner den versionslåsta ZIP-filen för ChattyBox WordPress-pluginet 0.2.0, eller granska det offentliga källrepositoriet.
2. Ö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/.
3. Öppna Settings > ChattyBox.
4. Klistra in widgetens offentliga API-nyckel från installationssnutten.
5. 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
• Aktiverad: av tills du aktiverar chatboten med en icke-tom offentlig nyckel
• Språköverskrivning: tom; den hostade widgeten följer projektets språkpolicy (Auto-läge som standard)

I den aktuella källkoden för den hostade widgeten provar Auto-läget först ett språk som stöds i sidans <html lang>, därefter webbläsarspråk som stöds, det konfigurerade standardspråket och engelska. Fixed-läge använder projektets standardspråk. Pluginets valfria språköverskrivning blir data-locale och har företräde endast om projektet tillåter skriptöverskrivningar. Använd en språkkod med gemener som stöds; anpassad rubrik- och välkomsttext översätts inte automatiskt. Kontrollera versionen av den separat driftsatta loadern om du förlitar dig på detta beteende.

API-slutpunkten är inbyggd i den här pluginversionen och hämtas inte från nyckeln. Om du ändrar Widget script URL ändras inte slutpunkten. Om installationssnutten för webbplatsen riktar sig mot en annan API-distribution använder du den manuella skriptintegrationen i stället. Externa loader-URL:er måste använda HTTPS (HTTP tillåts endast för lokala utvecklingsvärdar).

Pluginet registrerar widgeten vid WordPress frontendförfrågningar för enqueue och hoppar uttryckligen över feeds, REST-förfrågningar och AJAX-förfrågningar. Dessa kontroller granskar inte varje svarstyp och fastställer inte att varje frontend-sida är offentlig. De bedömer inte heller sekretessen eller medlemsstatusen för varje frontend-sida. Uteslut vid behov uttryckligen checkout-, konto-, lösenordsskyddade och medlemssidor.

Kontrollera också att temat skriver ut WordPress-skripten i sidfoten. Pluginet genomsöker eller synkroniserar inte WordPress-inlägg; innehållsindexering och uppdateringar sker i ChattyBox.

Nycklar som skapats utan begränsningar fungerar från alla webbläsarorigins; en nyckel som förberetts för en webbplats kan redan vara begränsad till webbplatsens origin. Valfria begränsningar under Installera → Nycklar & domäner kräver varje avsett schema, värdnamn och port. En begränsad nyckel ger 401 Invalid API key om förfrågans effektiva origin saknas eller inte tillåts. Om Origin-headern saknas kan servern härleda origin från en giltig Referer. Originbegränsningar är extra skydd, inte autentisering av besökare, och publika webbläsarnycklar är inte hemligheter. Testa på produktionssidan, inte bara i instrumentpanelen.

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-url eller nyckelfel.
• Testa en checkout-, account- eller privat rutt om du har konfigurerat ett undantag.
• Rensa relevant WordPress-/CDN-sidcache efter att du ändrat inställningar eller undantag och testa en ny sidladdning. Undantag på serversidan tar inte bort en widget som redan har initierats vid klientnavigering. På känsliga sidor eller när samtycke återkallas måste du aktivt riva ned den med en integration som stöds av den driftsatta loadern. Varken borttagning av skriptet eller att dölja widgeten med CSS innebär en fullständig nedmontering. En nedmontering kan inte ångra förfrågningar som servern redan har behandlat.
• Pluginets automatiska loader kontrollerar inte besökarens samtycke innan widgeten läggs i laddningskön. Om samtycke krävs ska du använda en integration som förhindrar laddning tills samtycke har getts och verifiera hur återkallat samtycke hanteras med den driftsatta loadern.

Fortsätt med checklistan inför lansering innan du tillkännager chattboten. Granska konversationer under Samtal → Historik, som är tillgängligt på alla abonnemang. På Pro- eller Business-abonnemang kan du använda Samtal → Analys och Samtal → Obesvarade frågor för att granska förbättringsområden när riktiga frågor börjar komma in.