Zum Hauptinhalt springen
ChattyBox Logo

Fehlerbehebung

Verwenden Sie diese Seite, wenn das Widget installiert ist, sich aber nicht wie erwartet verhält.

Widget wird nicht angezeigt​

Überprüfen Sie zunächst die Browserkonsole. ChattyBox meldet dort fehlende erforderliche Attribute.

Häufige Ursachen:

  • Das Skript ist in der bereitgestellten Seitenquelle nicht vorhanden.
  • Das Skript wurde zur falschen Vorlage, zum falschen Layout, zum falschen Tag-Manager-Container oder zum falschen CMS-Codebereich hinzugefügt.
  • Das Skript steht hinter einer Einwilligungsregel oder einem Tag-Manager-Auslöser, der nicht ausgelöst wurde.
  • Dieselbe App-Shell entfernt das Skript während der clientseitigen Navigation.
  • Eine Inhaltssicherheitsrichtlinie blockiert https://chattybox.ai/widget.js.
  • CSS oder ein anderes Widget überlappt den Launcher.

Kleinster Fix:

  1. Öffnen Sie die bereitgestellte öffentliche Seite in einem Inkognito-Fenster.
  2. Durchsuchen Sie die Seitenquelle nach chattybox.ai/widget.js.
  3. Bestätigen Sie, dass das Skript einmal erscheint und data-api-key und data-api-url enthält.
  4. Verschieben Sie das Skript in den globalen Fußzeilen-, App-Layout-, Docusaurus-Stamm- oder GTM All Pages-Trigger, wenn es fehlt.

data-api-url fehlt​

Das Widget wird vorzeitig beendet, wenn data-api-url fehlt.

Verwenden Sie den vollständigen Ausschnitt aus dem Dashboard oder fügen Sie das erforderliche Attribut hinzu:

<script
  src="https://chattybox.ai/widget.js"
  data-api-key="YOUR_API_KEY"
  data-api-url="https://app.chattybox.ai"
  async
></script>

Wenn Ihr Dashboard eine andere API-URL anzeigt, verwenden Sie den Dashboard-Wert anstelle des Beispielwerts.

Ungültiger API-Schlüssel oder Ursprungsfehler​

Häufige Ursachen:

  • Der öffentliche Widget-Schlüssel wurde falsch kopiert.
  • Der Schlüssel wurde gelöscht, ist abgelaufen oder wurde für ein anderes Projekt erstellt.
  • Ein Staging-Schlüssel wurde für die Produktion bereitgestellt oder ein Produktionsschlüssel wurde für das Staging bereitgestellt.
  • Der Schlüssel hat zulässige Ursprünge und der aktuelle Site-Ursprung ist nicht enthalten.
  • Die Seite wird von http://localhost, einer Vorschau-URL oder einer benutzerdefinierten Domäne geladen, die für diesen Schlüssel nicht zulässig ist.

Korrekturen:

  1. Öffnen Sie das Projekt im Dashboard ChattyBox.
  2. Kopieren Sie ein neues Snippet aus der Registerkarte Einbetten.
  3. Wenn zulässige Ursprünge konfiguriert sind, fügen Sie den genauen Ursprung hinzu, der die Seite bedient, einschließlich Protokoll und Hostname.
  4. Stellen Sie die Site erneut bereit oder veröffentlichen Sie sie erneut und testen Sie sie erneut in einem Inkognito-Fenster.

Falsche Sprache​

Das Widget wählt die Sprache in dieser Reihenfolge aus:

  1. data-locale im Widget-Skript.
  2. Der Seitenwert <html lang>.
  3. Die Browsersprache des Besuchers.
  4. Englischer Ersatz.

Korrekturen:

  • Entfernen Sie einen falschen data-locale-Wert, wenn die Seite die Sprache automatisch erkennen soll.
  • Legen Sie <html lang="de">, <html lang="fr"> oder den entsprechenden Sprachcode auf lokalisierten Seiten fest.
  • Fügen Sie data-locale="de" nur hinzu, wenn eine Seite eine bestimmte Widget-UI-Sprache erzwingen muss.
  • Durchsuchen Sie alle Sprachversionen erneut, wenn in den Antworten Inhalte aus der falschen Sprache zitiert oder abgerufen werden.

Keine Zitate oder schwachen Antworten​

ChattyBox Antworten aus indizierten Inhalten. Fehlende Zitate oder schwache Antworten bedeuten in der Regel, dass der benötigte Quellinhalt nicht abgerufen wurde oder die Frage nicht eindeutig beantwortet.

Korrekturen:

  • Stellen Sie die gleiche Frage im Dashboard-Testchat und vergleichen Sie die zitierten Seiten.
  • Stellen Sie sicher, dass die Quellseite öffentlich und im Crawl enthalten ist.
  • Fügen Sie der Quellseite klare Überschriften, Beispiele, FAQs und direkten Antworttext hinzu.
  • Verlassen Sie sich nicht auf Screenshots, Videos, versteckte Akkordeons oder iframe-Inhalte als einzige Quelle.
  • Durchsuchen Sie die aktualisierte Seite erneut und testen Sie sie erneut.

Nicht gelöschte Seiten oder veralteter Inhalt​

Häufige Ursachen:

  • Die Seite fehlt in der übermittelten Sitemap.
  • Im manuellen URL-Modus wurde die Seite nicht einbezogen.
  • Die Seite leitet weiter, blockiert Crawler, erfordert eine Authentifizierung oder wird durch Robots-Regeln ausgeschlossen.
  • Der Seiteninhalt hat sich nach dem letzten Scraping geändert.
  • Der Inhalt wird so gerendert, dass der Crawler keinen nützlichen Text extrahieren kann.

Korrekturen:

  1. Bestätigen Sie, dass die Seite öffentlich in einem privaten Browserfenster geöffnet wird.
  2. Verwenden Sie den Sitemap-Modus für eine umfassende Abdeckung oder manuelle URLs für eine kuratierte Gruppe.
  3. Senden Sie die kanonische URL anstelle einer Tracking-URL, einer Weiterleitungs-URL oder einer Anmelde-URL.
  4. Erneutes Scrapen nach der Veröffentlichung von Inhaltsänderungen.
  5. Überprüfen Sie das Dashboard auf fehlgeschlagene oder übersprungene Seiten.

Steckt immer noch fest​

Sammeln Sie diese Daten, bevor Sie den Support kontaktieren:

  • Die URL der öffentlichen Seite, auf der das Widget erscheinen soll.
  • Ein Screenshot oder eine Kopie eines beliebigen Browserkonsolenfehlers.
  • Ob die Seite ein einfaches HTML, Next.js, Docusaurus, WordPress, ein CMS oder Google Tag Manager verwendet.
  • Ob das Snippet data-api-key und data-api-url enthält.
  • Eine Testfrage, die funktionieren sollte, und die Quellseite, die sie beantwortet.