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ữ. Các tác nhân đáp ứng các tùy chọn giao tiếp của người dùng và bản địa hóa trải nghiệm của họ sẽ tiếp cận được nhiều người dùng hơn, tạo ra nhiều trải nghiệm người dùng hơn và thúc đẩy tương tác nhiều lần hơn so với các tác nhân không phản hồi. Business Messages cho phép nhân viên hỗ trợ và vị trí phản hồi các lựa chọn ưu tiên của người dùng bằng cách chuyển chế độ cài đặt ngôn ngữ của người dùng sang nhân viên hỗ trợ, cho phép nhân viên hỗ trợ chỉ định ngôn ngữ mặc định và chế độ cài đặt trò chuyện duy nhất theo ngôn ngữ, đồng thời giải quyết sự trùng khớp giữa ngôn ngữ của người dùng 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ợ Business Messages có thể bản địa hoá trải nghiệm bằng cách cho phép nhân viên hỗ trợ trực tiếp và người dùng tương tác trực tiếp biết đến lựa chọn ưu tiên về ngôn ngữ và khu vực của người dùng.

Ngôn ngữ người dùng

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

Business Messages sử dụng ngôn ngữ của thiết bị 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 ra.

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ó chế độ cài đặt ngôn ngữ khác. Nếu đọc tác vụ userDeviceLocale thì các tác nhân sẽ kiểm tra xem giá trị có thay đổi theo từng thông báo 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 một thay đổi về ngôn ngữ và hỏi người dùng xem họ muốn tiếp tục giao tiếp bằng ngôn ngữ hiện tại hay chuyển sang ngôn ngữ phù hợp với ngôn ngữ mới.

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

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

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

Nếu nhân viên hỗ trợ hoặc vị trí có bất kỳ chế độ cài đặt trò chuyện nào được thiết lập cho một ngôn ngữ, thì Business Messages sẽ giả định rằng nhân viên hỗ trợ hoặc vị trí đó hỗ trợ ngôn ngữ đó. Tác nhân và vị trí có thể đặt ngôn ngữ mặc định (defaultLocale) mà chúng thường giao tiếp.

Để cập nhật ngôn ngữ mặc định của 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. Để đặ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ữ đã được giải quyết

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

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

Ngôn ngữ đã 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ó chế độ cài đặt ngôn ngữ khác. Nhân viên hỗ trợ nên kiểm tra xem giá trị có thay đổi với từng thông báo 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 một thay đổi về ngôn ngữ và hỏi người dùng xem họ muốn tiếp tục giao tiếp bằng ngôn ngữ hiện tại hay chuyển sang 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 một ngôn ngữ mặc định, bạn thực hiện yêu cầu PATCH bằng API Truyền thông doanh nghiệp để cập nhật trường defaultLocale của một nhân viên hỗ trợ hoặc vị trí.

Để cập nhật các chế độ cài đặt cuộc trò chuyện của nhân viên hỗ trợ hoặc vị trí cho một ngôn ngữ – chẳng hạn như thư chào mừng và trình bắt đầu cuộc trò chuyện – hãy 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ó những mục sau:

  • Đường dẫn đến khóa tài khoản dịch vụ của dự án GCP trên máy phát triển của bạn

  • Đối với ngôn ngữ mặc định của nhân viên hỗ trợ, nhân viên hỗ trợ name (ví dụ: "brands/12345/agents/67890")

    Nếu bạn không biết name của tác nhân, hãy xem phần Liệt kê tất cả tác nhân của một thương hiệu.

  • Đối với ngôn ngữ mặc định của vị trí, hãy chọn vị trí name (ví dụ: "brands/12345/locations/67890")

    Nếu bạn không biết name của vị trí đó, hãy xem bài viết Liệt kê tất cả vị trí cho một thương hiệu.

  • Ngôn ngữ được đặt làm mặc định dưới dạng mã ngôn ngữ ISO 639-1 gồm hai ký tự

  • Cài đặt cuộc trò chuyện dành riêng cho từng ngôn ngữ được đặt cho nhân viên hỗ trợ hoặc vị trí. Xem phần Bắt đầu cuộc trò chuyện

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ế các 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 nhân viên hỗ trợ 


# 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 tuỳ chọn đị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 tùy chọn định dạng và giá trị, hãy xem brands.locations.