Übersetzungen konfigurieren

Auf dem Tab Translations können Sie jeden Text in der Oberfläche des Assistenten lokalisieren – Button-Beschriftungen, den Platzhalter, die Begrüßungsnachricht, Fehlerzustände, Formulartexte –, damit Besucher den Assistenten in ihrer eigenen Sprache sehen.

Integrierte Sprachen

Der Assistent bringt Englisch (EN), Spanisch (ES) und Katalanisch (CA) bereits mit. Er erkennt die Browsersprache des Besuchers (über navigator.language) und wählt automatisch die passendste. Wird keine Übereinstimmung gefunden, wird Englisch verwendet.

Eine neue Sprache hinzufügen

Öffnen Sie die Settings des Assistenten und den Tab Translations.
Wählen Sie Add language und geben Sie den Sprachcode ein (z. B. FR für Französisch, DE für Deutsch, PT für Portugiesisch).
Füllen Sie die Oberflächentexte aus – jeder Schlüssel (etwa ask, welcome, placeholder) hat ein Feld für Ihre Übersetzung.
Speichern Sie.

Ihre Übersetzungen überschreiben die integrierten, sodass Sie auch den englischen Text anpassen können – zum Beispiel den Senden-Button von „Ask“ in „Send“ ändern oder den Platzhalter von „Ask a question“ in etwas, das zu Ihrer Marke passt.

Übersetzungsschlüssel

Jeder Text der Oberfläche wird über einen Schlüssel referenziert. Hier ist die vollständige Liste der integrierten Schlüssel, ihr englischer Standardwert und wo sie im Assistenten erscheinen:

Kerninteraktion:

Schlüssel	Standard (EN)	Wo er erscheint
`placeholder`	"Ask a question"	Der graue Hinweis im Eingabefeld.
`ask`	"Ask"	Die Beschriftung des Senden-Buttons.
`search`	"Search"	Die Beschriftung der Suchaktion (Overlay-Modus).
`searching`	"Searching..."	Wird angezeigt, während der Assistent eine Antwort erzeugt.
`noResults`	"Sorry, I couldn't find what you're looking for."	Wird angezeigt, wenn der Assistent keine passenden Inhalte findet.
`sorry`	"Sorry, we are unable to answer at this moment."	Wird bei einem unerwarteten Fehler angezeigt.

Begrüßung und Identität:

Schlüssel	Standard (EN)	Wo er erscheint
`welcome`	(leer – verwendet die Begrüßungsnachricht aus den General-Einstellungen)	Die Begrüßung, die beim Öffnen des Chats angezeigt wird.
`description`	(leer – verwendet die Beschreibung aus den General-Einstellungen)	Der Untertitel unter dem Titel des Assistenten.

Referenzen und Reaktionen:

Schlüssel	Standard (EN)	Wo er erscheint
`references`	"Sources"	Die Überschrift über den Referenzkarten in einer Antwort.
`copy`	"Copy"	Tooltip des Buttons zum Kopieren in die Zwischenablage.
`copied`	"Copied to clipboard"	Bestätigung nach dem Kopieren.
`like`	"Like"	Tooltip des Reaktionsbuttons Daumen hoch.
`dislike`	"Dislike"	Tooltip des Reaktionsbuttons Daumen runter.

Fenstersteuerung:

Schlüssel	Standard (EN)	Wo er erscheint
`close`	"Close"	Tooltip des Schließen-Buttons.
`expand`	"Expand"	Tooltip des Ausklappen-Buttons.
`collapse`	"Collapse"	Tooltip des Einklappen-Buttons.
`clear`	"Clear conversation"	Tooltip des Buttons zum Löschen des Verlaufs.

Formulare:

Schlüssel	Standard (EN)	Wo er erscheint
`showForm`	"Open form"	Der Button, der ein Formular zur Lead-Erfassung öffnet.
`submitForm`	"Submit"	Der Absenden-Button des Formulars.
`formSubmitted`	"Your form has been submitted."	Bestätigung nach dem Absenden eines Formulars.

Anhänge:

Schlüssel	Standard (EN)	Wo er erscheint
`attachFile`	"Attach file"	Tooltip des Buttons zum Anhängen von Dateien.
`attachedFile`	"Attached file:"	Beschriftung neben einer angehängten Datei.
`removeAttachment`	"Remove attachment"	Button zum Entfernen eines vorgemerkten Anhangs.
`processingAttachment`	"Processing attachment..."	Wird angezeigt, während eine Datei verarbeitet wird.

Footer:

Schlüssel	Standard (EN)	Wo er erscheint
`poweredBy`	"Powered by"	Der Herkunftshinweis im Footer.
`contactUs`	"Contact us"	Die Kontaktaktion im Footer.

Wie Übersetzungen in Templates funktionieren

In den Liquid-Templates des Assistenten wird jeder übersetzbare Text mit dem Filter t referenziert:

{{ 'key' | t: 'Fallback text' }}

Der Filter sucht den Schlüssel in der Sprache des Besuchers. Gibt es eine Übersetzung, wird sie verwendet; andernfalls wird stattdessen der Fallback-Text (der zweite Parameter) angezeigt.

Zum Beispiel im Template der Suchleiste:

<textarea placeholder="{{ 'placeholder' | t: 'Ask a question' }}"></textarea>
<button>{{ 'ask' | t: 'Ask' }}</button>

Und im Antwort-Template die Überschrift der Quellen und die Reaktionsbuttons:

<span>{{ 'references' | t: 'Sources' }}</span>
<button title="{{ 'like' | t: 'Like' }}">...</button>
<button title="{{ 'dislike' | t: 'Dislike' }}">...</button>

Eigene Übersetzungsschlüssel

Sie können über die integrierte Liste hinaus eigene Schlüssel hinzufügen. Wenn Sie im Tab Translations einen Schlüssel namens customGreeting anlegen, können Sie ihn in einer Template-Überschreibung referenzieren:

{{ 'customGreeting' | t: 'Hello!' }}

Das ist nützlich für Enterprise-Nutzer, die Templates überschreiben und in ihrem eigenen Markup übersetzbare Texte brauchen.

Tipps

Beginnen Sie mit den Texten, die Besucher am häufigsten sehen: placeholder, ask, noResults und references.
Testen Sie jede Sprache, indem Sie die Spracheinstellung Ihres Browsers ändern und die Seite neu laden.
Sie müssen nicht jeden Schlüssel übersetzen – nicht übersetzte Schlüssel greifen auf den integrierten Standard dieser Sprache oder auf Englisch zurück.
Übersetzungen betreffen die Oberfläche (Buttons, Beschriftungen, Platzhalter), nicht die Antworten – die Antwortsprache des Assistenten wird durch die Verhaltensanweisungen gesteuert.

Fehlerbehebung

Bleibt eine Beschriftung in der Standardsprache, ist ihr Übersetzungsschlüssel wahrscheinlich leer – öffnen Sie den Tab Translations und füllen Sie ihn aus.
Fügen Sie denselben Sprachcode nicht zweimal hinzu – Duplikate können zu unvorhersehbarem Verhalten führen.
Die Sprache wird anhand des Browsers des Besuchers erkannt, nicht anhand seines Standorts. Um eine Sprache zu erzwingen, legen Sie sie in der Einbettung über eine Template-Überschreibung fest.