Locale-API: ein Widget, vier Sprachen

Schweizer Support heisst Deutsch, Französisch, Italienisch, und Englisch sowieso. Das Widget zieht mit einer Zeile mit:

zE('messenger:set', 'locale', 'fr'); // de, fr, it, en …

Der Wechsel passiert live, ohne Neuladen. Platzhalter, Buttons, Systemtexte und die Datenschutz-Banner stellen sofort um. Die Übersetzungen liefert Zendesk mit.

Was die API kann, und was nicht

Sofort umgestellt: alle Oberflächen-Texte des Widgets.
Nicht automatisch übersetzt: Bot-Antworten und Nachrichten deines Teams. Die kommen aus der Bot-Konfiguration beziehungsweise vom Menschen. Ein mehrsprachiger AI Agent ist eigene Handwerksarbeit. Im Referenzprojekt liefen sieben Agenten in vier Sprachen.
Im Admin Center müssen die Widget-Sprachen aktiviert sein, sonst fällt die Locale auf den Standard zurück.

📸 Screenshot noch einzufügen Account → Appearance → Localization mit vier aktiven Sprachen (DE/FR/IT/EN). public/werkstatt/bauplaene/sprachen/admin-account-languages.png

Hier aktivierst du die Sprachen, die der Bot überhaupt sprechen darf.

Der richtige Einbau: am Sprach-Umschalter der Website

Im echten Einbau ist der Locale-Aufruf kein eigener Knopf, sondern hängt am Sprachwechsel der Seite:

function setzeSprache(locale) {
  document.documentElement.lang = locale;
  zE('messenger:set', 'locale', locale);
  // … Rest des Sprachwechsels der Website
}

Wer auf Français wechselt, bekommt auch den Support auf Französisch, ohne dass es jemand extra einstellen muss. Beim initialen Laden gilt: Locale vor dem Rendern setzen, dann startet das Widget gleich in der richtigen Sprache.

← Zurück zur Demo