Wenn ein Chatbot in deutscher Sprache fertig einrichtet und trainiert ist, ergibt sich bald auch der Bedarf an einer übersetzten Variante für z.B. englischsprachige Nutzer.
Kiko biete hier zwei Möglichkeiten an:
- Redaktionelle Übersetzung: alle Inhalte und Trainingsdaten sind für die Sprachvariante zu übersetzen und vom Redakteur neu einzupflegen
- Automatische Übersetzung: alle Nutzereingaben und Bot-Ausgaben werden live mit einem Webservice übersetzt (aktuell www.deepl.com)
In dieser Anleitung erfahren Sie, wie Sie die automatische Übersetzung einer neuen Nutzersprache in wenigen Schritten einrichten können (Variante 2)..
Integrationskonzept
Sie benötigen
- eine Webseite, in welcher der Chatbot in neuer Sprache eingebunden werden soll,
- einen bestehenden Kiko Chatbot - https://www.kiko.bot/kostenlos-registrieren-chatbot-cms/ und
- den Webservice "Kiko Translate"
- einen vom Support freigegebenen Kiko API-Key (legen Sie dazu eine Anfrage im Ticketsystem an, wir senden Ihnen einen individuellen Key zu)
Bevor der Webservice “Kiko Translate” genutzt werden kann, ist er für das Kiko-Konto zu aktivieren. Diese Einrichtung können Sie mittels Kiko-CMS-Assistent erledigen:
Loggen Sie sich dafür in Ihrem Kiko-Konto als Admin ein. Klicken Sie unten rechts auf das Widget für den CMS-Assistenten, links neben dem Widget für den Testchat.
Führen Sie folgende Eingaben durch:
- ~kiko-webservices
- Einstellungen -> Service-Verwaltung
- "Kiko Translate" aktivieren (falls deaktiviert)
Der Webservice ist nun aktiviert.
Zur Nutzung benötigen Sie weiterhin den Webservice-API-Key für Ihr Kiko-Konto. Führen Sie dafür folgende Eingaben mittels Kiko-CMS-Assistent durch:
- ~kiko-webservices
- Einstellungen -> Webservice API Key
- Ausgabe: Kiko Webservice API Key für das aktuelle Konto: 1234abcd-ws
Merken Sie sich den API-Key.
Um alle Nachrichten zum und vom bestehenden Chatbot zu übersetzen, wird ein Übersetzer-Kanal und ein Übersetzungs-Webservice (externer Subbot) eingerichtet.
Die Nutzer-Nachricht durchläuft intern folgende Schritten bis zum Bot:
- der Nutzer gibt eine Nachricht im z.B. englischen Webchat ein
- die englische Nutzer-Nachricht wird von der Webseite an den Übersetzer-Subbot gesendet
- von dort wird die Nachricht an den Übersetzer-Webservice weitergeleitet und automatisch ins Deutsche übersetzt
- der Webservice leitet die deutsche Nutzer-Nachricht an den Übersetzer-Kanal weiter
- der Übersetzer-Kanal leitet sie an den deutschsprachigen Metabot (oder an einen anderen hinterlegten Bot) zur Beantwortung
Die zugehörige Antwort durchläuft intern folgende Schritte zurück zum Nutzer:
- die deutsche Antwort wird an den Übersetzer-Kanal zurück gesendet und von dort an den Übersetzer-Webservice weitergeleitet
- die Bot-Nachricht wird automatisch vom Deutschen ins Englische übersetzt und an den Übersetzer-Subbot geleitet
- der Subbot sendet die Nachricht an den Webchat weiter.
Der Nutzer erhält also in diesem Beispiel eine englische Antwort auf die englische Frage vom deutschsprachigen Chatbot.
Einrichtungsschritte
Externer Subbot
Legen Sie einen neuen externen Subbot an z.B. mit dem Namen "translation-extern". Geben Sie als Sprache "deutsch" an und ermitteln Sie den Bot-Identifier - z.B. "xxSUBBOTxxxx-xxxx-4668-xxxx-1728930312"
Tragen sie die folgenden URLs bei den Webhooks des Subbots ein
- Konversation gestartet: https://webservice.kiko.bot/translate/v1/subbot/start-event-to-bot?apikey=xyz
- Nachricht erhalten: https://webservice.kiko.bot/translate/v1/subbot/messages-to-bot?apikey=xyz
Kanal
Legen Sie einen neuen "Custom" Kanal an z.B. mit dem Namen "translation-channel".
Tragen Sie bei Integration folgenden Code ein
Ermitteln Sie den Bot-Identifier des Metabots, mit dem Ihr deutschsprachiger Webchat verbunden ist und tragen Sie ihn bei Optionen ein
- {
- "identifier": "xxMETABOTxxxxx-xxxx-4668-xxxx-e8ed8fd62ca8"
- }
Merken Sie sich die Channel-ID z.B. "xxxCHANNELxx123".
Willkommens-Absicht
Der neue Kanal überträgt nur Nachrichten und kein Signale. Das Start-Signal zum Beginn einer Nutzer-Session simulieren Sie daher durch eine Nutzer-Nachricht vom System, die eine Willkommens-Absicht auslöst.
Dafür legen Sie eine neue Absicht im deutschsprachigen Metabot an z.B. mit dem Namen "Willkommen" und einer Erkennungsregel auf das Schlüsselwort z.B. "~willkommen".
Geben Sie weiterhin den Begrüßungstext in deutscher Sprache an.
Embed-Code für die Webseite
Mit dem Embed-Code integrieren Sie den Chatbot mit der neuen Sprache auf Ihrer Webseite.
Nutzen Sie dabei die folgenden Optionen:
- {
- "headerText": "NAME",
- "identifier":"xxSUBBOTxxxx-xxxx-4668-xxxx-1728930312",
- "lang": "en",
- "custom": {
- "lang": "EN",
- "channelId": "xxxCHANNELxx123",
- "welcomeKeyword": "~willkommen"
- },
- "useCustomGreeting": true
- }
Die erste lang-Option "en" steuert die Systemsprache des Webchats. Hier ist "de" und "en" möglich.
Die zweite lang-Option "EN" steuert die Nutzersprache. Hier sind neben "EN" auch weitere Sprach-Kennungen möglich, siehe unten.
Übersetzungssteuerung
Von den Messages werden nur die Inhalte - nicht die internen System-Namen (z.B. Button-Namen oder Urls in HTML-Links) übersetzt.
Die Hin- und Rück-Übersetzung eines Button-Wertes kann vom Original etwas abweichen, wenn der Button geklickt wurde. Pflegen Sie diese abweichende (deutsche) Übersetzungsvariante am besten als Synonym zum ursprünglichen Entitätswert.
Alternativ können Sie auch wie folgt verfahren: Um ein Schlüsselwort (z.B. Button-Wert) von der Übersetzung auszuschließen, ist es mit Tilde "~" anzulegen und zu nutzen - z.B. "~willkommen"
Mit diesen wenigen Anpassungen können Sie schnell eine zusätzliche Nutzersprache zu Ihrem Chatbot hinzufügen. Eine doppelte Pflege der Inhalte ist damit nicht nötig.
Referenzen
- Kostenlos registrieren - https://www.kiko.bot/kostenlos-registrieren-chatbot-cms/
- Webservice Kiko Translate, API-Referenz - https://webservice.kiko.bot/docs/#tag/translate
- Deepl, mögliche Sprachen - https://www.deepl.com/docs-api/translating-text/request/
- Handbuch, Kanal - https://cloud02-7c83ec0.prod.1000grad.de/chat/docs/#/channels
- Handbuch, Embed-Code: https://cloud02-7c83ec0.prod.1000grad.de/chat/docs/#/quickstart?id=web-chat-in-eine-anwendung-einbinden