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í v nasazeném HTML ani v živém DOM.
- 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.
- Komponenta, která loader připojuje, se na této trase nespustí.
- Zásady zabezpečení obsahu blokují
https://chattybox.ai/widget.js. - CSS nebo jiný widget překrývá spouštěč.
Nejmenší oprava:
- Otevřete nasazenou veřejnou stránku v anonymním okně.
- Vyhledejte
chattybox.ai/widget.jsve zdroji i v panelu Elements; SDK loader může být jen v DOM. - Potvrďte, že se skript objeví jednou a obsahuje
data-api-keyadata-api-url. - 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="YOUR_WIDGET_API_URL"
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šel nebo patří k jinému backendovému nasazení než URL API.
- Je zapnuto volitelné omezení originu a aktuální origin v něm není.
- 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:
- Otevřete projekt na řídicím panelu ChattyBox.
- Zkopírujte nový úryvek z karty Vložit.
- Pokud jsou nakonfigurovány povolené zdroje, přidejte přesný zdroj, který stránku obsluhuje, včetně protokolu a názvu hostitele.
- Znovu nasaďte nebo znovu publikujte web a otestujte jej znovu v anonymním okně.
Špatný jazyk
Spolehlivý uzemněný RAG chatbot potřebuje pro každou odpověď jasný zdrojový obsah.
Widget vybírá jazyk UI v tomto pořadí:
data-locale, pouze při povoleném Allow Script Override.- Ve Fixed nakonfigurovaný výchozí jazyk.
- V Auto
<html lang>, poté jazyk prohlížeče a výchozí jazyk.
Opravy:
- Pro automatiku zvolte Auto-detect a odstraňte špatné
data-localenebo zakažte override. - 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. - Locale UI nevynucuje jazyk odpovědi; indexujte a testujte každou jazykovou verzi.
Žá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 na snímky, iframe, skrytý nebo JavaScript-only obsah; zkontrolujte částečnou indexaci a dokončení embeddingů.
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 blokuje běžné HTML, vyžaduje přihlášení/CAPTCHA, vede na blokovaný cíl nebo byla odfiltrována či překročila rozpočet.
- Obsah stránky se po posledním seškrábnutí změnil.
- Obsah je dostupný jen přes JavaScript nebo mimo vybraný sémantický kořen.
Opravy:
- Potvrďte, že se stránka otevírá veřejně v soukromém okně prohlížeče.
- Použijte režim mapy webu pro široké pokrytí nebo ruční adresy URL pro vybranou sadu.
- Místo měřicí adresy URL, adresy URL přesměrování nebo adresy URL pro přihlášení zadejte kanonickou adresu URL.
- Počkejte na cooldown: 7 dní Free či 24 hodin placené tarify, i po neúspěšné úloze.
- Porovnejte uložené/vybrané počty s Content. ChattyBox
robots.txtnekontroluje a odstranění URL ze zdroje uloženou stránku nesmaže.
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-keyadata-api-url. - Jedna testovací otázka, která by měla fungovat, a zdrojová stránka, která na ni odpovídá.