Problemen oplossen
Gebruik deze pagina wanneer de widget is geïnstalleerd maar zich niet gedraagt zoals verwacht.
Widget verschijnt niet
Controleer eerst de browserconsole. ChattyBox meldt dat daar de vereiste attributen ontbreken.
Veelvoorkomende oorzaken:
- Het script is niet aanwezig in de geïmplementeerde paginabron.
- Het script is toegevoegd aan het verkeerde sjabloon, de verkeerde lay-out, de Tag Manager-container of het verkeerde codegebied CMS.
- Het script zit achter een toestemmingsregel of tagmanager-trigger die niet is geactiveerd.
- Een app-shell verwijdert de loader tijdens navigatie aan clientzijde; dat is geen UI-teardown.
- De gedeployde configuratie heeft
widget.enabled: false. - Een inhoudbeveiligingsbeleid blokkeert
https://chattybox.ai/widget.js. - CSS of een andere widget overlapt het opstartprogramma.
Kleinste oplossing:
- Open de geïmplementeerde openbare pagina in een incognitovenster.
- Zoek zowel in paginabron als Elements-paneel naar
chattybox.ai/widget.js; een SDK-loader kan alleen in de live DOM staan. - Bevestig dat het script één keer verschijnt en
data-api-keyendata-api-urlbevat. - Verplaats het script naar de globale voettekst, app-indeling, Docusaurus root of GTM Alle pagina's worden geactiveerd als dit ontbreekt.
data-api-url ontbreekt
De widget wordt eerder afgesloten als data-api-url ontbreekt.
Gebruik het volledige fragment uit het dashboard of voeg het vereiste attribuut toe:
<script
src="https://chattybox.ai/widget.js"
data-api-key="YOUR_API_KEY"
data-api-url="YOUR_WIDGET_API_URL"
async
></script>
Als uw dashboard een andere API URL toont, gebruik dan de dashboardwaarde in plaats van de voorbeeldwaarde.
Generieke 401 Invalid API key
Veelvoorkomende oorzaken:
- De openbare widgetsleutel is onjuist gekopieerd.
- De sleutel is verwijderd, verlopen of gemaakt voor een ander project.
- De sleutel komt uit een andere backenddeployment dan de API-URL of het project/de eigenaar wordt verwijderd.
- De optionele originbeperking is ingeschakeld en de huidige origin ontbreekt.
Oplossingen:
- Open het project in het dashboard ChattyBox.
- Kopieer een nieuw fragment van het tabblad Insluiten.
- Open Public Keys > Edit origins alleen wanneer de beperking is ingeschakeld. Voeg de exacte origin toe met schema, host en poort; paden hebben geen aparte invoer nodig.
- Implementeer of publiceer de site opnieuw en test opnieuw in een incognitovenster.
Verkeerde taal
Een betrouwbare gegronde RAG-chatbot heeft duidelijke broncontent nodig voor elk antwoord.
De widget kiest de UI-taal in deze volgorde:
data-locale, maar alleen wanneer Allow Script Override is ingeschakeld.- In Fixed-modus de ingestelde standaardtaal.
- In Auto-modus
<html lang>, daarna browsertaal, daarna de standaardwaarde. - Niet-ondersteunde waarden worden Engels zonder de volgende kandidaat te proberen.
Oplossingen:
- Verwijder een onjuiste waarde
data-localeals de pagina de taal automatisch moet detecteren. - Stel
<html lang="de">,<html lang="fr">of de overeenkomende taalcode in op gelokaliseerde pagina's. - Een toegestane
data-localewint ook in Fixed-modus. Sla op, herlaad en test; locale wordt niet bij elke routewijziging opgelost. - Schraap alle taalversies opnieuw bij verkeerdtalige bronnen. De UI-locale vertaalt inhoud niet en dwingt geen antwoordtaal af.
Geen citaten of zwakke antwoorden
ChattyBox antwoorden uit geïndexeerde inhoud. Ontbrekende citaten of zwakke antwoorden betekenen meestal dat de benodigde broninhoud niet is opgehaald of de vraag niet duidelijk beantwoordt.
Oplossingen:
- Stel dezelfde vraag in de dashboard-testchat en vergelijk de geciteerde pagina's.
- Zorg ervoor dat de bronpagina openbaar is en wordt opgenomen in de crawl.
- Voeg duidelijke kopjes, voorbeelden, veelgestelde vragen en directe antwoordtekst toe aan de bronpagina.
- Vertrouw niet op schermafbeeldingen, video’s, verborgen markup, uitsluitend JavaScript-content of iframes als enige bron.
- Scrape opnieuw na de cooldown, wacht op embeddings en controleer Partially indexed: tekst boven 512 KiB wordt niet opgeslagen.
- Formuleer vervolgvragen zelfstandig: opgeslagen gespreksbeurten bereiken de antwoordgenerator momenteel niet.
Pagina's die niet zijn geschrapt of verouderde inhoud
Veelvoorkomende oorzaken:
- De pagina ontbreekt in de ingediende sitemap.
- De handmatige URL-modus omvatte de pagina niet.
- De pagina blokkeert gewone HTML-verzoeken, vereist authenticatie, geeft CAPTCHA/fout, leidt om naar een geblokkeerd doel of wordt uitgesloten door selectie, paginalimiet of refreshbudget.
robots.txtwordt niet afgedwongen. - De pagina-inhoud is gewijzigd na de laatste scraping.
- De inhoud wordt zo weergegeven dat de crawler geen bruikbare tekst kan extraheren.
Oplossingen:
- Bevestig dat de pagina openbaar wordt geopend in een privébrowservenster.
- Gebruik de sitemapmodus voor brede dekking of handmatige URL's voor een samengestelde set.
- Geef de canonieke URL op in plaats van een tracking-URL, omleidings-URL of ingelogde URL.
- Scrape pas opnieuw na de cooldown: zeven dagen vanaf de laatste taak op Free, 24 uur op betaalde plannen, ook na een mislukte taak.
- Vergelijk opgeslagen/geselecteerde aantallen en de Content-lijst. Completed kan URL’s missen; Completed with warnings gaat over gedeeltelijk opgeslagen tekst, niet alle crawlfouten.
URL’s die uit de selectie verdwijnen blijven opgeslagen totdat je ze ook onder Content verwijdert. Rebuild Index gebruikt opgeslagen tekst, haalt het netwerk niet opnieuw op en verbruikt het refreshbudget.
Nog steeds vast
Verzamel deze gegevens voordat u contact opneemt met de ondersteuning:
- De URL van de openbare pagina waar de widget moet verschijnen.
- Een screenshot of kopie van een browserconsolefout.
- Of de pagina gewoon HTML, Next.js, Docusaurus, WordPress, een CMS of Google Tag Manager gebruikt.
- Of het fragment
data-api-keyendata-api-urlbevat. - Eén testvraag die zou moeten werken en de bronpagina die deze beantwoordt.