Lokalizacja i języki

Użytkownicy komunikują się z wielu lokalizacji i w wielu językach. Agenci, którzy reagują na preferencje użytkowników dotyczące komunikacji i dostosowują do nich swoje działania, docierają do większej liczby użytkowników, zapewniają im lepsze wrażenia i zwiększają liczbę powracających interakcji niż agenci, którzy nie reagują na te preferencje. Funkcja Business Messages umożliwia agentom i lokalizacjom reagowanie na preferencje użytkowników, przekazując agentom ustawienia języka użytkownika, umożliwiając im określenie domyślnego języka i unikalnych ustawień rozmowy dla każdego języka oraz rozwiązując problemy z dopasowaniem języków użytkowników do języków obsługiwanych przez agenta lub lokalizację.

Dzięki wykrywaniu języka agenci Business Messages mogą dostosowywać swoje działania do preferencji użytkowników dotyczących regionu i języka, uwzględniając je w automatycznych interakcjach i rozmowach z agentem na żywo.

Język użytkownika

Gdy użytkownik rozpoczyna rozmowę z agentem i za każdym razem, gdy wysyła wiadomość, Business Messages wykrywa ustawienia języka urządzenia użytkownika. Każda wiadomość otrzymywana przez agentów zawiera język użytkownika w context.userInfo.userDeviceLocale polu.

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

Wartość userDeviceLocale może się zmienić w trakcie rozmowy, jeśli użytkownik zmieni język urządzenia lub przełączy się między urządzeniami, które mają różne ustawienia języka. Jeśli agenci odczytują wartość userDeviceLocale, powinni sprawdzać, czy zmieniła się ona w każdej nowej wiadomości, i odpowiednio dostosowywać swoje działania. Na przykład agent może wykryć zmianę języka i zapytać użytkownika, czy woli kontynuować komunikację w bieżącym języku, czy też przełączyć się na język zgodny z nowym językiem.

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

Język agenta i lokalizacji

Agenci i lokalizacje mogą określać ustawienia rozmowy dla dowolnych obsługiwanych języków. Na przykład agent może określić wiadomość powitalną w języku angielskim dla języka „en” i tę samą wiadomość w języku hiszpańskim dla języka „es”. Inna lokalizacja może określić ustawienia dla języka „fr”, a inna nie.

Jeśli agent lub lokalizacja ma ustawienia rozmowy skonfigurowane dla danego języka, Business Messages zakłada, że agent lub lokalizacja obsługuje ten język. Agenci i lokalizacje mogą ustawić domyślny język (defaultLocale), w którym zwykle się komunikują.

Aby zaktualizować domyślny język agenta lub lokalizacji, zobacz Aktualizowanie domyślnego języka. Aby ustawić ustawienia rozmowy dla danego języka, zobacz Rozpoczęcie rozmowy.

Znaleziony język

Dzięki identyfikowaniu języka urządzenia użytkownika i porównywaniu go z językami określonymi dla agenta lub lokalizacji, do których użytkownik wysyła wiadomości, Business Messages może znaleźć dopasowanie między językiem użytkownika a językiem agenta. Gdy Business Messages znajduje dopasowanie, defaultLocale agenta lub lokalizacji ma pierwszeństwo przed innymi obsługiwanymi językami. Każda wiadomość otrzymywana przez agentów zawiera to dopasowanie w context.resolvedLocale polu.

Business Messages używa znalezionego języka, aby wybrać ustawienia rozmowy (np. wiadomości powitalne i wiadomości offline) oraz ciągi (np. ciąg sugestii prośby o kontakt z agentem na żywo ), które mają być wyświetlane. Aby zapewnić spójne wrażenia użytkowników, agenci powinni komunikować się w znalezionym języku.

Znaleziony język może się zmienić w trakcie rozmowy, jeśli użytkownik zmieni język urządzenia lub przełączy się między urządzeniami, które mają różne ustawienia języka. Agenci powinni sprawdzać, czy wartość zmieniła się w każdej nowej wiadomości, i odpowiednio dostosowywać swoje działania. Na przykład agent może wykryć zmianę języka i zapytać użytkownika, czy woli kontynuować komunikację w bieżącym języku, czy też przełączyć się na język zgodny z nowym językiem.

Aktualizowanie domyślnego języka

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

Aby zaktualizować ustawienia rozmowy agenta lub lokalizacji dla danego języka, np. wiadomość powitalną i propozycje rozpoczęcia rozmowy, zobacz Rozpoczęcie rozmowy.

Wymagania wstępne

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

Wysyłanie prośby o aktualizację

Aby zaktualizować agenta lub lokalizację, uruchom to polecenie. Zastąp zmienne wartościami określonymi w sekcji Wymagania wstępne.

Domyślny język 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__"
  }
}'

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

Domyślny język lokalizacji 

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

Informacje o formatowaniu i opcjach wartości znajdziesz w sekcji brands.locations.