Bản địa hoá và bản địa hoá

Người dùng giao tiếp từ nhiều vị trí và bằng nhiều ngôn ngữ. Những nhân viên hỗ trợ đáp ứng yêu cầu của người dùng sở thích giao tiếp và bản địa hoá trải nghiệm của họ tiếp cận thêm nhiều người dùng, tạo ra trải nghiệm trọn vẹn hơn cho người dùng và mang lại nhiều lợi ích hơn tương tác nhiều lần so với nhân viên hỗ trợ không phản hồi. Business Messages cho phép nhân viên hỗ trợ và địa điểm phản hồi bằng cách chuyển chế độ cài đặt ngôn ngữ của người dùng cho các tác nhân, cho phép tác nhân chỉ định một ngôn ngữ và chế độ cài đặt trò chuyện riêng biệt cho từng ngôn ngữ và giải quyết các trường hợp trùng khớp giữa các phiên bản và ngôn ngữ được hỗ trợ của nhân viên hỗ trợ hoặc vị trí.

Bằng cách phát hiện ngôn ngữ, nhân viên hỗ trợ của Business Messages có thể bản địa hoá trải nghiệm của họ bằng cách giúp các nhân viên hỗ trợ tương tác trực tiếp và tự động nhận biết được khu vực và tùy chọn ngôn ngữ.

Ngôn ngữ của người dùng

Khi người dùng bắt đầu cuộc trò chuyện với nhân viên hỗ trợ và mỗi lần người dùng gửi một Business Messages phát hiện chế độ cài đặt ngôn ngữ trên thiết bị của người dùng. Một Các tác nhân thông báo nhận được bao gồm ngôn ngữ của người dùng trong context.userInfo.userDeviceLocale .

Business Messages sử dụng ngôn ngữ trên thiết bị của người dùng để thay đổi ngôn ngữ trong giao diện người dùng và thay đổi ngôn ngữ của các chuỗi do nền tảng tạo.

userDeviceLocale có thể thay đổi trong một cuộc trò chuyện nếu người dùng thay đổi ngôn ngữ của thiết bị hoặc chuyển đổi giữa các thiết bị có ngôn ngữ khác phần cài đặt. Nếu đọc userDeviceLocale, tác nhân người dùng cần kiểm tra xem giá trị đó có thay đổi theo mỗi thông điệp mới và điều chỉnh cho phù hợp (nếu có). Ví dụ: một tác nhân có thể phát hiện thay đổi về ngôn ngữ và hỏi người dùng xem họ có muốn tiếp tục giao tiếp bằng ngôn ngữ hiện tại hoặc chuyển sang một ngôn ngữ phù hợp với ngôn ngữ mới.

userDeviceLocale do thiết bị của người dùng chỉ định và có thể là bất kỳ IETF BCP nào Thẻ ngôn ngữ 47.

Tác nhân và ngôn ngữ vị trí

Nhân viên hỗ trợ và địa điểm hỗ trợ có thể chỉ định các chế độ cài đặt trò chuyện cho bất kỳ ngôn ngữ nào mà họ hỗ trợ. Ví dụ: nhân viên hỗ trợ có thể chỉ định tin nhắn chào mừng bằng tiếng Anh cho "en" ngôn ngữ và có cùng thông điệp bằng tiếng Tây Ban Nha cho "es" ngôn ngữ hoặc một vị trí có thể chỉ định cài đặt cho "fr" ngôn ngữ trong khi một vị trí khác thì không.

Nếu một nhân viên hỗ trợ hoặc vị trí đã đặt chế độ cài đặt trò chuyện cho ngôn ngữ, Business Messages giả định rằng nhân viên hỗ trợ hoặc vị trí hỗ trợ ngôn ngữ đó. Nhân viên hỗ trợ và vị trí có thể đặt một ngôn ngữ mặc định (defaultLocale) mà họ thường giao tiếp.

Để cập nhật ngôn ngữ mặc định của một nhân viên hỗ trợ hoặc vị trí, hãy xem phần Cập nhật ngôn ngữ mặc định ngôn ngữ. Cách đặt chế độ cài đặt trò chuyện cho một ngôn ngữ: hãy xem phần Bắt đầu cuộc trò chuyện.

Ngôn ngữ đã giải quyết

Bằng cách xác định ngôn ngữ của thiết bị của người dùng và so sánh ngôn ngữ đó với các ngôn ngữ được chỉ định cho tác nhân hoặc vị trí mà người dùng nhắn tin, Doanh nghiệp Thông báo có thể giải quyết trường hợp trùng khớp giữa ngôn ngữ của người dùng và ngôn ngữ của tác nhân. Một nhân viên hỗ trợ hoặc defaultLocale của vị trí được ưu tiên hơn so với các ngôn ngữ được hỗ trợ khác khi Business Messages giải quyết một trường hợp trùng khớp. Mỗi nhân viên hỗ trợ thông báo nhận được đều có khớp ở context.resolvedLocale .

Business Messages sử dụng ngôn ngữ đã được phân giải để chọn cuộc trò chuyện các chế độ cài đặt (chẳng hạn như thư chào mừng và thư ngoại tuyến) và chuỗi (chẳng hạn như Đề xuất về yêu cầu của nhân viên hỗ trợ trực tiếp string) để hiển thị. Phương pháp hay nhất là các tác nhân nên giao tiếp trong để duy trì trải nghiệm người dùng nhất quán.

Ngôn ngữ được phân giải có thể thay đổi trong một cuộc trò chuyện nếu người dùng thay đổi ngôn ngữ của thiết bị hoặc chuyển đổi giữa các thiết bị có ngôn ngữ khác phần cài đặt. Nhân viên hỗ trợ phải kiểm tra xem giá trị này có thay đổi trong mỗi tin nhắn mới hay không và điều chỉnh cho phù hợp (nếu có). Ví dụ: một tác nhân có thể phát hiện thấy thay đổi về ngôn ngữ và hỏi xem người dùng có muốn tiếp tục liên lạc trong hoặc chuyển sang một ngôn ngữ phù hợp với ngôn ngữ mới.

Cập nhật ngôn ngữ mặc định

Để chỉ định ngôn ngữ mặc định, bạn cần tạo yêu cầu PATCH với kênh Business Communications API để cập nhật trường defaultLocale của nhân viên hỗ trợ hoặc vị trí.

Để cập nhật chế độ cài đặt cuộc trò chuyện của một nhân viên hỗ trợ hoặc vị trí cho một ngôn ngữ, chẳng hạn như tin nhắn chào mừng và câu lệnh bắt đầu cuộc trò chuyện – xem phần Bắt đầu cuộc trò chuyện.

Điều kiện tiên quyết

Trước khi cập nhật ngôn ngữ mặc định, bạn cần có các mục sau:

Gửi yêu cầu cập nhật

Để cập nhật nhân viên hỗ trợ hoặc vị trí, hãy chạy lệnh sau. Thay thế biến bằng các giá trị bạn đã xác định trong Điều kiện tiên quyết.

Ngôn ngữ mặc định của tác nhân 

# 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

Để biết các lựa chọn về định dạng và giá trị, hãy xem BusinessMessagesAgent.

Ngôn ngữ mặc định của vị trí 

# 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

Để biết các lựa chọn về định dạng và giá trị, hãy xem brands.locations.