Felsökning
Använd den här sidan när widgeten är installerad men inte beter sig som förväntat.
Widget visas inte
Kontrollera webbläsarkonsolen först. ChattyBox rapporterar att det saknas obligatoriska attribut där.
Vanliga orsaker:
- Skriptet finns inte i den distribuerade sidkällan.
- Skriptet lades till i fel mall, layout, tagghanterarebehållare eller CMS kodområde.
- Skriptet ligger bakom en samtyckesregel eller tagghanterareutlösare som inte aktiverades.
- Samma app-skal tar bort skriptet under navigering på klientsidan.
- En säkerhetspolicy för innehåll blockerar
https://chattybox.ai/widget.js. - CSS eller annan widget överlappar startprogrammet.
Minsta fix:
- Öppna den distribuerade offentliga sidan i ett inkognitofönster.
- Sök sidkälla för
chattybox.ai/widget.js. - Bekräfta att skriptet visas en gång och inkluderar
data-api-keyochdata-api-url. - Flytta skriptet till den globala sidfoten, applayouten, Docusaurus roten eller GTM Alla sidor utlösaren om den saknas.
Saknar data-api-url
Widgeten avslutas tidigt när data-api-url saknas.
Använd hela kodavsnittet från instrumentpanelen eller lägg till det obligatoriska attributet:
<script
src="https://chattybox.ai/widget.js"
data-api-key="YOUR_API_KEY"
data-api-url="YOUR_WIDGET_API_URL"
async
></script>
Om din instrumentpanel visar en annan API URL, använd instrumentpanelens värde istället för exempelvärdet.
Ogiltig API Nyckel- eller ursprungsfel
Vanliga orsaker:
- Den offentliga widgetnyckeln kopierades felaktigt.
- Nyckeln togs bort, löpte ut eller skapades för ett annat projekt.
- En iscensättningsnyckel distribuerades till produktion eller en produktionsnyckel distribuerades till iscensättning.
- Nyckeln har tillåtit ursprung och det aktuella platsens ursprung ingår inte.
- Sidan laddas från
http://localhost, en förhandsgranskningsadress eller en anpassad domän som inte är tillåten för den nyckeln.
Fixar:
- Öppna projektet i instrumentpanelen ChattyBox.
- Kopiera ett nytt utdrag från fliken Bädda in.
- Om tillåtna ursprung är konfigurerade, lägg till det exakta ursprunget som betjänar sidan, inklusive protokoll och värdnamn.
- Distribuera om eller publicera om webbplatsen och testa igen i ett inkognitofönster.
Fel språk
En tillförlitlig grundad RAG-chattbot behöver tydligt källinnehåll för varje svar.
Widgeten väljer språk i denna ordning:
data-localepå widgetskriptet.- Sidans
<html lang>värde. - Besökarens webbläsarspråk.
- Engelsk reserv.
Fixar:
- Ta bort ett felaktigt
data-locale-värde om sidan automatiskt ska identifiera språk. - Ställ in
<html lang="de">,<html lang="fr">eller den matchande språkkoden på lokaliserade sidor. - Lägg bara till
data-locale="de"när en sida måste tvinga fram ett specifikt widget-gränssnittsspråk. - Skrapa om alla språkversioner om svaren citerar eller hämtar innehåll från fel språk.
Inga citat eller svaga svar
ChattyBox svar från indexerat innehåll. Saknade citat eller svaga svar betyder vanligtvis att det nödvändiga källinnehållet inte hämtades eller inte tydligt svarar på frågan.
Fixar:
- Ställ samma fråga i instrumentpanelens testchatt och jämför de citerade sidorna.
- Se till att källsidan är offentlig och inkluderad i genomsökningen.
- Lägg till tydliga rubriker, exempel, vanliga frågor och direkt svarstext till källsidan.
- Undvik att lita på skärmdumpar, videor, dolda dragspel eller iframe innehåll som den enda källan.
- Skrapa om den uppdaterade sidan och testa sedan igen.
Sidor som inte är skrapade eller gammalt innehåll
Vanliga orsaker:
- Sidan saknas i den inskickade webbplatskartan.
- Manuellt URL-läge inkluderade inte sidan.
- Sidan omdirigerar, blockerar sökrobotar, kräver autentisering eller exkluderas av robotregler.
- Sidans innehåll ändrades efter den senaste skrapningen.
- Innehållet renderas på ett sätt så att sökroboten inte kan extrahera användbar text.
Fixar:
- Bekräfta att sidan öppnas offentligt i ett privat webbläsarfönster.
- Använd webbplatskartläge för bred täckning eller manuella webbadresser för en utvald uppsättning.
- Skicka in den kanoniska webbadressen istället för en spårningsadress, omdirigeringsadress eller inloggad webbadress.
- Skrapa om efter publicering av innehållsändringar.
- Kontrollera instrumentpanelen för misslyckade eller överhoppade sidor.
Fortfarande fast
Samla in dessa uppgifter innan du kontaktar support:
- Den offentliga webbadressen där widgeten ska visas.
- En skärmdump eller kopia av ett webbläsarkonsolfel.
- Om sidan använder vanlig HTML, Next.js, Docusaurus, WordPress, en CMS eller Google Tag Manager.
- Om kodavsnittet innehåller
data-api-keyochdata-api-url. - En testfråga som borde fungera och källsidan som besvarar den.