Texte und Sprachen

Das Widget spricht Deutsch, Englisch und Polnisch. Jeder seiner rund 200 Texte lässt sich ersetzen: im Konto für alle Seiten oder per Code für einzelne Seiten.

Wie das Widget die Sprache wählt

Das Widget sitzt in deiner Seite. Was der Besucher gerade liest, zählt deshalb mehr als die Einstellung seines Browsers. Die Reihenfolge:

1. Eine Sprache, die deine Seite per ReactiveChat('setLocale', …) für diesen Besucher gewählt hat (siehe unten).
2. Eine feste Sprache am Schnipsel (data-rc-locale) oder in der Konfiguration.
3. Sonst die Sprache deiner Seite aus <html lang="…">.
4. Sonst die Vorgabesprache aus dem Konto.
5. Sonst die Sprache des Browsers, zuletzt Englisch.

Regionale Angaben werden gekürzt: de-AT wird zu de. Eine Sprache, die das Widget nicht kennt, wird zu Englisch.

Am wichtigsten ist also ein korrektes <html lang> auf deinen Seiten. Dann folgt das Widget jeder Sprachfassung deiner Website von selbst.

Die Vorgabesprache im Konto

Unter /app/projects/{id} im Reiter Einbau, Abschnitt Grunddaten, wählst du die Vorgabesprache: de, en oder pl. Sie hat zwei Aufgaben:

• Sie gilt für Besucher auf Seiten ohne <html lang>, wenn der Schnipsel keine Sprache festlegt.
• In ihr schreibst du deine eigenen Texte, die Startseite und die Werbekarte (siehe unten).

Sprache per Code festlegen

Fest für eine Seite, am Schnipsel:

<script src="https://cdn.reactive.chat/loader.js"
        data-rc-site-key="SITE_KEY"
        data-rc-locale="pl"
        async></script>

Zur Laufzeit, etwa aus deinem eigenen Sprachumschalter:

ReactiveChat('setLocale', 'en');

setLocale beschriftet das Widget sofort neu. Die Wahl merkt sich das Widget ein Jahr lang im Browser des Besuchers, und sie hat dann auch auf anderen Seiten Vorrang vor data-rc-locale. Eine Sprachauswahl im Widget selbst gibt es nicht. Wenn deine Besucher wählen sollen, rufst du setLocale aus deinem Umschalter auf.

Eigene Texte im Konto

Im Reiter Texte & Formulare, Abschnitt Eigene Texte, steht jeder Text des Widgets mit seinem Schlüssel, gruppiert nach Bereich und zugeklappt. Im Feld steht grau unser Text. Was du einträgst, ersetzt ihn. Die Überschrift zeigt, wie viele eigene Texte du schon hast.

• Höchstens 400 Zeichen je Text.
• Leer lassen heißt: unser Text.
• Ein Text, der genau unserem entspricht, wird nicht gespeichert.
• Platzhalter in geschweiften Klammern wie {n}, {name} oder {time} füllt das Widget aus. Lass sie in deinem Text stehen, wenn du die Angabe zeigen willst.

Wichtig zur Sprache: Du tippst die Texte in der Vorgabesprache des Projekts, und dort wirken sie. Besucher, deren Widget in einer anderen Sprache läuft, sehen dort weiterhin unsere mitgelieferten Texte. Für eigene Texte in weiteren Sprachen nimm den Weg per Code (unten), am besten auf den Seiten der jeweiligen Sprachfassung.

Änderungen kommen innerhalb einer Minute bei deinen Besuchern an.

Die wichtigsten Schlüssel

Ein Auszug, nach Bereich:

• launcher.text, launcher.subtext – Beschriftung und Unterzeile des Starters. Ab Werk leer, ein Eintrag hat Vorrang vor den Feldern unter Aussehen → Marke.
• launcher.label – die Vorlesebeschriftung des Starters für Screenreader („Chat öffnen“).
• header.title, header.subtitle_online, header.subtitle_bot, header.response_time – Titel und Unterzeilen im Kopf.
• home.greeting, home.sub, home.start, home.start_sub – Begrüßung und Einstieg auf der Startseite (die Begrüßung stellst du bequemer unter Startseite ein).
• tabs.home, tabs.messages, tabs.help – die Reiter.
• input.placeholder und weitere input.* – das Eingabefeld.
• offline.* – das Formular „Nachricht hinterlassen“.
• prechat.* – das Vorab-Formular.
• bh.* – Hinweise zu Geschäftszeiten.
• ds.* und daten.* – Einwilligung und die Datenkarte „Ihre Daten“.
• msg.ki_notice – der Hinweis vor der ersten Antwort des KI-Assistenten.
• csat.* – die Bewertung nach dem Gespräch.
• transcript.*, upload.*, handoff.*, queue.*, teaser.*, err.* – Verlauf per E-Mail, Anhänge, Übergabe an das Team, Warteschlange, Tooltip-Blase und Fehlermeldungen.

Die vollständige Liste siehst du im Konto.

Nicht über Texte änderbar sind der Hinweis „Powered by reactive.chat“ (siehe Chatfenster) und die Texte der Produkt-Touren (siehe Produkt-Touren).

Texte per Code ersetzen

Am Schnipsel mit data-rc-strings als JSON, Schlüssel in Punktschreibweise:

<script src="https://cdn.reactive.chat/loader.js"
        data-rc-site-key="SITE_KEY"
        data-rc-locale="de"
        data-rc-strings='{"input.placeholder":"Deine Frage zur Bestellung …","header.title":"Kundenservice"}'
        async></script>

Oder in der Konfiguration:

ReactiveChat('boot', {
  strings: { 'input.placeholder': 'Deine Frage zur Bestellung …' }
});

Ein zweiter boot-Aufruf auf derselben Seite zieht neue strings nach. So kannst du Texte etwa nach dem Login ändern.

Texte per Code gelten in jeder Sprache gleich. Setze sie deshalb auf Seiten, deren Sprache feststeht, und lege dort die Sprache gleich mit fest.

Rangfolge, von stark nach schwach:

1. Texte per Code (strings) – sie gelten nur für die Seite, auf der sie stehen.
2. Eigene Texte aus dem Konto, in der Vorgabesprache.
3. Unsere mitgelieferten Texte in der Sprache des Besuchers.
4. Englisch.

Der Code gewinnt mit Absicht: Wer eine einzelne Seite anders beschriften will, tut das dort, ohne die Einstellung für alle anderen Seiten zu ändern.

Weitere Texte an anderer Stelle

Manche Texte haben ein eigenes Feld, oft je Sprache:

• Begrüßung, Kacheln und Startseite: Startseite des Chats
• Satz über dem Vorab-Formular (je Sprache): Erreichbarkeit, Formulare und Service
• Einwilligungssatz und Link zur Datenschutzerklärung (je Sprache): Datenschutz und Einwilligung
• Texte von Tooltips und proaktiven Nachrichten: Proaktive Ansprache
• Name und Ton des KI-Assistenten: KI-Assistent
• Werbekarte, auch je Sprache per Code: Die Werbekarte im Chat