Liigu põhisisu juurde

WordPressi vestlusroboti plugin

Kasuta ametlikku ChattyBoxi WordPressi pluginat, kui soovid koodivaba paigaldust, mis laadib hostitud vidina ilma teemafaile muutmata. See juhend käsitleb töökorralduslikku seadistamist. WordPressi tehisintellekti vestlusroboti leht selgitab sisu- ja roomamisstrateegiat, samas kui WordPressi plugina tutvustusleht annab tootest kiire ülevaate.

Kas saan kasutada ChattyBoxi WordPressis ilma brändinguta?​

Jah. Ametlik plugin laadib teie WordPressi saidil hostitud ChattyBoxi vidina. Free jätab jaluse „Powered by ChattyBox“ nähtavale. Starteri, Pro ja Businessi paketis saab selle eemaldada jaotises Kohanda → ChattyBoxi bränding, lülitades välja valiku Näita ChattyBoxi brändingut. Seadistuse leiate vidina kohandamise juhendist ja paketid hinnakirjast.

Enne paigaldamist​

Viige esmalt lõpule Alustamine: ühendage oma avalik WordPressi URL, vaadake üle indekseeritud lehed ja kontrollige esinduslikke vastuseid jaotises Testi vestlusrobotit. Jaotises Paigalda → Võtmed ja domeenid vaadake üle vidina avaliku võtme origin’i seaded või looge uus võti. Seejärel valige jaotises Paigalda → Veebisaidi paigaldamine sobiv võti ja kopeerige see paigalduslõigust.

Plugina paigaldamine​

Plugin ei sõltu Composerist, npm-ist ega ehitusetapist. Seda levitatakse praegu avalikust ChattyBoxi GitHubi hoidlast, mitte WordPress.org-i pluginate kataloogist, seega kasutage kataloogist otsimise asemel WordPressi Upload Plugin-i töövoogu. Kataloogipõhised automaatsed uuendused pole veel saadaval.

Fikseeritud versiooniga 0.2.0 pakett deklareerib WordPressi 5.8+ ja PHP 7.4+ ning selle testimismetaandmed ulatuvad WordPressi versioonini 6.8. Kontrollige oma tegelikku WordPressi/PHP versiooni ja teemat; need metaandmed ei taga ühilduvust iga uuema väljalaskega.

  1. Laadige alla ChattyBoxi WordPressi plugina fikseeritud versiooniga 0.2.0 ZIP või tutvuge avaliku lähtekoodihoidlaga.
  2. Avage WordPressis Plugins > Add New > Upload Plugin, laadige ZIP üles ja aktiveerige ChattyBox AI Chatbot. Käsitsi serverisse paigaldamisel kopeerige plugina kataloog esmalt asukohta wp-content/plugins/.
  3. Avage Settings > ChattyBox.
  4. Kleepige paigalduslõigust pärit vidina avalik API-võti.
  5. Lubage vestlusrobot ja salvestage sätted.

Plugin salvestab vidina avaliku võtme ja kuvaseaded WordPressi suvanditesse. Ärge kunagi kleepige pluginasse ChattyBoxi haldusmandaati.

Laadimise konfigureerimine​

Tootmise vaikeväärtused on järgmised:

  • Vidina skript: https://chattybox.ai/widget.js
  • API lõpp-punkt: plugin konfigureerib selle automaatselt
  • Lubatud: välja lülitatud, kuni lubate vestlusroboti mittetühja avaliku võtmega
  • Lokaadi override: tühi; hostitud vidin järgib projekti lokaadipoliitikat (vaikimisi Auto-režiim)

Hostitud vidina praeguses lähtekoodis proovib Auto-režiim esmalt lehe toetatud <html lang> väärtust, seejärel toetatud brauserikeeli, seadistatud vaikimisi lokaati ja inglise keelt. Fixed-režiim kasutab projekti vaikimisi lokaati. Plugina valikuline lokaadi override edastatakse väärtusena data-locale ja sellel on mõju ainult siis, kui projekt lubab skripti override’e. Kasutage toetatud väiketähtedega lokaadikoodi; kohandatud päise- ja tervitustekste ei tõlgita automaatselt. Sellele käitumisele toetudes kontrollige eraldi juurutatud loaderi versiooni.

Plugin registreerib vidina laadimiseks WordPressi esiosa enqueue-päringute korral ning jätab selgesõnaliselt vahele kanalid, REST-päringud ja AJAX-päringud. Need kontrollid ei uuri iga vastuse tüüpi ega tõenda, et iga esiosaleht on avalik.

Need päringukontrollid ei tuvasta iga frontend-lehe privaatsust ega liikmesuse staatust. Vajaduse korral välistage selgesõnaliselt checkout-, konto-, parooliga kaitstud ja liikmesuselehed. Veenduge ka, et teema väljastab WordPressi skriptid jaluses. Plugin ei indekseeri ega sünkrooni postitusi; sisu indekseerimine ja värskendamine toimub ChattyBoxis.

Ilma piiranguteta loodud võtmed töötavad kõigilt brauseri origin’idelt; veebisaidi jaoks ettevalmistatud võti võib juba olla piiratud selle saidi origin’iga. Valikulised piirangud jaotises Paigalda → Võtmed ja domeenid nõuavad iga lubatud skeemi, hostinime ja pordi lisamist. Piiratud võtme puhul tagastab puuduv või keelatud efektiivne origin vastuse 401 Invalid API key; päise Origin puudumisel võib server tuletada origin’i kehtivast Referer-päisest. Origin’i piirangud on täiendav kaitse, mitte külastaja autentimine — avalikud brauserivõtmed pole saladused. Kontrollige päris tootmislehte, mitte ainult juhtpaneeli.

API lõpp-punkt on sellesse plugina versiooni sisse ehitatud, mitte võtme põhjal tuvastatav. Widget script URL-i muutmine seda lõpp-punkti ei muuda. Kui veebisaidi paigalduslõik osutab teisele API juurutusele, kasutage selle asemel käsitsi skriptiintegratsiooni. Kauglaaduri URL-id peavad kasutama HTTPS-i; HTTP on lubatud ainult kohalikel arendusaadressidel localhost, 127.0.0.1 ja ::1.

Täiendavate marsruutide välistamine​

Kasutage filtrit chattybox_load_widget saidipõhisest pluginast või alamteemast, kui avalikul marsruudil ei tohiks vidinat näidata:

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

Jätke esmalt plugina vaikekäitumine lubatuks ja lisage seejärel ainult need marsruudierandid, mida teie sait vajab. Pärast filtri muutmist testige nii välistatud marsruuti kui ka tavalist avalikku lehte.

Käsitsi skripti varuvariant​

Kasutage pluginat vaikimisi. Kui teie WordPressi meeskond haldab skripte juba teema, alamteema, skriptiplugina või Google Tag Manageri kaudu, saate hostitud vidina selle asemel käsitsi laadida:

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

Ärge lubage pluginat ja lisage samal ajal sama vidina koodilõiku. Valige üks laadija, et külastajad ei saaks topeltkäivitajaid.

Paigalduse kontrollimine​

Pärast plugina konfigureerimist:

  • Avage avalik WordPressi leht inkognitoaknas.
  • Kontrollige, et käivitaja ilmub ühe korra.
  • Esitage päris külastaja küsimus.
  • Kontrollige, et toetatud vastus viitaks indekseeritud avalikele WordPressi lehtedele ja et toetamata küsimuse korral kuvataks varuvastus, millel ei pruugi allikaid olla.
  • Kontrollige brauseri konsoolist puuduvaid data-api-key, data-api-url väärtusi või võtmevigu.
  • Testige checkout-, account- või privaatset marsruuti, kui seadistasite välistuse.

Pärast seadete või välistuste muutmist tühjendage asjaomane WordPressi/CDN-i vahemälu ja kontrollige lehte uue laadimisega. Serveripoolsed välistused ei eemalda vidinat, mis on juba kliendipoolse navigeerimise käigus käivitatud. Tundlikel marsruutidel või nõusoleku tagasivõtmisel lõpetage vidina töö aktiivselt, kasutades juurutatud loaderi versiooni toetatud integratsiooni. Üksnes skripti eemaldamine või vidina CSS-iga peitmine ei taga täielikku sulgemist. Vidina sulgemine ei saa tagasi võtta serveri juba töödeldud päringuid.

Plugina automaatne laadija ei kontrolli külastaja nõusolekut enne vidina laadimisjärjekorda lisamist. Kui nõusolek on nõutav, kasutage integratsiooni, mis takistab laadimist kuni nõusoleku andmiseni, ning kontrollige nõusoleku tagasivõtmise käitumist juurutatud loaderiga.

Jätkake enne vestlusroboti väljakuulutamist käivitamise kontroll-loendiga. Vestlused → Ajalugu on saadaval kõigi pakettidega ja selle abil saate vestlusi üle vaadata. Vestlused → Analüütika ja Vestlused → Vastamata küsimused on saadaval Pro- või Business-paketis, et pärast päris küsimuste saabumist leida võimalusi parendusteks.