Pelokalan dan lokal

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

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

Bahasa pengguna

Saat pengguna memulai percakapan dengan agen, dan setiap kali pengguna mengirim Business Messages akan mendeteksi setelan lokalitas perangkat pengguna. Masing-masing yang diterima agen mencakup lokalitas pengguna dalam context.userInfo.userDeviceLocale kolom tersebut.

Business Messages menggunakan lokalitas perangkat pengguna untuk mengubah bahasa di dan mengubah bahasa {i>string<i} yang dihasilkan oleh platform.

userDeviceLocale dapat berubah dalam percakapan jika pengguna mengubah bahasa perangkat atau beralih antarperangkat yang memiliki lokalitas berbeda setelan. Jika agen membaca userDeviceLocale, mereka harus memeriksa apakah nilainya dengan setiap pesan baru dan beradaptasi jika ada. Sebagai contoh, agen dapat mendeteksi perubahan lokalitas dan menanyakan kepada pengguna apakah mereka ingin terus berkomunikasi dalam bahasa yang sekarang atau beralih ke bahasa yang sesuai dengan lokal baru.

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

Lokalitas lokasi dan agen

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

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

Untuk memperbarui lokal agen atau lokasi default, lihat Memperbarui setelan default lokalitas. Untuk mengatur pengaturan percakapan untuk lokal, lihat Memulai percakapan.

Lokalitas yang terselesaikan

Dengan mengidentifikasi lokalitas perangkat pengguna dan membandingkan lokalitas tersebut dengan lokalitasnya yang ditentukan untuk agen atau lokasi yang dikirimi pesan oleh pengguna, Pesan dapat me-resolve kecocokan antara lokal pengguna dan agen. Agen atau defaultLocale lokasi lebih diprioritaskan daripada lokalitas lain yang didukung saat Business Messages akan menyelesaikan kecocokan. Setiap agen pesan yang diterima menyertakan cocokkan di context.resolvedLocale kolom tersebut.

Business Messages menggunakan lokalitas yang diselesaikan untuk memilih percakapan mana setelan (seperti pesan selamat datang dan pesan offline) dan string (seperti Saran permintaan agen langsung string) untuk ditampilkan. Praktik terbaik bagi agen adalah berkomunikasi dengan lokal untuk mempertahankan pengalaman pengguna yang konsisten.

Lokal yang diselesaikan dapat berubah dalam percakapan jika pengguna mengubah bahasa perangkat atau beralih antarperangkat yang memiliki lokalitas berbeda setelan. Agen harus memeriksa apakah nilai telah berubah dengan setiap pesan baru dan beradaptasi dengan sesuai. Misalnya, agen mungkin mendeteksi perubahan lokalitas dan bertanya kepada pengguna apakah mereka ingin terus berkomunikasi dengan atau beralihlah ke bahasa yang sesuai dengan lokalitas baru.

Mengupdate lokalitas default

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

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

Prasyarat

Sebelum mengupdate 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 brand.

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

    Jika Anda tidak mengetahui name lokasi, lihat Buat daftar semua lokasi untuk brand.

  • Lokal yang akan disetel sebagai default, menggunakan bahasa dua karakter ISO 639-1 kode

  • Setelan percakapan khusus lokalitas ditetapkan untuk agen atau lokasi. Lihat Mulai 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__"
  }
}'
update-agent-bm-defaultLocale.sh

Untuk opsi pemformatan dan nilai, lihat BusinessMessagesAgent.

Lokal 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"
}'
update-location-bm-defaultLocale.sh

Untuk opsi pemformatan dan nilai, lihat brands.locations.