Lokalisierung und Sprachen

<ph type="x-smartling-placeholder">

Nutzer kommunizieren von vielen Standorten aus und in vielen Sprachen. Agents, die die auf die Anforderungen der Nutzenden Kommunikationspräferenzen zu kommunizieren und ihre Erfahrungen lokalisieren mehr Nutzer zu erreichen, ansprechendere Nutzererfahrungen zu schaffen und mehr als mit Kundenservicemitarbeitern, die nicht reagieren. Business Messages können Kundenservicemitarbeiter und Standorte auf die Anforderungen der Nutzer reagieren Einstellungen festlegen, indem Sie Spracheinstellungen des Nutzers für Agents festlegen, damit Agents eine Standardsprache und eindeutige Einstellungen für Unterhaltungen pro Sprache und das Auflösen von Übereinstimmungen zwischen den Sprachen und die von einem Agent oder Standort unterstützten Sprachen.

Durch die Erkennung des Gebietsschemas können Business Messages-Kundenservicemitarbeiter ihre Aktivitäten lokalisieren, indem sie Automatisierte und Live-Kundenservicemitarbeiter informieren Nutzer über Region und Spracheinstellungen.

Nutzersprache

Wenn ein Nutzer eine Unterhaltung mit einem Agent beginnt und jedes Mal, wenn ein Nutzer eine erkennt Business Messages die Spracheinstellungen des Nutzergeräts. Jedes enthält die Sprache des Nutzers in der context.userInfo.userDeviceLocale ein.

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

userDeviceLocale kann sich innerhalb einer Unterhaltung ändern, wenn der Nutzer die die Sprache des Geräts verwendet oder zwischen Geräten mit einer anderen Sprache gewechselt wird. Einstellungen. Wenn Kundenservicemitarbeiter userDeviceLocale lesen, sollten sie prüfen, ob der Wert bei jeder neuen Nachricht geändert und gegebenenfalls angepasst werden. Beispiel: kann es sein, dass der Kundenservicemitarbeiter eine Änderung der Sprache erkennt und den Nutzer fragt, ob er können Sie in der aktuellen Sprache weiter kommunizieren oder zu einer Sprache wechseln, die der Sprache neuen Sprache.

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

Sprache für Agent und Standort

Agents und Standorte können Konversationseinstellungen für beliebige Sprachen festlegen die sie unterstützen. Zum Beispiel könnte ein Kundenservicemitarbeiter eine Willkommensnachricht in englischer Sprache angeben. für „en“ und dieselbe spanische Nachricht für das "es" haben, Sprache oder Ein Standort kann Einstellungen für "fr" festlegen. während ein anderer Standort nicht.

Wenn für einen Agent oder Standort Unterhaltungseinstellungen für eine Sprache festgelegt sind, Business Messages geht davon aus, dass der Agent oder Standort diese Sprache unterstützt. Agents und Standorte können eine Standardsprache (defaultLocale) festlegen, die sie in der Regel kommunizieren.

Informationen zum Aktualisieren der Standardsprache eines Agents oder Standorts finden Sie unter Standardeinstellung aktualisieren Sprache. So legen Sie Konversationseinstellungen für eine Sprache fest: Weitere Informationen finden Sie unter Gespräch.

Geklärte Sprache

Indem die Sprache des Nutzergeräts ermittelt und mit den Sprachen verglichen wird für den Agent oder den Standort, an den der Nutzer eine Nachricht sendet, „Business“ Nachrichten können eine Übereinstimmung zwischen der Sprache von Nutzer und Agent beheben. Ein Kundenservicemitarbeiter oder defaultLocale des Standorts hat Vorrang vor anderen unterstützten Sprachen, wenn Business Messages löst eine Übereinstimmung auf. Jede Nachricht, die Agents erhalten, enthält Folgendes: Übereinstimmung in der context.resolvedLocale ein.

Business Messages verwendet die aufgelöste Sprache, um die Konversation auszuwählen (z. B. Willkommensnachrichten und Offlinenachrichten) und Strings (z. B. den Vorschlag für die Anfrage eines Live-Kundenservicemitarbeiters String) angezeigt werden soll. Es hat sich bewährt, Kundenservicemitarbeiter um eine einheitliche User Experience zu gewährleisten.

Die aufgelöste Sprache kann sich innerhalb einer Unterhaltung ändern, wenn der Nutzer die Sprache die Sprache des Geräts verwendet oder zwischen Geräten mit einer anderen Sprache gewechselt wird. Einstellungen. Kundenservicemitarbeiter sollten bei jeder neuen Nachricht prüfen, ob sich der Wert geändert hat. gegebenenfalls anpassen. Beispiel: Ein Agent erkennt eine Änderung der Sprache und fragen Sie den Nutzer, ob er die Kommunikation Sprache oder wechseln Sie zu einer Sprache, die der neuen Sprache entspricht.

Standardsprache aktualisieren

Zum Angeben einer Standardsprache senden Sie eine PATCH-Anfrage mit der Business Communications API , um das Feld defaultLocale eines Agents oder Standorts zu aktualisieren.

So aktualisieren Sie die Unterhaltungseinstellungen eines Agents oder Standorts für eine Sprache, z. B. Willkommensnachricht und Gesprächseinstiege – siehe Die Gespräch.

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, Agent name, z. B. „brands/12345/agents/67890“

    Wenn Sie den name des Agents nicht kennen, lesen Sie Alle Agents für einen brand [Marke].

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

    Wenn Sie die name des Standorts nicht kennen, lesen Sie Alle Standorte für brand [Marke].

  • Das Gebietsschema, das als Standardsprache festgelegt werden soll, mit zwei Zeichen nach ISO 639-1-Sprache Code

  • Sprachspezifische Einstellungen für Unterhaltungen, die für den Agent oder Standort festgelegt wurden. Weitere Informationen finden Sie unter Beginnen Sie Unterhaltung

Aktualisierungsanfrage senden

Führen Sie den folgenden Befehl aus, um den Agent oder Standort zu aktualisieren. Variablen ersetzen mit Werten, die Sie unter Voraussetzungen angegeben haben.

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__"
  }
}'

Informationen zu Formatierungs- und Wertoptionen finden Sie unter BusinessMessagesAgent aktualisiert.

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"
}'

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