Pelokalan dan lokal

Pengguna berkomunikasi dari banyak lokasi dan dalam banyak bahasa. Agen yang responsif terhadap preferensi komunikasi pengguna dan melokalkan pengalaman mereka menjangkau lebih banyak pengguna, menciptakan pengalaman pengguna yang lebih memuaskan, dan mendorong lebih banyak interaksi berulang daripada agen yang tidak responsif. Business Messages memungkinkan agen dan lokasi merespons preferensi pengguna dengan meneruskan setelan lokal pengguna ke agen, sehingga agen dapat menentukan lokal default dan setelan percakapan unik per lokal, serta menyelesaikan kecocokan antara lokal pengguna dan lokal yang didukung agen atau lokasi.

Dengan mendeteksi bahasa, agen Business Messages dapat melokalkan pengalaman mereka dengan membuat interaksi agen otomatis dan live mengetahui preferensi bahasa dan wilayah pengguna.

Lokal pengguna

Saat pengguna memulai percakapan dengan agen, dan setiap kali pengguna mengirim pesan, Business Messages mendeteksi setelan lokalitas perangkat pengguna. Setiap pesan yang diterima agen menyertakan lokalitas pengguna di kolom context.userInfo.userDeviceLocale.

Business Messages menggunakan lokalitas perangkat pengguna untuk mengubah bahasa di antarmuka pengguna dan mengubah bahasa string yang dihasilkan oleh platform.

userDeviceLocale dapat berubah dalam percakapan jika pengguna mengubah bahasa perangkat atau beralih antar-perangkat yang memiliki setelan lokalitas yang berbeda. Jika agen membaca userDeviceLocale, mereka harus memeriksa apakah nilai telah berubah dengan setiap pesan baru dan menyesuaikannya jika telah berubah. Misalnya, agen dapat mendeteksi perubahan lokalitas dan menanyakan kepada pengguna apakah mereka lebih suka melanjutkan komunikasi dalam bahasa saat ini atau beralih ke bahasa yang cocok dengan lokalitas baru.

userDeviceLocale ditentukan oleh perangkat pengguna dan dapat berupa tag bahasa IETF BCP 47.

Lokalitas agen dan lokasi

Agen dan lokasi dapat menentukan setelan percakapan untuk lokalitas mana pun yang mereka dukung. Misalnya, agen dapat menentukan pesan selamat datang dalam bahasa Inggris untuk lokalitas "en" dan memiliki pesan yang sama dalam bahasa Spanyol untuk lokalitas "es", atau satu lokasi dapat menentukan setelan untuk lokalitas "fr", sementara lokasi lain tidak.

Jika agen atau lokasi memiliki setelan percakapan yang ditetapkan untuk bahasa tertentu, Business Messages mengasumsikan bahwa agen atau lokasi tersebut mendukung bahasa tersebut. Agen dan lokasi dapat menetapkan lokalitas default (defaultLocale) yang biasanya digunakan untuk berkomunikasi.

Untuk memperbarui lokalitas default agen atau lokasi, lihat Memperbarui lokalitas default. Untuk menyetel setelan percakapan untuk lokalitas, lihat Mulai percakapan.

Lokalitas yang diselesaikan

Dengan mengidentifikasi lokal perangkat pengguna dan membandingkan lokal tersebut dengan lokal yang ditentukan untuk agen atau lokasi yang dikirimi pesan oleh pengguna, Business Messages dapat mencocokkan lokal pengguna dan agen. defaultLocale agen atau lokasi lebih diprioritaskan daripada lokalitas lain yang didukung saat Business Messages menyelesaikan kecocokan. Setiap pesan yang diterima agen menyertakan kecocokan ini di kolom context.resolvedLocale.

Business Messages menggunakan lokalitas yang telah diselesaikan untuk memilih setelan percakapan (seperti pesan sambutan dan pesan offline) dan string (seperti string Saran permintaan agen live) yang akan ditampilkan. Sebaiknya agen berkomunikasi dalam bahasa yang digunakan saat masalah diselesaikan untuk mempertahankan pengalaman pengguna yang konsisten.

Lokalitas yang di-resolve dapat berubah dalam percakapan jika pengguna mengubah bahasa perangkat atau beralih antar-perangkat yang memiliki setelan lokalitas yang berbeda. Agen harus memeriksa apakah nilai telah berubah dengan setiap pesan baru dan menyesuaikannya jika telah berubah. Misalnya, agen dapat mendeteksi perubahan lokalitas dan menanyakan kepada pengguna apakah mereka lebih suka melanjutkan komunikasi dalam bahasa saat ini atau beralih ke bahasa yang sesuai dengan lokalitas baru.

Memperbarui lokalitas default

Untuk menentukan lokalitas default, Anda membuat permintaan PATCH dengan Business Communications API untuk memperbarui kolom defaultLocale agen atau lokasi.

Untuk memperbarui setelan percakapan agen atau lokasi untuk lokalitas—seperti pesan selamat datang dan pemicu percakapan—lihat Memulai percakapan.

Prasyarat

Sebelum memperbarui lokalitas default, Anda memerlukan item berikut:

  • Jalur ke kunci akun layanan project GCP Anda di mesin pengembangan

  • Untuk lokalitas default agen, agen name (misalnya, "brands/12345/agents/67890")

    Jika Anda tidak mengetahui name agen, lihat Mencantumkan semua agen untuk merek.

  • Untuk lokalitas default lokasi, lokasi name (misalnya, "brands/12345/locations/67890")

    Jika Anda tidak mengetahui name lokasi, lihat Mencantumkan semua lokasi untuk merek.

  • Lokalitas yang akan ditetapkan sebagai default, sebagai kode bahasa ISO 639-1 dua karakter

  • Setelan percakapan khusus lokalitas yang ditetapkan untuk agen atau lokasi. Lihat Memulai percakapan

Mengirim permintaan pembaruan

Untuk memperbarui agen atau lokasi, jalankan perintah berikut. Ganti variabel dengan nilai yang Anda identifikasi di Prasyarat.

Lokal default agen 

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

Untuk opsi pemformatan dan nilai, lihat BusinessMessagesAgent.

Bahasa default lokasi 

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

Untuk opsi pemformatan dan nilai, lihat brands.locations.