Lokalizacja i języki

Użytkownicy komunikują się z wielu lokalizacji i w wielu językach. Agenty, które dostosowują się do preferencji komunikacji i dostosowują wrażenia użytkownika, docierają do większej liczby użytkowników, zapewniają bardziej satysfakcjonujące wrażenia i zapewniają więcej interakcji niż agenty, które nie odpowiadają. Business Messages umożliwia agentom i lokacjom reagowanie na preferencje użytkowników, przekazując ustawienia użytkowników do agentów, umożliwiając określenie domyślnego ustawienia regionalnego i unikalnych ustawień rozmów dla danego języka oraz rozwiązywanie dopasowań między regionami użytkowników a obsługiwanymi językami agenta lub lokalizacji.

Dzięki wykrywaniu ustawień języka agenty Business Messages mogą lokalizować swoje doświadczenia, automatyzując i poprawiając interakcje agentów na żywo z uwzględnieniem regionu i języka użytkownika.

Język użytkownika

Gdy użytkownik rozpoczyna rozmowę z agentem, za każdym razem, gdy użytkownik wysyła wiadomość, Business Messages wykrywa ustawienia lokalne urządzenia. Każdy odbierany agent zawiera lokalizację użytkownika w polu context.userInfo.userDeviceLocale.

Business Messages używa języka urządzenia, aby zmienić język interfejsu i zmienić język ciągów tekstowych generowanych przez platformę.

userDeviceLocale może zmienić język w rozmowie, jeśli użytkownik zmieni język urządzenia lub przełączy się na inne urządzenie z różnymi ustawieniami regionalnymi. Jeśli agent odczytuje wartość userDeviceLocale, powinien sprawdzać, czy wartość zmieniała się w przypadku każdej nowej wiadomości, i w razie potrzeby dostosowywać ją. Agent może na przykład wykryć zmianę języka i zapytać użytkownika, czy chce nadal komunikować się w bieżącym języku czy zmienić język na nowy.

Tag userDeviceLocale jest określany przez urządzenie użytkownika i może być dowolnym tagiem języka IETF BCP 47.

Język agenta i lokalizacji

Przedstawiciele i lokalizacje mogą określać ustawienia rozmów w zależności od obsługiwanego regionu. Na przykład agent może określić komunikat powitalny dla języka „en” w języku angielskim i tę samą wiadomość w języku hiszpańskim dla regionu „es”, a jedna lokalizacja może określić ustawienia dla regionu „fr”, a inna nie.

Jeśli agent lub lokalizacja ma ustawione ustawienia konwersacji dla danego regionu, narzędzie Business Messages zakłada, że obsługuje on dany język. Agenty i lokalizacje mogą ustawić język domyślny (defaultLocale), z którym zwykle się komunikują.

Aby zaktualizować domyślne ustawienia agenta lub lokalizacji, zobacz Aktualizowanie domyślnego ustawienia lokalnego. Aby skonfigurować ustawienia rozmów w określonym języku, przeczytaj artykuł Rozpoczynanie rozmowy.

Wykryty język

Dzięki zidentyfikowaniu regionu urządzenia użytkownika i porównaniu go z lokalizacją określoną dla agenta lub lokalizacji, do której wysyła on wiadomości, aplikacja Business Messages może dopasować dopasowanie do użytkownika i jego języka. Gdy usługa Business Messages rozstrzyga dopasowanie, agent defaultLocale lub lokalizacja ma pierwszeństwo przed innymi obsługiwanymi ustawieniami regionalnymi. Każdy otrzymany agent wiadomości zawiera to pole w polu context.resolvedLocale.

Business Messages używa ustawień regionalnych, aby wybierać ustawienia rozmów (np. wiadomości powitalne i wiadomości offline) oraz ciągi znaków (takie jak Sugestia agenta na żywo) do wyświetlenia. Sprawdzoną metodą dla agentów jest przekazywanie komunikatów w rozwiązanym środowisku, aby zapewnić spójność.

Zakończony język może się zmienić w ramach rozmowy, jeśli użytkownik zmieni język urządzenia lub przełączy się na inne urządzenie z różnymi ustawieniami regionalnymi. Agenty powinny sprawdzać, czy wartość zmieniała się w przypadku każdej nowej wiadomości, i odpowiednio do niej dostosowywać. Agent może na przykład wykryć zmianę języka i zapytać użytkownika, czy wolisz nadal komunikować się w bieżącym języku czy zmienić język na nowy.

Zaktualizuj domyślny język

Aby określić język domyślny, wyślij żądanie PATCH za pomocą interfejsu Business Communications API, aby zaktualizować pole defaultLocale agenta lub lokalizacji.

Aby zaktualizować ustawienia rozmów z agentem lub lokalizacją w danym języku (np. wiadomość powitalną i początek rozmowy), zobacz Rozpoczynanie rozmowy.

Wymagania wstępne

Zanim zaktualizujesz domyślny język, musisz mieć:

Wyślij prośbę o aktualizację

Aby zaktualizować agenta lub lokalizację, uruchom następujące polecenie. Zastąp zmienne wartościami podanymi w sekcji Wymagania wstępne.

Język domyślny agenta 


# 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

Informacje o opcjach formatowania i wartości znajdziesz w sekcji BusinessMessagesAgent.

Domyślny region – lokalizacja 


# 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

Informacje na temat formatowania i wartości znajdziesz na stronie brands.locations.