Hoppa till huvudinnehållet
ChattyBox Logo

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:

  1. Öppna den distribuerade offentliga sidan i ett inkognitofönster.
  2. Sök sidkälla för chattybox.ai/widget.js.
  3. Bekräfta att skriptet visas en gång och inkluderar data-api-key och data-api-url.
  4. 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.
  • Nyckeln kommer från en annan backend-distribution än API-URL:en.
  • En valfri originbegränsning är aktiverad och sidans origin ingår inte exakt.

Fixar:

  1. Öppna projektet i instrumentpanelen ChattyBox.
  2. Kopiera ett nytt utdrag från fliken Bädda in.
  3. Kontrollera Public Keys > Edit origins endast om Restrict this key to specific origins är aktiverad. Lägg då till sidans exakta origin med schema, värdnamn och port, eller inaktivera den frivilliga begränsningen.
  4. 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 UI-språk enligt projektets policy:

  1. data-locale på widgetskriptet, bara när Allow Script Override är aktiverat.
  2. I Fixed-läge används det konfigurerade standardspråket.
  3. I Auto-detect-läge används sidans <html lang>, sedan webbläsarens språk och sist projektets standardspråk.
  4. Ett ostött men angivet språk blir engelska direkt; nästa kandidat provas inte.

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 begära ett visst widgetgränssnittsspråk och projektet tillåter override.
  • Skrapa om och bekräfta att de önskade publika språkversionerna verkligen indexerades om svaren citerar eller hämtar innehåll från fel språk.

Inga citat eller svaga svar​

ChattyBox använder indexerat innehåll som underlag. Saknade citat eller svaga svar betyder ofta att det nödvändiga källinnehållet inte hämtades eller inte tydligt svarar på frågan; grundning garanterar inte korrekthet.

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 kräver autentisering, ger en botutmaning eller ett felsvar, omdirigerar till ett blockerande mål eller filtreras bort av källurvalet. robots.txt används inte.
  • 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:

  1. Bekräfta att sidan öppnas offentligt i ett privat webbläsarfönster.
  2. Använd webbplatskartläge för bred täckning eller manuella webbadresser för en utvald uppsättning.
  3. Skicka in den kanoniska webbadressen istället för en spårningsadress, omdirigeringsadress eller inloggad webbadress.
  4. Skrapa om efter publicering av innehållsändringar.
  5. 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-key och data-api-url.
  • En testfråga som borde fungera och källsidan som besvarar den.

Ett 401 Invalid API key kan bero på en ogiltig nyckel eller en frivilligt aktiverad originbegränsning; nyckeln har inte separata staging/production-egenskaper. Crawlern renderar inte JavaScript och kan slutföra med missade URL:er eller partiellt lagrad text. På config-låsta projekt måste ändringar och manuella indexåtgärder distribueras via CLI; låset kan inte ångras.

Integritetsval

Vi använder valfria analys- och tagghanteringsverktyg för att förstå hur webbplatsen används. Välj om du vill tillåta Ahrefs Web Analytics, PostHog och Google Tag Manager. Om du stänger av analysen laddas sidan om så att ändringen genomförs korrekt. Grundläggande webbplatsfunktioner och felövervakning styrs inte av detta val. Läs vår integritetspolicy.