Přejít na hlavní obsah

Plugin chatbota pro WordPress

Použijte oficiální plugin ChattyBox pro WordPress, pokud chcete instalaci bez kódu, která načte hostovaný widget bez úprav souborů šablony. Tato příručka popisuje provozní nastavení. Stránka AI chatbota pro WordPress vysvětluje strategii obsahu a procházení, zatímco úvodní stránka pluginu pro WordPress nabízí rychlý přehled produktu.

Mohu používat ChattyBox na WordPressu bez značky?​

Ano. Oficiální plugin načte hostovaný widget ChattyBox na vašem webu WordPress. Plán Free ponechává zápatí „Powered by ChattyBox“. V tarifech Starter, Pro a Business jej můžete odstranit v části Přizpůsobení → Označení ChattyBox vypnutím volby Zobrazit značku ChattyBox. Nastavení najdete v přizpůsobení widgetu a tarify v ceníku.

Před instalací​

Nejprve dokončete postup Začínáme: připojte svou veřejnou adresu URL WordPressu, projděte indexované stránky a ověřte reprezentativní odpovědi v Otestovat chatbota. V části Instalace → Klíče a domény zkontrolujte nastavení originů veřejného klíče widgetu nebo vytvořte nový klíč. Poté v části Instalace → Instalace na web vyberte vhodný klíč a zkopírujte jej z instalačního úryvku.

Instalace pluginu​

Plugin nemá závislost na Composeru, npm ani na kroku sestavení. Aktuálně se distribuuje z veřejného repozitáře ChattyBox na GitHubu, nikoli z adresáře pluginů WordPress.org, proto ve WordPressu použijte postup Upload Plugin, nikoli hledání v adresáři. Automatické aktualizace spravované adresářem zatím nejsou k dispozici.

Připnutý balíček verze 0.2.0 deklaruje WordPress 5.8+ a PHP 7.4+; metadata uvádějí testování až do WordPressu 6.8. Otestujte svou skutečnou verzi WordPressu/PHP a šablonu; tato metadata nezaručují kompatibilitu s každým novějším vydáním.

  1. Stáhněte ZIP pluginu ChattyBox pro WordPress ve verzi 0.2.0 nebo si prohlédněte veřejný zdrojový repozitář.
  2. Ve WordPressu otevřete Plugins > Add New > Upload Plugin, nahrajte ZIP a aktivujte ChattyBox AI Chatbot. Při ruční instalaci na server nejprve zkopírujte adresář pluginu do wp-content/plugins/.
  3. Otevřete Settings > ChattyBox.
  4. Vložte veřejný API klíč widgetu z instalačního úryvku.
  5. Povolte chatbota a uložte nastavení.

Plugin ukládá veřejný klíč widgetu a nastavení zobrazení do voleb WordPressu. Do pluginu nikdy nevkládejte přihlašovací údaje pro správu ChattyBoxu.

Konfigurace načítání​

Výchozí produkční nastavení jsou:

  • Skript widgetu: https://chattybox.ai/widget.js
  • Koncový bod API: konfigurovaný automaticky pluginem
  • Aktivace: vypnutá, dokud chatbota nepovolíte s neprázdným veřejným klíčem
  • Přepsání jazyka: prázdné; hostovaný widget se řídí jazykovou politikou projektu (ve výchozím nastavení režim Auto)

V aktuálním zdrojovém kódu hostovaného widgetu režim Auto nejprve zkusí podporovaný jazyk stránky v <html lang>, potom podporované jazyky prohlížeče, nakonfigurovaný výchozí jazyk a angličtinu. Režim Fixed používá výchozí jazyk projektu. Volitelné přepsání jazyka v pluginu se předá jako data-locale a má přednost pouze tehdy, pokud projekt povoluje přepsání skriptem. Použijte podporovaný kód jazyka psaný malými písmeny; vlastní text záhlaví a uvítací zprávy se automaticky nepřekládá. Pokud na toto chování spoléháte, ověřte verzi samostatně nasazovaného loaderu.

Koncový bod API je pevně nastaven v této verzi pluginu a nezjišťuje se z klíče. Změna Widget script URL tento koncový bod nezmění. Pokud instalační úryvek webu cílí na jiné nasazení API, použijte místo toho ruční integraci skriptu. Vzdálené adresy URL loaderu musí používat HTTPS; HTTP je povoleno pouze pro lokální vývojové hostitele.

Plugin registruje widget při požadavcích WordPressu na zařazení skriptů frontendu a výslovně vynechává kanály, požadavky REST a požadavky AJAX. Tyto kontroly neprověřují všechny typy odpovědí ani nezaručují, že každá stránka frontendu je veřejná.

Tyto kontroly neověřují soukromí každé stránky frontendu ani její členský status. Podle potřeby výslovně vylučte stránky pokladny, účtu, chráněné heslem a členské stránky. Ověřte také, že šablona vypisuje skripty WordPressu v patičce. Plugin příspěvky neprochází ani nesynchronizuje; indexování obsahu a jeho obnovování probíhá v ChattyBoxu.

Klíče vytvořené bez omezení fungují ze všech originů prohlížeče; klíč připravený pro konkrétní web už může být omezen na jeho origin. Volitelná omezení v části Instalace → Klíče a domény vyžadují zadat každé povolené schéma, hostitele a port; u omezeného klíče vrátí nepovolený nebo chybějící efektivní origin odpověď 401 Invalid API key. Pokud hlavička Origin chybí, server může origin odvodit z platné hlavičky Referer. Omezení originů představuje dodatečné zabezpečení, nikoli ověřování návštěvníků — veřejné klíče pro prohlížeč nejsou tajné. Otestujte produkční stránku, nejen nástěnku.

Vyloučení dalších tras​

Pokud veřejná trasa nemá widget zobrazovat, použijte filtr chattybox_load_widget z pluginu určeného pro daný web nebo z odvozené šablony:

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

Nejprve ponechte povolené výchozí chování pluginu a poté přidejte pouze vyloučení tras, která váš web potřebuje. Po změně filtru otestujte vyloučenou trasu i běžnou veřejnou stránku.

Ruční záložní skript​

Použijte plugin jako výchozí řešení. Pokud váš tým WordPress již spravuje skripty prostřednictvím šablony, odvozené šablony, pluginu skriptů nebo Google Tag Manageru, můžete hostovaný widget načíst ručně:

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

Neaktivujte plugin a současně nepřidávejte stejný úryvek widgetu. Zvolte jeden loader, aby návštěvníci nedostali duplicitní spouštěče.

Ověření instalace​

Po konfiguraci pluginu:

  • Otevřete veřejnou stránku WordPressu v anonymním okně.
  • Ověřte, že se spouštěč zobrazí jednou.
  • Položte skutečnou otázku návštěvníka.
  • Ověřte, že podporovaná odpověď cituje indexované veřejné stránky WordPressu a že se u nepodporované otázky zobrazí náhradní odpověď, která nemusí mít žádné zdroje.
  • Zkontrolujte konzoli prohlížeče, zda nechybí data-api-key, data-api-url nebo zda neobsahuje chyby klíče.
  • Pokud jste nakonfigurovali vyloučení, otestujte trasu checkout, account nebo soukromou trasu.

Po změně nastavení nebo vyloučení vymažte příslušnou mezipaměť WordPress/CDN a otestujte nové načtení stránky. Vyloučení na straně serveru neodstraní widget, který už byl inicializován při navigaci na straně klienta. Na citlivých trasách nebo při odvolání souhlasu widget aktivně ukončete pomocí integrace podporované nasazenou verzí loaderu. Samotné odebrání skriptu ani skrytí widgetu pomocí CSS nezajistí úplné ukončení. Ukončení widgetu nemůže vrátit požadavky, které už zpracoval server.

Automatický loader pluginu před zařazením widgetu nekontroluje souhlas návštěvníka. Pokud je souhlas vyžadován, použijte integraci, která zabrání načtení widgetu, dokud návštěvník souhlas neudělí, a ověřte chování při odvolání souhlasu s nasazenou verzí loaderu.

Před oznámením chatbota pokračujte podle kontrolního seznamu spuštění. V části Konverzace → Historie, která je dostupná ve všech tarifech, můžete prohlížet konverzace. Části Konverzace → Analytika a Konverzace → Nezodpovězené otázky jsou dostupné v tarifech Pro a Business a pomáhají zlepšovat obsah WordPressu podle skutečných dotazů.