स्थानीय भाषा और स्थान-भाषा

उपयोगकर्ता अलग-अलग जगहों से और अलग-अलग भाषाओं में बातचीत करते हैं. उपयोगकर्ताओं की बातचीत की प्राथमिकताओं के हिसाब से काम करने वाले और उनके अनुभव को स्थानीय भाषा में उपलब्ध कराने वाले एजेंट, ज़्यादा उपयोगकर्ताओं तक पहुंचते हैं. साथ ही, वे उपयोगकर्ताओं को बेहतर अनुभव देते हैं और बार-बार होने वाली बातचीत को बढ़ावा देते हैं. ऐसा उन एजेंट के मुकाबले होता है जो उपयोगकर्ताओं की प्राथमिकताओं के हिसाब से काम नहीं करते. Business Messages की मदद से, एजेंट और कारोबार की जगहें, लोगों की प्राथमिकताओं के हिसाब से जवाब दे सकती हैं. इसके लिए, एजेंट को उपयोगकर्ता की स्थान-भाषा की सेटिंग पास की जाती हैं. इससे एजेंट, हर स्थान-भाषा के लिए डिफ़ॉल्ट स्थान-भाषा और बातचीत की यूनीक सेटिंग तय कर सकते हैं. साथ ही, लोगों की स्थान-भाषाओं और एजेंट या कारोबार की जगह की ओर से इस्तेमाल की जाने वाली स्थान-भाषाओं के बीच के अंतर को ठीक किया जा सकता है.

लोकल का पता लगाकर, 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, बातचीत की सेटिंग (जैसे, वेलकम मैसेज और ऑफ़लाइन मैसेज) और स्ट्रिंग (जैसे, लाइव एजेंट से बातचीत करने का अनुरोध करने का सुझाव स्ट्रिंग) को दिखाने के लिए, तय की गई भाषा का इस्तेमाल करता है. एजेंट के लिए यह सबसे सही तरीका है कि वह समस्या हल होने के बाद, उसी भाषा में बातचीत करे जिसमें समस्या हल की गई थी. इससे उपयोगकर्ताओं को एक जैसा अनुभव मिलता है.

अगर उपयोगकर्ता डिवाइस की भाषा बदलता है या ऐसे डिवाइसों के बीच स्विच करता है जिनकी स्थान-भाषा की सेटिंग अलग-अलग हैं, तो बातचीत के दौरान स्थान-भाषा बदल सकती है. एजेंट को यह देखना चाहिए कि हर नए मैसेज के साथ वैल्यू बदली है या नहीं. अगर वैल्यू बदली है, तो उसे उसके हिसाब से जवाब देना चाहिए. उदाहरण के लिए, कोई एजेंट स्थान-भाषा में हुए बदलाव का पता लगा सकता है. इसके बाद, वह उपयोगकर्ता से पूछ सकता है कि क्या उसे मौजूदा भाषा में बातचीत जारी रखनी है या नई स्थान-भाषा से मेल खाने वाली भाषा पर स्विच करना है.

डिफ़ॉल्ट स्थान-भाषा अपडेट करना

डिफ़ॉल्ट स्थान-भाषा सेट करने के लिए, Business Communications API की मदद से PATCH अनुरोध करें. इससे एजेंट या जगह की जानकारी के defaultLocale फ़ील्ड को अपडेट किया जा सकता है.

किसी स्थान-भाषा के लिए, एजेंट या जगह की बातचीत की सेटिंग अपडेट करने के लिए, बातचीत शुरू करना लेख पढ़ें. जैसे, स्वागत संदेश और बातचीत शुरू करने के लिए सुझाव.

ज़रूरी शर्तें

डिफ़ॉल्ट स्थान-भाषा अपडेट करने से पहले, आपके पास ये चीज़ें होनी चाहिए:

  • आपकी डेवलपमेंट मशीन पर, आपके 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 देखें.