Ga naar de hoofdinhoud
ChattyBox Logo

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.
  • Dezelfde app-shell verwijdert het script tijdens navigatie aan de clientzijde.
  • Een inhoudbeveiligingsbeleid blokkeert https://chattybox.ai/widget.js.
  • CSS of een andere widget overlapt het opstartprogramma.

Kleinste oplossing:

  1. Open de geïmplementeerde openbare pagina in een incognitovenster.
  2. Zoek de paginabron naar chattybox.ai/widget.js.
  3. Bevestig dat het script één keer verschijnt en data-api-key en data-api-url bevat.
  4. 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="https://app.chattybox.ai"
  async
></script>

Als uw dashboard een andere API URL toont, gebruik dan de dashboardwaarde in plaats van de voorbeeldwaarde.

Ongeldige API sleutel- of oorsprongsfouten​

Veelvoorkomende oorzaken:

  • De openbare widgetsleutel is onjuist gekopieerd.
  • De sleutel is verwijderd, verlopen of gemaakt voor een ander project.
  • Er is een faseringssleutel geïmplementeerd voor productie of er is een productiesleutel geïmplementeerd voor fasering.
  • De sleutel heeft oorsprong toegestaan en de huidige oorsprong van de site is niet inbegrepen.
  • De pagina wordt geladen vanaf http://localhost, een voorbeeld-URL of een aangepast domein dat niet is toegestaan voor die sleutel.

Oplossingen:

  1. Open het project in het dashboard ChattyBox.
  2. Kopieer een nieuw fragment van het tabblad Insluiten.
  3. Als toegestane oorsprongen zijn geconfigureerd, voegt u de exacte oorsprong toe die de pagina bedient, inclusief protocol en hostnaam.
  4. Implementeer of publiceer de site opnieuw en test opnieuw in een incognitovenster.

Verkeerde taal​

De widget kiest de taal in deze volgorde:

  1. data-locale in het widgetscript.
  2. De pagina <html lang> waarde.
  3. De browsertaal van de bezoeker.
  4. Engelse terugval.

Oplossingen:

  • Verwijder een onjuiste waarde data-locale als de pagina de taal automatisch moet detecteren.
  • Stel <html lang="de">, <html lang="fr"> of de overeenkomende taalcode in op gelokaliseerde pagina's.
  • Voeg data-locale="de" alleen toe als een pagina een specifieke widget-UI-taal moet forceren.
  • Schraap alle taalversies opnieuw als de antwoorden inhoud uit de verkeerde taal citeren of ophalen.

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 accordeons of iframe-inhoud als enige bron.
  • Schraap de bijgewerkte pagina opnieuw en test opnieuw.

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 leidt om, blokkeert crawlers, vereist authenticatie of wordt uitgesloten door robotsregels.
  • De pagina-inhoud is gewijzigd na de laatste scraping.
  • De inhoud wordt zo weergegeven dat de crawler geen bruikbare tekst kan extraheren.

Oplossingen:

  1. Bevestig dat de pagina openbaar wordt geopend in een privébrowservenster.
  2. Gebruik de sitemapmodus voor brede dekking of handmatige URL's voor een samengestelde set.
  3. Geef de canonieke URL op in plaats van een tracking-URL, omleidings-URL of ingelogde URL.
  4. Opnieuw schrapen na het publiceren van inhoudswijzigingen.
  5. Controleer het dashboard op mislukte of overgeslagen pagina's.

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-key en data-api-url bevat.
  • Eén testvraag die zou moeten werken en de bronpagina die deze beantwoordt.