Zum Hauptinhalt springen

:::note Versionsstatus Der aktuelle Quellcode des gehosteten Loaders widget.js in diesem Repository ist v16. Das garantiert nicht, dass die bereitgestellte Version v16 ist: Prüfen Sie den tatsächlich ausgelieferten Loader, bevor Sie sich auf diese Verhaltensweisen verlassen. Das veröffentlichte npm-SDK 0.1.4 hat eine separate Versionsnummer von der des gehosteten Loaders. :::

Anpassung des gehosteten Widgets

Passen Sie die vorgefertigte Oberfläche an, die von https://chattybox.ai/widget.js geladen wird. Kanonische Installationsbeispiele für Frameworks und Plattformen finden Sie in den Installationsleitfäden.

Vor der Anpassung​

Erstellen Sie das Projekt, indexieren Sie seine Inhalte und überprüfen Sie repräsentative Antworten unter Chatbot testen, bevor Sie Zeit in die Darstellung investieren. Die vollständige Reihenfolge finden Sie unter Erste Schritte.

Gehostetes Widget konfigurieren​

  1. Öffnen Sie Ihr Dashboard und wählen Sie Ihr Projekt aus.
  2. Öffnen Sie Anpassen → Erscheinungsbild, um Aussehen, Branding und Spracheinstellungen des Widgets zu bearbeiten.
  3. Prüfen Sie den Status der automatischen Speicherung. Beheben Sie Validierungsfehler oder versuchen Sie fehlgeschlagene Speicherungen erneut, bevor Sie das installierte Widget testen.

Installationscode und öffentliche Schlüssel werden unter Installieren verwaltet. Wenn Sie das Widget installieren möchten:

  1. Öffnen Sie Installieren → Schlüssel und Domains, um einen öffentlichen Browserschlüssel zu prüfen oder zu erstellen und seine Origin-Einstellungen zu kontrollieren.
  2. Wählen Sie unter Installieren → Installation auf der Website einen passenden Schlüssel aus und kopieren Sie das generierte Snippet. Bei der Website-Installation wird ein Schlüssel vorbereitet, der bereits auf die eingegebene exakte Origin beschränkt sein kann. Schlüssel ohne Einschränkungen funktionieren von allen Origins aus: Prüfen Sie den ausgewählten Schlüssel, bevor Sie ihn für Staging oder localhost verwenden.
  3. Optional können Sie exakte Origin-Einschränkungen als zusätzliche Schutzmaßnahme aktivieren. Eine Origin umfasst Schema, Host und Port; diese Einschränkungen authentifizieren keine Besucher.
  4. Befolgen Sie die Installationsleitfäden für Ihre Plattform.
<script
src="https://chattybox.ai/widget.js"
data-api-key="YOUR_API_KEY"
data-api-url="https://adorable-woodpecker-629.convex.site/chat"
async
></script>
Tipp

Gespeicherte Änderungen gelten bei der nächsten Initialisierung des Widgets; bereits geöffnete Seiten werden nicht live aktualisiert. Prüfen Sie vor dem Neuladen den Status der automatischen Speicherung. Die Dashboard-Vorschau ist ein Mock und nicht das gehostete Widget.


Visuelle Anpassung​

Mit dem Dashboard-Editor können Sie unterstützte Farben, Position, Symbol und Text des Widgets ohne Änderungen am Website-Code anpassen. Prüfen Sie das Ergebnis im gehosteten Widget, denn Vorschau und Loader sind nicht identisch.

Dashboard-Steuerelemente​

  1. Akzentfarbe – Wählen Sie die Primärfarbe Ihrer Marke. Sie wirkt sich auf die Schaltfläche zum Öffnen, wichtige Hervorhebungen und Nutzernachrichten aus.

  2. Widget-Position – Wählen Sie, wo das Widget auf dem Bildschirm erscheint.

  3. Titel der Kopfzeile – Legen Sie den Titel fest, der oben im Chatfenster angezeigt wird.

  4. Willkommensnachricht – Passen Sie die erste Nachricht an, die Besucher beim Öffnen des Chats sehen.

  5. ChattyBox-Branding – Starter und höhere Tarife können den Footer „Bereitgestellt von ChattyBox“ ausblenden. Im Tarif Free muss das Branding aktiviert bleiben.

Der Editor bietet außerdem die Optionen Widget-Hintergrund und Textfarbe sowie ein Standard-Robotersymbol, Emoji, eine Bild-URL oder ein hochgeladenes Bild als Widget-Symbol. Die Option Symbolgröße wird nur angezeigt, wenn Sie eine Bild-URL auswählen oder ein Bild hochladen. Hochgeladene Symbole dürfen höchstens 512 KiB groß sein und müssen einen unterstützten Bild-MIME-Typ verwenden (PNG, JPEG, WebP, SVG, GIF oder ICO). Im aktuellen Quellcode des gehosteten Loaders v16 bestimmt iconSize die Größe der Öffnen-Schaltfläche und des Symbols. Prüfen Sie den tatsächlich ausgelieferten Loader, bevor Sie sich auf dieses Verhalten verlassen.

Notiz

Bei konfigurationsgesperrten Projekten werden Erscheinungsbild und Sprache über Config-as-Code verwaltet. Projekte mit entsprechender Berechtigung können das Branding weiterhin separat speichern. Prüfen Sie den Status der automatischen Speicherung und laden Sie anschließend die installierte Seite neu, um die Änderungen zu kontrollieren.

Konfigurationsstandardwerte​

Die Tabelle zeigt die Werte, die der aktuelle Quellcode zurückgibt, wenn eine öffentliche Widget-Konfigurationsanfrage erfolgreich ist und kein eigener Wert festgelegt wurde. Sie garantiert nicht, dass die bereitgestellte Version dem aktuellen Quellcode entspricht; prüfen Sie den tatsächlich ausgelieferten Loader, bevor Sie sich auf versionsabhängiges Verhalten verlassen.

FeldStandardwert
enabledtrue, sofern das Projekt nicht deaktiviert ist
themeColor#3b82f6
chatBgColor#0f172a
textColor#f8fafc
positionbottom-right; alle vier Ecken werden unterstützt
iconType, iconSizedefault, medium; der gehostete Loader v16 im aktuellen Quellcode verwendet diese Größe für Öffnen-Schaltfläche und Symbol
iconEmoji, iconUrl💬, null
headerTitleChat with us (API-Standardwert)
welcomeMessageHi! 👋 How can I help you today? (API-Standardwert)
showBrandingtrue; bei Free-Projekten immer aktiviert
localeMode, defaultLocale, allowLocaleOverrideauto, en, true (Standardwerte)

Erweiterte Optionen​

Dashboard-Einstellungen und Skriptattribute​

Das Verhalten des Widgets sollte größtenteils über das Dashboard verwaltet werden, damit Sie Ihre Website für einfache Änderungen nicht erneut bereitstellen müssen.

Verwenden Sie das Dashboard für Farben, Position, Symbol, Header-Titel, Willkommensnachricht, Sprachvoreinstellungen, Verwaltung öffentlicher Schlüssel, Scraping und Analytics.

Wenn Sie für einen öffentlichen Schlüssel eine Origin-Einschränkung aktivieren, halten Sie die exakten Origins mit den Websites synchron, auf denen das Widget installiert ist. Der Abgleich berücksichtigt Schema, Host und Port. Browserschlüssel sind öffentlich; Origin-Einschränkungen sind eine optionale zusätzliche Schutzmaßnahme, aber keine Besucherauthentifizierung.

Verwenden Sie Skriptattribute für Werte, die das Widget beim Laden der Seite benötigt. Der Loader im aktuellen Quellcode beobachtet außerdem Änderungen an data-locale, wie unten beschrieben:

  • data-api-key identifiziert den öffentlichen Widget-Schlüssel.
  • data-api-url gibt an, wohin das Widget Anfragen sendet. In der Produktion ist dies eine stabile https://...convex.site/chat-URL aus Ihrem Dashboard.
  • data-locale fordert eine bestimmte UI-Sprache an, wenn Projekt-Overrides erlaubt sind. Der Loader im aktuellen Quellcode beobachtet außerdem Änderungen an diesem Attribut.
  • Im aktuellen Quellcode des gehosteten Loaders v16 überschreiben data-color und data-position nach erfolgreichem Abruf der Konfiguration die gespeicherte Akzentfarbe bzw. Position; diese Attribute können spätere Dashboard-Änderungen verdecken. Bevorzugen Sie die Werte im Dashboard und prüfen Sie den tatsächlich ausgelieferten Loader, bevor Sie sich auf dieses Verhalten verlassen.
  • data-debug="true" aktiviert Konsolendiagnosen; standardmäßig ist diese Option deaktiviert.

Ladefehler​

Im aktuellen Quellcode des gehosteten Loaders v16 bleibt das Widget nicht verfügbar, wenn der Konfigurationsabruf fehlschlägt oder eine ungültige Antwort liefert; es wird keine Ersatzoberfläche angezeigt. Auch eine erfolgreich geladene Konfiguration mit enabled: false verhindert die Anzeige. Die Chat-API weist Anfragen für ein deaktiviertes Widget mit HTTP 403 zurück, auch SDK-Anfragen. Prüfen Sie die tatsächlich bereitgestellte Loader-Version, bevor Sie sich auf dieses Verhalten verlassen.

Ein Fehler beim Abruf der Übersetzungen ist davon zu unterscheiden: Er tritt erst auf, nachdem die Konfiguration erfolgreich geladen wurde. Das Widget kann dann mit den integrierten englischen Labels angezeigt werden. Fehlende Einträge im Katalog verwenden ebenfalls die englischen Standardwerte.

Wenn der Loader ohne ein auf der Seite verfügbares SDK läuft, ruft der gehostete Loader v16 im aktuellen Quellcode die Konfiguration mit Authorization: Bearer ab und wiederholt die Anfrage genau einmal mit dem Schlüssel im Query-Parameter apiKey – und zwar nur nach HTTP 400. Das veröffentlichte SDK 0.1.4 verwendet denselben, auf die Konfiguration beschränkten Fallback, wenn die Seite window.ChattyboxSDK bereitstellt. Der Loader v16 wiederholt beim Start Konfigurations- und Übersetzungs-GETs bei separat wiederholbaren Fehlern. Chatnachrichten verwenden den eigenen Transport des gehosteten Loaders. Beim SDK-Mount teilt das veröffentlichte SDK 0.1.4 nur identische Optionen und lehnt einen geänderten Schlüssel, Endpunkt, eine andere Script-URL, Locale oder Debug-Einstellung ab, bis alle passenden Handles entfernt wurden. Prüfen Sie den tatsächlich ausgelieferten Loader, bevor Sie sich auf das Verhalten des aktuellen Quellcodes verlassen.

Bei einer neuen Nachricht versucht der gehostete Loader im aktuellen Quellcode v16, für die Analytics Beliebte Trigger die Origin und den Pfad der aktuellen HTTP(S)-Seite zu übermitteln. Er prüft nicht, ob die Seite öffentlich ist. Ungültiger oder zu langer Kontext wird ausgelassen; Wiederholungsversuche behalten den Kontext der ursprünglichen Anfrage bei. Query-Strings, Fragmente und Zugangsdaten werden entfernt, aber Pfade können sensible Kennungen enthalten. Installieren Sie das Widget nicht allein deshalb auf sensiblen Routen, weil Query-Strings entfernt werden. Das Widget berücksichtigt außerdem prefers-reduced-motion, bietet ein beschriftetes Nachrichtenfeld und Live-Ankündigungen und zeigt Quellen über einen per Tastatur bedienbaren Bereich an.

Der Loader kann außerdem Initialisierungs-, Konfigurations-, Übersetzungs- oder Chatfehler per Beacon oder Fetch an /widget-error senden. Diese Berichte enthalten begrenzte Fehlerdetails, Locale, Version sowie Seiten-Origin und -Pfad. Dafür ist der Debug-Modus nicht erforderlich. Prüfen Sie die bereitgestellte Loader-Version, bevor Sie sich auf diese Verhaltensweisen verlassen.

Der Chat liefert vollständige JSON-Antworten statt Token-Streaming. Im gehosteten Quellcode v16 erhält jede Nachricht einen Idempotenzschlüssel, der bei Transportwiederholungen wiederverwendet wird, sodass eine bereits verarbeitete Antwort erneut ausgegeben werden kann, ohne die Nachricht ein zweites Mal zu verarbeiten. Der Loader unternimmt höchstens 10 automatische Versuche bei Netzwerkfehlern, wenn der Antwortkörper trotz erfolgreicher HTTP-Antwort unterbrochen wird, bei HTTP 429, HTTP 5xx und bei HTTP-409-Antworten mit lesbarem Retry-After-Header. Er plant keinen weiteren Versuch, wenn die Verzögerung das 30-Sekunden-Budget überschreiten würde; dieses Budget ist kein festes Timeout für eine bereits laufende Anfrage. CORS kann Retry-After verbergen. Headless-sendMessage() wiederholt nicht automatisch. Prüfen Sie die bereitgestellte Loader-Version, bevor Sie sich auf diese Wiederholungen verlassen.

Der Unterhaltungsverlauf bleibt im Arbeitsspeicher der jeweiligen Widget-Instanz und geht beim Neuladen oder erneuten Initialisieren verloren; bereits auf dem Server gespeicherte Nachrichten können erhalten bleiben. Quellen werden dedupliziert und auf höchstens drei angezeigte Einträge begrenzt; Fallback-Antworten enthalten möglicherweise keine Quellen.

Wenn das Widget nach der Installation nicht erscheint, lesen Sie die Fehlerbehebung.

Für plattformspezifische Beispiele beginnen Sie mit Docusaurus, MkDocs, VitePress, WordPress oder GitBook.

Widget auf bestimmten Seiten ausblenden​

Wenn Sie das Widget nur auf ausgewählten Seiten ausblenden möchten, wenden Sie dieses CSS ausschließlich auf diesen Seiten an; global angewendet blendet es das Widget überall aus:

.chattybox-widget {
display: none;
}

Das Ausblenden per CSS stoppt weder Initialisierung noch API-Anfragen oder Fehlerberichte und ist keine Einwilligungs- oder Datenschutzkontrolle. Der Loader entscheidet nicht selbst über die Einwilligung: Fügen Sie das Script erst nach der erforderlichen Einwilligung ein und verhindern Sie nach deren Widerruf oder auf ausgeschlossenen Routen ein erneutes Einfügen.

Für clientseitige Routenwechsel oder den Widerruf der Einwilligung stellt der aktuelle Quellcode des gehosteten Loaders v16 window.ChattyBox.destroy() bereit. Das npm-SDK 0.1.4 zählt Mount-Handles als Referenzen: Rufen Sie für jedes passende Handle remove() auf, um den endgültigen Teardown auszulösen. Prüfen Sie, ob der tatsächlich bereitgestellte Loader Teardown unterstützt; nur das <script>-Element zu entfernen reicht nicht. Der Teardown entfernt die eigene UI und Styles und bricht ausstehende Arbeiten ab, kann aber keine bereits vom Server verarbeiteten Anfragen rückgängig machen.

Browsersteuerung​

Im aktuellen Quellcode des gehosteten Loaders v16 ist window.ChattyBox während des Starts mit status: 'loading' und destroy() verfügbar. Prüfen Sie nach erfolgreicher Initialisierung window.ChattyBox?.status === 'ready', bevor Sie open(), close(), toggle() oder sendMessage(text) aufrufen. destroy() entfernt das eigene Widget und dessen Styles, bricht laufende Arbeiten ab und löscht die globale Variable; bereits vom Server verarbeitete Anfragen kann es nicht rückgängig machen. close() schließt nur das Chatfenster, der Öffnen-Button bleibt sichtbar. sendMessage(text) gibt ein Promise für eine UI-Operation zurück, nicht für die Antwort; während eine andere Nachricht verarbeitet wird, werden weitere Sendungen ignoriert. Diese globale Variable ist von den SDK-Konstruktoren unter window.ChattyboxSDK getrennt. Prüfen Sie den tatsächlich bereitgestellten Loader, bevor Sie sich auf dieses Verhalten verlassen.

Helle und dunkle, von der Website gesteuerte Designs (aktueller Quellcode)​

Der Config-as-Code-Workflow im aktuellen Quellcode unterstützt optionale Paletten unter widget.theme.light und widget.theme.dark. Jede Palette akzeptiert primaryColor, backgroundColor und textColor als sechsstellige Hex-Farben; nicht angegebene Farben übernehmen die Werte aus widget.theme. Bestehende Konfigurationen mit nur einem Design funktionieren weiterhin unverändert. Dafür sind das CLI und Backend aus dem aktuellen Quellcode sowie der gehostete Loader v16 erforderlich; das veröffentlichte CLI/die Konfiguration 0.3.1 akzeptiert diese neuen Felder noch nicht. Gehen Sie nicht davon aus, dass der bereitgestellte Loader v16 ist.

Setzen Sie vor dem Ausführen des Loader-Scripts data-theme="light" oder data-theme="dark", um die anfängliche Palette auszuwählen. Verbinden Sie anschließend den Schalter Ihrer Website mit der Browser-API:

window.ChattyBox?.setTheme('light');
window.ChattyBox?.setTheme('dark');
window.ChattyBox?.setTheme(null); // Restore the configured base appearance.

Das Widget aktualisiert seine vorhandenen Styles, ohne Nachrichten, Quellen, Entwurfstext oder eine laufende Anfrage zurückzusetzen. Die Themenauswahl kann das Widget weder aktivieren/deaktivieren noch die Markenangabe entfernen. Ihre Website ist für das Speichern der Präferenz und das Verhalten des Betriebssystemdesigns zuständig; das Widget wählt lediglich die konfigurierte Palette aus.

Benutzerdefinierte Integrationen​

Benötigen Sie eine individuellere Einrichtung als mit dem gehosteten Widget? Erstellen Sie mit dem JavaScript-SDK Ihre eigene Oberfläche oder wenden Sie sich für Architekturhilfe an support@chattybox.ai.

Mehrsprachige Unterstützung​

Das Widget im aktuellen Quellcode löst die UI-Locale gemäß dem festen oder automatischen Modus des Projekts auf. Der gehostete Loader v16 beobachtet Änderungen an <html lang> und am data-locale-Attribut des Loader-Scripts und aktualisiert die Labels, ohne Unterhaltung, Entwurf oder ausstehenden Retry zurückzusetzen. Ein Routenwechsel allein wählt keine Sprache aus; aktualisieren Sie bei Bedarf eines dieser Attribute. Änderungen an Dashboard-Einstellungen erfordern weiterhin eine Neuinitialisierung. Prüfen Sie den tatsächlich bereitgestellten Loader, bevor Sie sich auf dieses Verhalten verlassen.

Offiziell unterstützte Sprachen​

Das Widget besitzt Übersetzungskataloge für 14 Sprachen, alle mit Schreibrichtung von links nach rechts. Die Kataloge übersetzen produktspezifische UI-Labels, nicht projektverfasste Texte oder KI-generierte Antworten. Schlägt der Übersetzungsabruf nach erfolgreichem Konfigurationsabruf fehl, bleiben die integrierten englischen Labels erhalten.

SpracheCode
Englischen
Französischfr
Deutschde
Spanisches
Italienischit
Niederländischnl
Portugiesischpt
Polnischpl
Schwedischsv
Indonesischid
Estnischet
Finnischfi
Walisischcy
Tschechischcs

:::note UI-Sprache und Antworten Im aktuellen Quellcode sendet der gehostete Loader die aufgelöste UI-Locale mit Chat-Anfragen. Das Backend erkennt die Sprache der Frage und versucht, Abruf und Generierung daran auszurichten. Ein erkanntes Signal für die Fragesprache hat bei produktseitigen Fallback-Nachrichten Vorrang vor der UI-Locale; ist die Erkennung nicht eindeutig oder stützt sie sich allein auf die ASCII-Englisch-Heuristik, kann die UI-Locale deren Sprache bestimmen. Ein vom Projekt konfigurierter Fallback wird unverändert ausgegeben; die Locale übersetzt keine KI-generierten Antworten. Antwortqualität und verfügbare Sprachen hängen von indexierten Inhalten und dem konfigurierten Modell ab. Prüfen Sie die bereitgestellte Loader-Version, bevor Sie sich auf das Verhalten von v16 verlassen. :::

So funktioniert die Spracherkennung​

Das Widget verwendet ein Kaskadensystem zur Erkennung:

  1. Erlaubter Script-Override – ein unterstütztes data-locale hat Vorrang, sofern allowLocaleOverride nicht false ist, auch im festen Modus.
  2. Fester Modus – ohne einen erlaubten, unterstützten Override wird defaultLocale verwendet; Seiten- und Browsersprache werden ignoriert.
  3. Auto-Modus – nacheinander <html lang>, navigator.language, jeden Eintrag in navigator.languages, das ältere userLanguage und schließlich defaultLocale prüfen; ausgewählt wird die erste unterstützte Sprache.
  4. Normalisierung – Groß-/Kleinschreibung wird ignoriert, und erkannte regionale Varianten wie fr-CA werden auf die unterstützte Basissprache zurückgeführt. Nicht unterstützte Kandidaten werden übersprungen; ist keiner davon unterstützt, wird Englisch verwendet. Die Standardwerte sind der automatische Modus, Englisch und erlaubte Script-Overrides.

Vom Projekt festgelegte Header-Titel und Willkommensnachrichten werden unverändert angezeigt und nicht automatisch übersetzt. Nur die im aktuellen Quellcode vorgesehenen Standardtitel und Standard-Willkommensnachrichten werden lokalisiert angezeigt. Können Übersetzungen nicht geladen werden, bleiben die integrierten englischen Labels erhalten.

Sprache manuell überschreiben​

Um eine bestimmte Sprache anzufordern, aktivieren Sie zuerst Script-Überschreibung erlauben und setzen dann ein unterstütztes data-locale am Loader-Script:

<script
src="https://chattybox.ai/widget.js"
data-api-key="YOUR_API_KEY"
data-locale="de"
data-api-url="https://adorable-woodpecker-629.convex.site/chat"
async
></script>

:::tip Anwendungsfall Das ist besonders nützlich für mehrsprachige Websites, bei denen jede Sprachversion eine eigene URL hat (z. B. /de/, /fr/). Setzen Sie data-locale passend zur Seitensprache und prüfen Sie die gerenderte Oberfläche. :::

Spracheinstellungen im Dashboard​

Im App-Dashboard können Sie die Spracheinstellungen des Widgets pro Projekt konfigurieren:

  • Automatisch erkennen – nutzt zuerst die Seitensprache, dann die Browsersprache.
  • Festgelegt – nutzt die konfigurierte Standardsprache, sofern kein zulässiger Script-Override vorhanden ist.
  • Script-Überschreibung erlauben – aktiviert oder deaktiviert das Überschreiben über das Attribut data-locale.

Sie finden diese Einstellungen in Ihrem Dashboard → Projekt → Anpassen → Erscheinungsbild → Sprache. Prüfen Sie den Status der automatischen Speicherung und beheben Sie Fehler, bevor Sie das Widget testen.

Sprache der Inhalte abgleichen​

Indexieren Sie für ein nützliches mehrsprachiges Erlebnis öffentliche Inhalte in den Sprachen Ihrer Besucher und prüfen Sie die Quellen: Erkennung und Retrieval sind nicht garantiert. Gehen Sie dazu wie folgt vor:

  1. Scrapen Sie alle Sprachversionen Ihrer Dokumentation mithilfe der Datei sitemap.xml.
  2. Der Scraper versucht, die Sprache zu erkennen; prüfen Sie Inhalte und Quellen statt ein exaktes Ergebnis anzunehmen.
  3. Retrieval versucht die erkannte Fragesprache zu bevorzugen, kann aber auf andere indexierte Inhalte zurückfallen.

Einrichtung im App-Dashboard: Verwenden Sie beim Konfigurieren des Scrapings Ihre sitemap.xml-URL (z. B. https://yourdocs.com/sitemap.xml), um Sprachversionen zu entdecken, und prüfen Sie anschließend die indexierten Seiten. Sitemaps umgehen weder Crawl-Limits noch Ausschlüsse.

Fehlerbehebung​

Widget wird weiterhin auf Englisch angezeigt​

  • Hard Refresh als Diagnose – Laden Sie die Seite mit Ctrl+F5 oder Cmd+Shift+R neu und prüfen Sie anschließend im Netzwerkbereich des Browsers die Widget- und Übersetzungsanfragen.
  • data-locale prüfen – Überprüfen Sie, ob das Attribut mit einem unterstützten Sprachcode korrekt gesetzt ist.
  • Projektmodus und Override-Berechtigung prüfen – Im festen Modus und bei deaktivierten Overrides können Browser-Sprache oder data-locale absichtlich ignoriert werden.
  • Browsersprache überprüfen – Stellen Sie sicher, dass die bevorzugte Sprache Ihres Browsers korrekt eingestellt ist.
  • lang im Seiten-HTML prüfen – Stellen Sie sicher, dass Ihre Seite <html lang="de"> (oder den passenden Code) enthält.

Quellen sind in der falschen Sprache​

  • Inhalte erneut scrapen – Stellen Sie sicher, dass alle Sprachversionen indexiert sind.
  • sitemap.xml verwenden – Prüfen Sie, ob die gewünschten URLs tatsächlich indexiert wurden; Crawl-Limits und Ausschlüsse können sie auslassen.
  • Anfragesprache prüfen – Die KI versucht, die Antwortsprache an die Sprache der Anfrage anzupassen.

Übersetzungen fehlen​

  • Unterstützte Sprachen und Anfragen prüfen – Nur die oben aufgeführten 14 Codes haben Kataloge. Schlägt der Katalogabruf nach dem erfolgreichen Konfigurationsabruf fehl, werden integrierte englische Labels verwendet; schlägt der Konfigurationsabruf fehl, bleibt das Widget nicht verfügbar.

Best Practices​

  1. <html lang> auf Ihren Seiten setzen – Hilft bei Barrierefreiheit und Widget-Erkennung.
  2. Während der Entwicklung mit data-locale testen – Überprüfen Sie, ob jede Sprache korrekt dargestellt wird.
  3. Alle Sprachversionen scrapen – Verwenden Sie sitemap.xml zur Entdeckung und prüfen Sie die indexierten Seiten.
  4. Echte Fragen prüfen – Prüfen Sie Konversationen auf sprachspezifische Inhaltslücken. Das Dashboard bietet keinen Bericht zur Verteilung der Widget-Locales.