Yerelleştirme ve yerel ayarlar

Kullanıcılar birçok konumdan ve birçok dilde iletişim kurar. Kullanıcıların iletişim tercihlerine duyarlı olan ve deneyimlerini yerelleştiren temsilciler, duyarlı olmayan temsilcilere kıyasla daha fazla kullanıcıya ulaşır, daha tatmin edici kullanıcı deneyimleri oluşturur ve daha fazla tekrar etkileşim sağlar. Business Messages, kullanıcı yerel ayarlarını temsilcilere ileterek temsilcilerin ve konumların kullanıcı tercihlerine yanıt vermesini sağlar. Ayrıca, temsilcilerin varsayılan bir yerel ayar ve her yerel ayar için benzersiz sohbet ayarları belirtmesine olanak tanır ve kullanıcıların yerel ayarları ile bir temsilcinin veya konumun desteklenen yerel ayarları arasındaki eşleşmeleri çözer.

Yerel ayarları algılayan İş Mesajları temsilcileri, otomatik ve canlı temsilci etkileşimlerinde kullanıcıların bölge ve dil tercihlerini dikkate alarak deneyimlerini yerelleştirebilir.

Kullanıcı yerel ayarı

Bir kullanıcı bir temsilciyle görüşme başlattığında ve her mesaj gönderdiğinde Business Messages, kullanıcı cihazının yerel ayarlarını algılar. Müşteri temsilcilerinin aldığı her mesajda, kullanıcının yerel ayarı context.userInfo.userDeviceLocale alanında yer alır.

İşletme Mesajları, kullanıcı arayüzündeki dili ve platform tarafından oluşturulan dizelerin dilini değiştirmek için kullanıcının cihazının yerel ayarını kullanır.

userDeviceLocale, kullanıcı cihazın dilini değiştirirse veya farklı yerel ayarları olan cihazlar arasında geçiş yaparsa bir görüşme içinde değişebilir. Temsilciler userDeviceLocale okursa değerin her yeni mesajda değişip değişmediğini kontrol etmeli ve değiştiyse buna göre uyum sağlamalıdır. Örneğin, bir temsilci yerel ayar değişikliğini algılayabilir ve kullanıcıya iletişime mevcut dilde devam etmeyi mi yoksa yeni yerel ayarla eşleşen bir dile geçmeyi mi tercih ettiğini sorabilir.

userDeviceLocale, kullanıcının cihazı tarafından belirtilir ve herhangi bir IETF BCP 47 dil etiketi olabilir.

Temsilci ve konum yerel ayarı

Acenteler ve konumlar, destekledikleri yerel ayarlar için sohbet ayarlarını belirtebilir. Örneğin, bir temsilci "en" yerel ayarı için İngilizce bir karşılama mesajı belirtebilir ve aynı mesajı "es" yerel ayarı için İspanyolca olarak kullanabilir. Ayrıca, bir konum "fr" yerel ayarı için ayarları belirtebilirken başka bir konum bunu yapmayabilir.

Bir temsilci veya konum için bir yerel ayarda herhangi bir sohbet ayarı belirlenmişse Business Messages, temsilcinin veya konumun bu yerel ayarı desteklediğini varsayar. Temsilciler ve konumlar, genellikle iletişim kurdukları varsayılan bir yerel ayar (defaultLocale) belirleyebilir.

Bir temsilcinin veya konumun varsayılan yerel ayarını güncellemek için Varsayılan yerel ayarı güncelleme başlıklı makaleyi inceleyin. Bir yerel ayar için sohbet ayarlarını belirlemek üzere Sohbeti başlatma başlıklı makaleyi inceleyin.

Çözümlenmiş yerel ayar

Kullanıcı cihazının yerel ayarını belirleyip bu yerel ayarı, temsilci veya kullanıcının mesaj gönderdiği konum için belirtilen yerel ayarlarla karşılaştırarak Business Messages, kullanıcı ve temsilci yerel ayarları arasında eşleşme sağlayabilir. Business Messages bir eşleşmeyi çözdüğünde, temsilcinin veya konumun defaultLocale diğer desteklenen yerel ayarlara göre önceliklidir. Müşteri temsilcilerinin aldığı her mesaj, context.resolvedLocale alanında bu eşleşmeyi içerir.

Business Messages, hangi görüşme ayarlarının (ör. karşılama mesajları ve çevrimdışı mesajlar) ve dizelerin (ör. Canlı temsilci isteği önerisi dizesi) gösterileceğini seçmek için çözümlenmiş yerel ayarı kullanır. Tutarlı bir kullanıcı deneyimi sağlamak için temsilcilerin çözülen yerel ayarda iletişim kurması en iyi uygulamadır.

Kullanıcı, cihazın dilini değiştirirse veya farklı yerel ayarlar içeren cihazlar arasında geçiş yaparsa çözümlenen yerel ayar bir görüşme içinde değişebilir. Temsilciler, değerin her yeni mesajda değişip değişmediğini kontrol etmeli ve değiştiyse buna göre uyum sağlamalıdır. Örneğin, bir temsilci yerel ayar değişikliği algılayabilir ve kullanıcıya iletişime mevcut dilde devam etmeyi mi yoksa yeni yerel ayara uygun bir dile geçmeyi mi tercih ettiğini sorabilir.

Varsayılan yerel ayarı güncelleme

Varsayılan bir yerel ayar belirtmek için Business Communications API ile bir PATCH isteği göndererek bir temsilcinin veya konumun defaultLocale alanını güncellersiniz.

Bir yerel ayar için temsilcinin veya konumun görüşme ayarlarını (ör. karşılama mesajı ve görüşme başlatıcılar) güncellemek istiyorsanız Görüşmeyi başlatma başlıklı makaleyi inceleyin.

Ön koşullar

Varsayılan yerel ayarı güncellemeden önce aşağıdaki öğelere ihtiyacınız vardır:

  • Geliştirme makinenizde GCP projenizin hizmet hesabı anahtarının yolu

  • Temsilcinin varsayılan yerel ayarı için temsilci name (örneğin, "brands/12345/agents/67890")

    Temsilcinin name bilmiyorsanız Bir marka için tüm temsilcileri listeleme başlıklı makaleyi inceleyin.

  • Konumun varsayılan yerel ayarı için konum name (örneğin, "brands/12345/locations/67890")

    Konumun name değerini bilmiyorsanız Bir markanın tüm konumlarını listeleme başlıklı makaleyi inceleyin.

  • Varsayılan olarak ayarlanacak yerel ayar, iki karakterli ISO 639-1 dil kodu olarak

  • Ajan veya konum için yerel ayara özgü sohbet ayarları belirlenmiş olmalıdır. Bkz. Görüşmeye başlama

Güncelleme isteğini gönderme

Aracıyı veya konumu güncellemek için aşağıdaki komutu çalıştırın. Değişkenleri, Ön koşullar bölümünde belirlediğiniz değerlerle değiştirin.

Temsilcinin varsayılan yerel ayarı 

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

Biçimlendirme ve değer seçenekleri için BusinessMessagesAgent bölümüne bakın.

Konumun varsayılan yerel ayarı 

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

Biçimlendirme ve değer seçenekleri için brands.locations başlıklı makaleyi inceleyin.