Yerelleştirme ve yerel ayarlar

Kullanıcılar birçok yerden ve birçok dilde iletişim kurar. Temsilciler: kullanıcılara göre ve deneyimlerini yerelleştirerek daha fazla kullanıcıya ulaşabilir, daha iyi kullanıcı deneyimleri oluşturabilir ve yanıt vermeyen temsilcilere kıyasla tekrar eden etkileşimlere neden olur. Business Messages aracıların ve konumların kullanıcıların isteklerine ve kullanıcı yerel ayarlarını aracılar için ayarlar. Böylece, aracılar varsayılan bir yerel ayar yerel ayara göre benzersiz konuşma ayarları yapmak ve kullanıcıların yerel ayarları ve bir aracı ya da konumun desteklediği yerel ayarları içerir.

Business Messages temsilcileri, yerel ayarı algılayarak deneyimlerini yerelleştirerek otomatik ve canlı temsilci etkileşimlerini kullanıcıların bilgilerinden haberdar etmek bölge ve dil tercihlerine dokunun.

Kullanıcı yerel ayarı

Kullanıcı temsilciyle görüşme başlattığında ve kullanıcı her seferinde "Business Messages, kullanıcı cihazının yerel ayarlarını algılar. Her biri mesaj aracılarının aldığı mesaj aracıları, context.userInfo.userDeviceLocale girin.

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

userDeviceLocale, kullanıcı dilini veya farklı yerel ayarlara sahip cihazlar arasında geçiş yaptığında Ayarlar'da devre dışı bırakabilirsiniz. Temsilciler userDeviceLocale değerini okursa değerin ve varsa da buna göre uyarlanır. Örneğin, temsilci bir yerel ayar değişikliği tespit edebilir ve kullanıcıya geçerli dilde iletişim kurmaya devam edin veya Yeni yerel ayar.

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

Temsilci ve konum yerel ayarı

Temsilciler ve konumlar, hangi yerel ayarlar için sohbet ayarları belirtebilir? destek olurlar. Örneğin, bir temsilci İngilizce bir karşılama mesajı belirtebilir "en" için ve "es" için İspanyolcada aynı mesajı yazmak yerel ayar veya bir konum, "fr" için ayarları belirtebilir yerel ayar, başka bir konum çalışmaz.

Bir temsilcinin veya konumun bir yerel ayar için konuşma ayarları varsa: Business Messages, temsilci veya konumun bu yerel ayarı desteklediğini varsayar. Temsilciler ve konumlar, kendilerinin belirlediği bir varsayılan yerel ayarı (defaultLocale) iletişim kurmaktır.

Bir temsilcinin veya konumun varsayılan yerel ayarını güncellemek için Varsayılanı güncelleme başlıklı makaleyi inceleyin. yerel ayar. Bir yerel ayar için konuşma ayarlarını belirlemek üzere: bkz. görüşme ekleyin.

Çözülmüş yerel ayar

Kullanıcı cihazının yerel ayarını tespit ederek ve bu yerel ayarı yerel ayarlarla karşılaştırarak temsilci veya kullanıcının mesaj gönderdiği konum için belirtilir. Mesajlar, kullanıcı ve aracı yerel ayarları arasındaki eşleşmeyi çözümleyebilir. Temsilci veya konumun defaultLocale özelliği, aşağıdaki durumlarda desteklenen diğer yerel ayarlara göre öncelikli olur: Business Messages bir eşleşmeyi çözüme ulaştırır. Aldığı her mesaj aracısı şu kodu içerir: şununla eşleşiyor: context.resolvedLocale girin.

Business Messages, hangi konuşma dilini seçmek için çözümlenmiş yerel ayarı kullanır ayarlarını (örneğin, hoş geldiniz iletileri ve çevrimdışı iletiler) ve dizeleri (örneğin, Canlı müşteri temsilcisi istek önerisi dizesi). Temsilcilerin belirlenen çözüm sırasında iletişim kurması, yerel ayarı kullanır.

Bir görüşmedeki çözümlenmiş yerel ayar, kullanıcı dilini veya farklı yerel ayarlara sahip cihazlar arasında geçiş yaptığında Ayarlar'da devre dışı bırakabilirsiniz. Temsilciler her yeni iletide değerin değişip değişmediğini kontrol etmelidir ve varsa buna göre uyarlamanız gerekir. Örneğin, bir aracı yerel ayar değişikliği algılayabilir ve kullanıcıya mevcut durumda iletişim kurmaya devam etmeyi veya dil ayarını değiştirin veya yeni yerel ayarla eşleşen bir dile geçin.

Varsayılan yerel ayarı güncelleme

Varsayılan bir yerel ayar belirtmek için YAMA isteğinde bulunursunuz Business Communication API bir temsilcinin veya konumun defaultLocale alanını güncelleyin.

Bir temsilcinin veya konumun bir yerel ayara ilişkin görüşme ayarlarını güncellemek için: karşılama mesajı ve görüşme başlatıcılar (bkz. görüşme ekleyin.

Ön koşullar

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

  • Geliştirme makinenizdeki GCP projenizin hizmet hesabı anahtarına giden yol

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

    Temsilcinin name numarasını bilmiyorsanız brand [marka] özelliğini gönderin.

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

    Konumun name konumunu bilmiyorsanız brand [marka] özelliğini gönderin.

  • İki karakterlik ISO 639-1 dili olarak varsayılan olarak ayarlanacak yerel ayar kod

  • Temsilci veya konum için belirlenen yerel ayara özel sohbet ayarları. Görüntüleyin görüşme

Güncelleme isteğini gönderin

Aracıyı veya konumu güncellemek için aşağıdaki komutu çalıştırın. Değişkenleri değiştir Ön koşullar bölümünde tanımladığınız değerlerle uyumlu olmalıdır.

Aracı 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__"
  }
}'
update-agent-bm-defaultLocale.sh

Biçimlendirme ve değer seçenekleri için bkz. BusinessMessagesAgent.

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

Biçimlendirme ve değer seçenekleri için bkz. brands.locations için de geçerli.