Lokalisierung und Sprachen

Nutzer kommunizieren von vielen Orten aus und in vielen verschiedenen Sprachen. Agents, die auf die Kommunikationseinstellungen von Nutzern reagieren und ihre Angebote lokalisieren, sorgen für mehr Nutzer, sorgen für zufriedenere Nutzer und sorgen für mehr wiederholte Interaktionen als Agents, die nicht reagieren. Mit Business Messages können Agents und Standorte auf die Einstellungen der Nutzer reagieren. Dazu werden die Einstellungen für das Gebietsschema an die Agents übergeben, die Agents können die Standardsprache und die eindeutigen Konversationseinstellungen pro Sprache angeben und Übereinstimmungen zwischen den Sprachen des Nutzers und den vom Agent oder dem Standort unterstützten Sprachen auflösen.

Durch die Erkennung des Gebietsschemas können Business Messages-Agents ihre Erfahrung lokalisieren, indem sie automatisierte und Live-Agent-Interaktionen mit der Region und Sprachsprache der Nutzer erfassen.

Sprache des Nutzers

Wenn ein Nutzer eine Unterhaltung mit einem Agent beginnt und ein Nutzer eine Nachricht sendet, erkennt Business Messages die Spracheinstellungen des Nutzergeräts. Jeder Nachrichten-Agent enthält die Sprache des Nutzers im Feld context.userInfo.userDeviceLocale.

Business Messages verwendet die Sprache des Nutzergeräts, um die Sprache der Benutzeroberfläche und die Sprache der von der Plattform generierten Strings zu ändern.

userDeviceLocale kann innerhalb einer Unterhaltung geändert werden, wenn der Nutzer die Sprache des Geräts ändert oder zwischen Geräten mit unterschiedlichen Spracheinstellungen wechselt. Wenn Agents userDeviceLocale lesen, sollten sie bei jeder neuen Nachricht prüfen, ob sich der Wert geändert hat, und ggf. Anpassungen vornehmen. Ein Agent kann beispielsweise eine Änderung an der Sprache erkennen und den Nutzer fragen, ob er weiterhin in der aktuellen Sprache kommunizieren oder zu einer Sprache wechseln möchte, die zur neuen Sprache passt.

userDeviceLocale wird vom Gerät des Nutzers angegeben und kann ein beliebiges IETF BCP 47-Sprach-Tag sein.

Agent und Standortsprache

Agents und Standorte können Unterhaltungseinstellungen für die von ihnen unterstützten Sprachen angeben. Ein Agent kann beispielsweise eine Willkommensnachricht auf Englisch für die Sprache "en" angeben und dieselbe Nachricht auf Spanisch für die Sprache "es" verwenden. Es kann aber auch sein, dass an einem Standort Einstellungen für die Sprache "fr" angegeben sind, an einem anderen jedoch nicht.

Wenn für einen Agent oder Standort Kommunikationseinstellungen für eine Sprache festgelegt wurden, wird in Business Messages davon ausgegangen, dass der Agent oder der Standort diese Sprache unterstützt. Agents und Standorte können eine Standardsprache (defaultLocale) festlegen, in der sie normalerweise kommunizieren.

Informationen zum Aktualisieren der Standardsprache eines Agents oder Standorts finden Sie unter Standardsprache aktualisieren. Informationen zum Festlegen von Konversationseinstellungen für eine Sprache finden Sie unter Unterhaltung starten.

Problem behoben

Durch die Identifizierung der Sprache auf dem Nutzergerät und durch den Vergleich dieser Sprache mit den für den Agent angegebenen Sprachen oder dem Standort, an dem die Nutzernachrichten gesendet werden, kann Business Messages eine Übereinstimmung zwischen den Sprachen des Nutzers und des Agents feststellen. Die defaultLocale eines Agents oder Standorts hat Vorrang vor anderen unterstützten Sprachen, wenn Business Messages eine Übereinstimmung löst. Jeder Nachrichten-Agent erhält diese Übereinstimmung im Feld context.resolvedLocale.

Business Messages verwendet das aufgelöste Gebietsschema, um auszuwählen, welche Konversationseinstellungen (z. B. Willkommensnachrichten und Offlinenachrichten) und Strings (z. B. der Live-Agent-Anfragevorschlag) angezeigt werden sollen. Es empfiehlt sich, Agents in der aufgelösten Sprache zu kommunizieren, um eine einheitliche Nutzererfahrung zu gewährleisten.

Das aufgelöste Gebietsschema kann sich innerhalb einer Unterhaltung ändern, wenn der Nutzer die Sprache des Geräts ändert oder zwischen Geräten mit unterschiedlichen Spracheinstellungen wechselt. Agents sollten prüfen, ob sich der Wert mit jeder neuen Nachricht geändert hat, und sie gegebenenfalls anpassen. Ein Agent kann beispielsweise eine Änderung an der Sprache erkennen und den Nutzer fragen, ob er weiterhin mit der aktuellen Sprache kommunizieren oder zu einer Sprache wechseln möchte, die zur neuen Sprache passt.

Standardsprache aktualisieren

Wenn Sie eine Standardsprache festlegen möchten, senden Sie eine PATCH-Anfrage mit der Business Communications API, um das Feld defaultLocale eines Agents oder Standorts zu aktualisieren.

Informationen zum Aktualisieren der Unterhaltungseinstellungen eines Agents oder Standorts für eine Sprache, z. B. Begrüßungsnachricht und Unterhaltungsbeginn, finden Sie unter Unterhaltung starten.

Vorbereitung

Bevor Sie die Standardsprache aktualisieren, benötigen Sie Folgendes:

  • Pfad zum Dienstkontoschlüssel Ihres GCP-Projekts auf Ihrem Entwicklungscomputer

  • Für die Standardsprache des Agents name, z. B. „brands/12345/agents/67890“

    Wenn Sie die name des Agents nicht kennen, lesen Sie Alle Agents für eine Marke auflisten.

  • Für die standardmäßige Sprache des Standorts der Standort name, z. B. „brands/12345/locations/67890“

    Wenn Sie die name des Standorts nicht kennen, lesen Sie den Hilfeartikel Alle Standorte für eine Marke auflisten.

  • Die Sprache, die standardmäßig festgelegt werden soll, als zweistelliger ISO 639-1-Sprachcode

  • Sprachspezifische Gesprächseinstellungen für den Agent oder den Standort Weitere Informationen finden Sie unter Unterhaltung starten.

Aktualisierungsanfrage senden

Führen Sie den folgenden Befehl aus, um den Agent oder den Standort zu aktualisieren. Ersetzen Sie Variablen durch die in Voraussetzungen angegebenen Werte.

Standardsprache des Agents 


# This code sets the default locale of a Business Messages agent.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands.agents/patch

# Replace the __BRAND_ID__, __AGENT_ID__ and __DEFAULT_LOCALE__
# Make sure a service account key file exists at ./service_account_key.json

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/agents/__AGENT_ID__?updateMask=businessMessagesAgent.defaultLocale" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "businessMessagesAgent": {
    "defaultLocale": "__DEFAULT_LOCALE__"
  }
}'
update-agent-bm-defaultLocale.sh

Informationen zu Formatierungs- und Wertoptionen finden Sie unter BusinessMessagesAgent.

Standardsprache des Standorts 


# This code updates the default locale of an agent.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands.locations/patch

# Replace the __BRAND_ID__ and __LOCATION_ID__
# Make sure a service account key file exists at ./service_account_key.json

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/locations/__LOCATION_ID__?updateMask=defaultLocale" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "defaultLocale": "en"
}'
update-location-bm-defaultLocale.sh

Informationen zu Formatierungs- und Wertoptionen finden Sie unter brands.locations.