Přejít na hlavní obsah
ChattyBox Logo

Odstraňování problémů

Tuto stránku použijte, když je widget nainstalován, ale nechová se podle očekávání.

Widget se nezobrazí​

Nejprve zkontrolujte konzolu prohlížeče. ChattyBox hlásí, že tam chybí povinné atributy.

Běžné příčiny:

  • Skript není přítomen v nasazeném zdroji stránky.
  • Skript byl přidán do nesprávné šablony, rozvržení, kontejneru správce značek nebo oblasti kódu CMS.
  • Skript je za pravidlem souhlasu nebo spouštěčem správce značek, které se nespustilo.
  • Stejné prostředí aplikace odstraní skript během navigace na straně klienta.
  • Zásady zabezpečení obsahu blokují https://chattybox.ai/widget.js.
  • CSS nebo jiný widget překrývá spouštěč.

Nejmenší oprava:

  1. Otevřete nasazenou veřejnou stránku v anonymním okně.
  2. Vyhledat zdroj stránky pro chattybox.ai/widget.js.
  3. Potvrďte, že se skript objeví jednou a obsahuje data-api-key a data-api-url.
  4. Pokud skript chybí, přesuňte jej do globálního zápatí, rozvržení aplikace, kořenového adresáře Docusaurus nebo GTM Všechny stránky.

Chybí data-api-url​

Widget se předčasně ukončí, když chybí data-api-url.

Použijte celý úryvek z řídicího panelu nebo přidejte požadovaný atribut:

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

Pokud váš řídicí panel zobrazuje jinou adresu URL API, použijte místo příkladu hodnotu řídicího panelu.

Neplatný API klíč nebo chyby původu​

Běžné příčiny:

  • Veřejný klíč widgetu byl zkopírován nesprávně.
  • Klíč byl smazán, vypršela jeho platnost nebo byl vytvořen pro jiný projekt.
  • Produkční klíč byl nasazen do produkčního nebo produkční klíč byl nasazen do stagingu.
  • Klíč má povolený původ a aktuální původ webu není zahrnut.
  • Stránka se načítá z http://localhost, z adresy URL náhledu nebo z vlastní domény, která není pro daný klíč povolena.

Opravy:

  1. Otevřete projekt na řídicím panelu ChattyBox.
  2. Zkopírujte nový úryvek z karty Vložit.
  3. Pokud jsou nakonfigurovány povolené zdroje, přidejte přesný zdroj, který stránku obsluhuje, včetně protokolu a názvu hostitele.
  4. Znovu nasaďte nebo znovu publikujte web a otestujte jej znovu v anonymním okně.

Špatný jazyk​

Widget vybírá jazyk v tomto pořadí:

  1. data-locale ve skriptu widgetu.
  2. Hodnota stránky <html lang>.
  3. Jazyk prohlížeče návštěvníka.
  4. Anglická záložní verze.

Opravy:

  • Pokud má stránka automaticky detekovat jazyk, odstraňte nesprávnou hodnotu data-locale.
  • Na lokalizovaných stránkách nastavte <html lang="de">, <html lang="fr"> nebo odpovídající kód jazyka.
  • Přidejte data-locale="de" pouze v případě, že stránka musí vynutit určitý jazyk uživatelského rozhraní widgetu.
  • Pokud odpovědi citují nebo načtěte obsah ve špatném jazyce, znovu seškrábejte všechny jazykové verze.

Žádné citace nebo slabé odpovědi​

ChattyBox odpovědí z indexovaného obsahu. Chybějící citace nebo slabé odpovědi obvykle znamenají, že potřebný zdrojový obsah nebyl načten nebo jasně neodpovídá na otázku.

Opravy:

  • Položte stejnou otázku v testovacím chatu dashboard a porovnejte citované stránky.
  • Ujistěte se, že zdrojová stránka je veřejná a zahrnuta do procházení.
  • Přidejte na zdrojovou stránku jasné nadpisy, příklady, často kladené dotazy a text přímých odpovědí.
  • Nespoléhejte se na snímky obrazovky, videa, skryté akordeony nebo obsah iframe jako na jediný zdroj.
  • Znovu oškrábejte aktualizovanou stránku a znovu otestujte.

Stránky nejsou seškrábané nebo zastaralý obsah​

Běžné příčiny:

  • V odeslaném souboru Sitemap chybí stránka.
  • Ruční režim URL nezahrnoval stránku.
  • Stránka přesměrovává, blokuje prohledávače, vyžaduje ověření nebo je vyloučena pravidly robotů.
  • Obsah stránky se po posledním seškrábnutí změnil.
  • Obsah je vykreslen tak, že prohledávač nemůže extrahovat užitečný text.

Opravy:

  1. Potvrďte, že se stránka otevírá veřejně v soukromém okně prohlížeče.
  2. Použijte režim mapy webu pro široké pokrytí nebo ruční adresy URL pro vybranou sadu.
  3. Místo měřicí adresy URL, adresy URL přesměrování nebo adresy URL pro přihlášení zadejte kanonickou adresu URL.
  4. Po publikování změn obsahu znovu seškrábněte.
  5. Zkontrolujte řídicí panel, zda neobsahuje neúspěšné nebo přeskočené stránky.

Stále zaseknutý​

Než kontaktujete podporu, shromážděte tyto údaje:

  • Adresa URL veřejné stránky, na které se má widget objevit.
  • Snímek obrazovky nebo kopie jakékoli chyby konzoly prohlížeče.
  • Zda stránka používá obyčejné HTML, Next.js, Docusaurus, WordPress, CMS nebo Google Tag Manager.
  • Zda fragment obsahuje data-api-key a data-api-url.
  • Jedna testovací otázka, která by měla fungovat, a zdrojová stránka, která na ni odpovídá.