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 lebih banyak pengalaman pengguna yang memuaskan, dan mendorong lebih banyak interaksi berulang daripada agen yang tidak responsif. Business Messages memungkinkan agen dan lokasi responsif terhadap preferensi pengguna dengan meneruskan setelan lokalitas pengguna ke agen, memungkinkan agen untuk menentukan lokalitas default dan setelan percakapan yang unik per lokalitas, serta menyelesaikan pencocokan antara lokalitas pengguna dan lokalitas agen atau lokasi yang didukung lokasi.
Dengan mendeteksi lokalitas, agen Business Messages dapat melokalkan pengalamannya dengan membuat interaksi agen otomatis dan langsung dengan memahami preferensi wilayah dan bahasa pengguna.
Lokalitas pengguna
Saat pengguna memulai percakapan dengan agen, dan setiap kali pengguna mengirim pesan, Business Messages mendeteksi setelan lokalitas perangkat pengguna. Setiap agen pesan yang diterima mencakup 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 membaca userDeviceLocale
, agen harus memeriksa apakah nilainya telah berubah dengan setiap pesan baru dan beradaptasi jika ada. Misalnya, agen mungkin mendeteksi perubahan lokalitas dan bertanya kepada pengguna apakah mereka ingin
terus berkomunikasi dalam bahasa saat ini atau beralih ke bahasa yang sesuai dengan
lokalitas baru.
userDeviceLocale
ditentukan oleh perangkat pengguna dan dapat berupa tag bahasa IETF BCP
47 apa pun.
Agen dan lokalitas lokasi
Agen dan lokasi dapat menentukan setelan percakapan untuk lokalitas mana pun yang mereka dukung. Misalnya, agen mungkin 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" sedangkan lokasi lainnya tidak.
Jika agen atau lokasi memiliki setelan percakapan yang ditetapkan untuk lokalitas,
Business Messages mengasumsikan bahwa agen atau lokasi mendukung lokalitas tersebut.
Agen dan lokasi dapat menetapkan lokalitas default (defaultLocale
) yang
biasanya mereka gunakan untuk berkomunikasi.
Untuk memperbarui lokalitas default agen atau lokasi, lihat Memperbarui lokalitas default. Untuk menetapkan setelan percakapan untuk suatu lokal, lihat Memulai percakapan.
Lokalitas yang diselesaikan
Dengan mengidentifikasi lokalitas perangkat pengguna dan membandingkan lokalitas tersebut dengan lokalitas
yang ditentukan untuk agen atau lokasi yang dikirimi pesan oleh pengguna, Business
Message dapat menyelesaikan kecocokan antara lokalitas pengguna dan agen. defaultLocale
agen atau
lokasi lebih diutamakan daripada lokalitas yang didukung saat
Business Messages menyelesaikan pencocokan. Setiap agen pesan yang diterima akan menyertakan kecocokan ini di kolom context.resolvedLocale
.
Business Messages menggunakan lokalitas yang telah ditentukan untuk memilih setelan percakapan (seperti pesan selamat datang dan pesan offline) dan string (seperti string Saran permintaan agen langsung) untuk ditampilkan. Sebaiknya agen berkomunikasi dengan lokal yang telah di-resolve 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 nilainya telah berubah dengan setiap pesan baru dan beradaptasi jika ada. Misalnya, agen mungkin mendeteksi perubahan lokalitas dan bertanya kepada pengguna apakah mereka ingin terus berkomunikasi dalam bahasa saat ini atau beralih ke bahasa yang cocok dengan lokalitas baru.
Mengupdate 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 suatu lokal—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 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 suatu brand.Untuk lokal default lokasi, lokasi
name
(misalnya, "brands/12345/locations/67890")Jika Anda tidak mengetahui
name
lokasi, lihat Menampilkan daftar semua lokasi untuk suatu merek.Lokal yang akan ditetapkan sebagai default, sebagai kode bahasa ISO 639-1 dua karakter
Setelan percakapan khusus lokal 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.
Lokasi 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.