उपयोगकर्ता कई जगहों और भाषाओं में बात करते हैं. ऐसे एजेंट जो लोगों की बातचीत की सेटिंग को ध्यान में रखते हैं और उपयोगकर्ताओं को लोकलाइज़ करते हैं, उपयोगकर्ताओं को बेहतर अनुभव देते हैं, उपयोगकर्ता को बेहतर अनुभव देते हैं, और जो उपयोगकर्ता रिस्पॉन्सिव नहीं होते उनकी तुलना में बार-बार इंटरैक्शन करते हैं. Business Messages सुविधा, एजेंट और जगहों की जानकारी को रिस्पॉन्स देने में लोगों की मदद करने के लिए, उपयोगकर्ता की स्थान-भाषा की सेटिंग को एजेंट पर पास करने में मदद करती है. साथ ही, उपयोगकर्ताओं को डिफ़ॉल्ट स्थान-भाषा डालने और लोगों और जगह की जानकारी को आपस में जोड़ने के लिए, डिफ़ॉल्ट स्थान तय करने की सुविधा देती है.
जगह का पता लगाकर, Business Messages के एजेंट अपने इलाके के हिसाब से अपने अनुभवों का अनुवाद कर सकते हैं. ऐसा करने के लिए, वे अपने-आप और लाइव एजेंट के साथ इंटरैक्ट करते हैं. इस तरह, वे लोगों की भाषा और भाषा से जुड़ी प्राथमिकताओं को ध्यान में रखते हैं.
उपयोगकर्ता स्थान
जब कोई उपयोगकर्ता किसी एजेंट के साथ बातचीत शुरू करता है, तो हर बार उपयोगकर्ता के मैसेज भेजने पर उपयोगकर्ता के डिवाइस की स्थान-भाषा की सेटिंग का पता चलता है. हर
मैसेज एजेंट को
context.userInfo.userDeviceLocale
फ़ील्ड में उपयोगकर्ता की स्थान-भाषा शामिल होती है.
Business Messages में, उपयोगकर्ता के डिवाइस की स्थान-भाषा का इस्तेमाल होता है. इससे, यूज़र इंटरफ़ेस में भाषा और प्लैटफ़ॉर्म से जनरेट की गई स्ट्रिंग की भाषा बदली जाती है.
अगर उपयोगकर्ता डिवाइस की भाषा बदलता है या अलग-अलग स्थान सेटिंग वाले डिवाइसों के बीच स्विच करता है, तो बातचीत में userDeviceLocale बदल सकता है. अगर एजेंट userDeviceLocale पढ़ते हैं, तो उन्हें यह देखना चाहिए कि क्या हर नए मैसेज की वैल्यू बदल गई है और अगर उसके पास है, तो उसके मुताबिक बदलाव करें. उदाहरण के लिए, कोई एजेंट स्थान-भाषा में बदलाव का पता लगाकर, उपयोगकर्ता से पूछ सकता है कि क्या वे मौजूदा भाषा में बातचीत जारी रखना चाहते हैं या नई स्थान-भाषा से मेल खाने वाली भाषा पर स्विच करना चाहते हैं.
userDeviceLocale को उपयोगकर्ता के डिवाइस के हिसाब से तय किया जाता है. यह IETF BCP
47 वाला कोई भी भाषा टैग हो सकता है.
एजेंट और जगह की जानकारी
एजेंट और उनकी जगह की जानकारी देने के लिए, बातचीत की सेटिंग तय की जा सकती है. उदाहरण के लिए, एजेंट "en" स्थान-भाषा के लिए अंग्रेज़ी में वेलकम मैसेज तय कर सकता है और स्पैनिश में "es" स्थान-भाषा के लिए एक ही मैसेज भेज सकता है, या एक जगह "fr" स्थान-भाषा के लिए सेटिंग तय कर सकता है, जबकि दूसरी जगह नहीं.
अगर किसी एजेंट या जगह की स्थान-भाषा के लिए, बातचीत की सेटिंग सेट की गई है,
तो Business Messages को यह मानकर चलता है कि एजेंट या जगह की जानकारी उस भाषा में काम करती है.
एजेंट और जगह की जानकारी वाली डिफ़ॉल्ट स्थान-भाषा (defaultLocale) सेट की जा सकती है. वहां पर आम तौर पर उनकी बातचीत होती है.
एजेंट या जगह की डिफ़ॉल्ट स्थान-भाषा को अपडेट करने के लिए, डिफ़ॉल्ट स्थान-भाषा अपडेट करें देखें. किसी स्थान-भाषा के लिए बातचीत की सेटिंग सेट करने के लिए, बातचीत शुरू करें देखें.
समाधान की गई स्थान-भाषा
उपयोगकर्ता के डिवाइस की स्थान-भाषा की पहचान करके, एजेंट के लिए बताई गई स्थान-भाषाओं और उपयोगकर्ता के मैसेज की जगह की जानकारी की तुलना करके, Business Messages का इस्तेमाल करके, उपयोगकर्ता और एजेंट की स्थान-भाषा को मैच किया जा सकता है. जब Business Messages किसी मिलान का समाधान करता है, तो एजेंट या जगह की defaultLocale, ऐसी सभी स्थान-भाषाओं को प्राथमिकता देती है जिनका इस्तेमाल किया जा सकता है. मिलने वाले हर मैसेज एजेंट में
context.resolvedLocale
फ़ील्ड से मेल खाने वाला यह मैसेज शामिल होता है.
Business Messages में, समाधान की गई स्थान-भाषा का इस्तेमाल करके, यह तय किया जाता है कि बातचीत के लिए किस तरह की सेटिंग (जैसे, वेलकम मैसेज और ऑफ़लाइन मैसेज) और कौनसी स्ट्रिंग (जैसे कि लाइव एजेंट के लिए अनुरोध का सुझाव स्ट्रिंग) दिखें. एजेंट के लिए, समाधान किए गए स्थान-भाषा में बातचीत करना, एक जैसा उपयोगकर्ता अनुभव बनाए रखने का सबसे सही तरीका है.
अगर उपयोगकर्ता डिवाइस की भाषा बदलता है या अलग-अलग स्थान सेटिंग वाले डिवाइसों के बीच स्विच करता है, तो समाधान की गई स्थान-भाषा, बातचीत में बदल सकती है. एजेंट को यह देखना चाहिए कि क्या हर नए मैसेज की वैल्यू बदल गई है और अगर है, तो उसके मुताबिक बदलाव करें. उदाहरण के लिए, कोई एजेंट स्थान-भाषा में बदलाव का पता लगाकर, उपयोगकर्ता से पूछ सकता है कि क्या वे मौजूदा भाषा में बातचीत जारी रखना चाहते हैं या नई स्थान-भाषा से मेल खाने वाली भाषा पर स्विच करना चाहते हैं.
डिफ़ॉल्ट स्थान-भाषा अपडेट करना
डिफ़ॉल्ट स्थान-भाषा तय करने के लिए, किसी एजेंट या जगह के defaultLocale फ़ील्ड को अपडेट करने के लिए, Business Communications एपीआई से PATCH अनुरोध करें.
अगर किसी स्थान-भाषा के लिए किसी एजेंट या जगह की बातचीत सेटिंग, जैसे कि वेलकम मैसेज और बातचीत शुरू करने के विकल्प को अपडेट करना है, तो बातचीत शुरू करें देखें.
ज़रूरी शर्तें
डिफ़ॉल्ट स्थान-भाषा अपडेट करने से पहले, आपको इन आइटम की ज़रूरत होगी:
- आपकी डेवलपमेंट मशीन पर आपके GCP प्रोजेक्ट की सेवा खाता कुंजी का पाथ
एजेंट की डिफ़ॉल्ट स्थान-भाषा के लिए, एजेंट
name(उदाहरण के लिए, "brands/12345/agents/67890")अगर आपको एजेंट का
nameनहीं पता है, तो ब्रैंड के लिए सभी एजेंट की सूची बनाएं देखें.जगह की डिफ़ॉल्ट स्थान-भाषा के लिए, जगह की जानकारी
name(उदाहरण के लिए, "brands/12345/locations/67890")अगर आपको जगह की
nameके बारे में नहीं पता है, तो किसी ब्रैंड के सभी जगहों की सूची बनाएं देखें.दो वर्णों वाले ISO 639-1 भाषा कोड के तौर पर, डिफ़ॉल्ट के तौर पर सेट की जाने वाली स्थान-भाषा
एजेंट या जगह की जानकारी के लिए, स्थान-भाषा के हिसाब से बातचीत की सेटिंग. बातचीत शुरू करना देखें
अपडेट का अनुरोध भेजें
एजेंट या जगह की जानकारी अपडेट करने के लिए, यह निर्देश चलाएं. वैरिएबल को उन वैल्यू से बदलें जिनकी पहचान आपने ज़रूरी शर्तों में की है.
एजेंट की डिफ़ॉल्ट स्थान-भाषा
# 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__"
}
}'
फ़ॉर्मैटिंग और वैल्यू के विकल्प के लिए, BusinessMessagesAgent देखें.
जगह की डिफ़ॉल्ट स्थान-भाषा
# 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"
}'
फ़ॉर्मैटिंग और वैल्यू के विकल्पों के लिए, brands.locations देखें.