इसके माध्यम से साझा किया गया


ग्लोबल वेरिएबल के साथ कार्य करें

चर आपके एजेंट द्वारा पूछे गए प्रश्नों के लिए आपके ग्राहकों की प्रतिक्रियाओं को संग्रहीत करते हैं। उदाहरण के लिए, आप किसी ग्राहक का नाम नामक वेरिएबल में सहेज सकते हैं। UserName इसके बाद एजेंट बातचीत जारी रखते हुए ग्राहक को नाम से संबोधित कर सकता है।

डिफ़ॉल्ट रूप से, किसी चर का मान केवल उस विषय में उपयोग किया जा सकता है जहाँ चर बनाया गया है। हालाँकि, विभिन्न विषयों में समान मान का पुनः उपयोग संभव है। उदाहरण के लिए, स्वागत विषय में ग्राहक का नाम और ईमेल पता पूछा जाता है। अपॉइंटमेंट बुकिंग विषय में, आप चाहते हैं कि एजेंट को याद रहे कि ग्राहक ने क्या दर्ज किया था और वह दोबारा न पूछे।

किसी चर का पुनः उपयोग करने का एक तरीका यह है कि चर को एक विषय से दूसरे विषय में पास किया जाए। दूसरा तरीका यह है कि चर को वैश्विक स्तर पर लागू किया जाए, और इस लेख में इसी पर चर्चा की गई है। वैश्विक चर इसलिए कहलाते हैं क्योंकि वे संपूर्ण एजेंट में सभी विषयों में उपलब्ध होते हैं। इन्हें बाह्य स्रोतों से भी सेट किया जा सकता है।

वैश्विक चर एकल उपयोगकर्ता सत्र के दौरान लागू होते हैं. आप निर्दिष्ट करते हैं कि कौन से चर वैश्विक चर हैं ताकि उन्हें विषय-स्तरीय चर से अलग किया जा सके।

एक वैश्विक चर बनाएँ

आप किसी विषय चर का दायरा बदलकर एक वैश्विक चर बनाते हैं।

नोट

वैश्विक चर का नाम सभी विषयों में अद्वितीय होना चाहिए।

  1. एक चर बनाएँ या एक मौजूदा चर को खोलने के लिए चर पैनल का उपयोग करें .

  2. चर गुण पैनल पर, वैश्विक (कोई भी विषय एक्सेस कर सकता है) का चयन करें.

    चर नाम को विषय-स्तरीय चर से अलग करने के लिए उपसर्ग Global. दिया जाता है। उदाहरण के लिए, चर UserName को Global.UserName के रूप में प्रदर्शित किया जाता है।

  3. विषय को सहेजें.

वैश्विक चर का उपयोग करें

जब आप किसी संदेश नोड या प्रश्न नोड में संदेश लिख रहे हों, तो विषय के लिए उपलब्ध चरों को देखने के लिए {x} आइकन का चयन करें. वैश्विक चर किसी भी विषय चर के साथ कस्टम टैब में दिखाई देते हैं। चरों को वर्णानुक्रम में सूचीबद्ध किया गया है।

वैश्विक चर का उपयोग करके सभी विषय खोजें

आप यह पता लगा सकते हैं कि वैश्विक चर कहां परिभाषित किया गया है और कौन से अन्य विषय इसका उपयोग कर रहे हैं। यह सुविधा तब उपयोगी हो सकती है जब आप किसी नए एजेंट पर काम कर रहे हों, या यदि आपके पास एकाधिक चर और जटिल विषय शाखाएँ हों।

  1. संलेखन कैनवास पर, या चर पैनल में वांछित वैश्विक चर का चयन करें.

  2. चर गुण पैनल पर, संदर्भ अनुभाग में, सभी संदर्भ देखें का चयन करें.

  3. अन्य टैब पर जाएं, और किसी भी विषय का चयन करें जहां चर का उपयोग सीधे उस विषय और नोड पर जाने के लिए किया जाता है।

वैश्विक चर हटाना

यदि आप अन्य विषयों में प्रयुक्त किसी वैश्विक चर को हटाते हैं, तो विषयों में उस चर के संदर्भ को इस रूप में चिह्नित किया जाता है। Unknown इससे पहले कि आप ऑपरेशन की पुष्टि कर सकें, आपको वैश्विक चर को हटाने के बारे में चेतावनी प्राप्त होगी।

जिन नोड्स में हटाए गए वैश्विक चर का संदर्भ होता है, वे संकेत देते हैं कि उनमें एक अज्ञात चर मौजूद है।

हटाए गए वैश्विक चरों के संदर्भ वाले नोड्स वाले विषय काम करना बंद कर सकते हैं। सुनिश्चित करें कि आप अपने एजेंट को प्रकाशित करने से पहले हटाए गए चर का उपयोग करने वाले सभी विषयों को हटा दें या सही कर दें।

वैश्विक चरों का जीवनचक्र

डिफ़ॉल्ट रूप से, वैश्विक चर का मान सत्र समाप्त होने तक बना रहता है। चर मान साफ़ करें नोड वैश्विक चर के मानों को रीसेट करता है और इसका उपयोग वार्तालाप रीसेट करें सिस्टम विषय में किया जाता है। जब कोई पुनर्निर्देशन उस विषय को सक्रिय करता है (या जब उपयोगकर्ता "प्रारंभ करें" जैसे वाक्यांश को दर्ज करता है), तो सभी वैश्विक चर रीसेट हो जाते हैं।

बाह्य स्रोतों से वैश्विक चर सेट करें

यह सुनिश्चित करने के लिए कि एजेंट किसी संदर्भ के साथ बातचीत शुरू करता है, आप एक वैश्विक चर का उपयोग कर सकते हैं और बाहरी स्रोत से उसका मान सेट कर सकते हैं। मान लीजिए कि आपकी साइट को उपयोगकर्ताओं को लॉग इन करना आवश्यक है। यदि आप किसी उपयोगकर्ता का नाम वैश्विक चर में संग्रहीत करते हैं और उसे अपने एजेंट को देते हैं, तो एजेंट ग्राहकों द्वारा अपना पहला प्रश्न लिखने से पहले उनका नाम लेकर अभिवादन कर सकता है। एक अन्य उदाहरण परिदृश्य Dynamics 365 Customer Service से संदर्भ को एजेंट तक पहुंचाना है, ताकि वह इस ज्ञान के साथ बातचीत शुरू कर सके कि ग्राहक क्या हासिल करना चाहता है।

अवांछित विलंब को रोकने के लिए, आप निर्दिष्ट कर सकते हैं कि आपका एजेंट किसी मान के लिए कितनी देर तक प्रतीक्षा कर सकता है। आप एक डिफ़ॉल्ट मान भी सेट कर सकते हैं जिसका उपयोग तब किया जाएगा जब बाह्य स्रोत समय पर प्रतिक्रिया देने में विफल हो जाएगा।

नोट

IVR उपयोग मामलों के लिए Dynamics 365 संपर्क केंद्र चैनल पर प्रकाशित एजेंट, बाहरी स्रोतों द्वारा सेट किए गए वैश्विक चरों के लिए कॉन्फ़िगर किए गए टाइम-आउट मानों का समर्थन नहीं करते हैं.

  1. बाह्य स्रोतों से सेट किए जाने वाले सभी चरों के लिए कॉन्फ़िगरेशन रखने हेतु एक समर्पित विषय बनाएं। उदाहरण के लिए, आप इस विषय का नाम "संदर्भ चर सेट करें" रख सकते हैं। यह विषय किसी अन्य उद्देश्य की पूर्ति नहीं करता है, इसलिए इसमें ट्रिगर वाक्यांश सेट करने की आवश्यकता नहीं है।

  2. अपने समर्पित विषय में एक चर मान सेट करें नोड जोड़ें।

  3. वेरिएबल सेट करें के अंतर्गत, वेरिएबल पिकर खोलें, और नया वेरिएबल बनाएँ का चयन करें.

  4. नये वेरिएबल का डिफ़ॉल्ट नाम चुनें. चर गुण पैनल प्रकट होता है.

  5. डिफ़ॉल्ट नाम को उस नाम से प्रतिस्थापित करें जो बाह्य सिस्टम से पास किए जा रहे वेरिएबल के नाम से बिल्कुल मेल खाता हो।

  6. उपयोग के अंतर्गत, वैश्विक (कोई भी विषय एक्सेस कर सकता है) का चयन करें, और बाहरी स्रोत मान सेट कर सकते हैं का चयन करें।

  7. संदर्भ के अंतर्गत, ऊपरी-दाएं कोने में तीन बिंदुओं () का चयन करें, और खाली होने पर इस नोड से मान प्राप्त करें का चयन करें।

  8. (वैकल्पिक) मिलीसेकंड में टाइम-आउट विलंब सेट करें. यह मान निर्धारित करता है कि आपका एजेंट समय समाप्त होने से पहले और चर मान सेट करें नोड में आपके द्वारा सेट किए गए डिफ़ॉल्ट मान के साथ जारी रखने से पहले, किसी बाह्य स्रोत द्वारा चर सेट किए जाने के लिए कितनी देर तक प्रतीक्षा कर सकता है। यह सेटिंग उन परिदृश्यों में प्रासंगिक है जहां चर लंबे समय से चलने वाली या अतुल्यकालिक प्रक्रिया पर निर्भर करता है, लेकिन आपके एजेंट को एक अच्छा उपयोगकर्ता अनुभव सुनिश्चित करने के लिए अधिकतम विलंबता का सम्मान करना चाहिए।

    ग्राहक सेवा के लिए ओमनीचैनल से आने वाले चरों के लिए, हम अधिकतम प्रतीक्षा समय के रूप में 10 सेकंड (10,000 ms) का मान सुझाते हैं.

  9. चर मान सेट करें नोड में, समय समाप्त होने पर उपयोग करने के लिए डिफ़ॉल्ट मान दर्ज करें। रनटाइम पर, आपका एजेंट समान डेटा प्रकार वाले मानों की अपेक्षा करेगा. यदि आप चाहते हैं कि यह डिफ़ॉल्ट मान एक रिक्त स्ट्रिंग हो, तो सूत्र के रूप में Text("") का उपयोग करें।

    किसी बाह्य स्रोत से सेट किए जाने वाले वैश्विक चर के लिए कॉन्फ़िगरेशन का स्क्रीनशॉट.

  10. किसी भी अन्य मान के लिए जिसे आप बाहरी सिस्टम से आने की उम्मीद करते हैं, अपने समर्पित विषय में अधिक चर मान सेट करें नोड्स जोड़ें, और आवश्यक वैश्विक चर को उसी तरीके से कॉन्फ़िगर करें।

इस प्रकार कॉन्फ़िगर होने के बाद, आपका एजेंट परीक्षण के लिए तैयार है। जब एजेंट को बुलाया जाता है, तो सभी चरों के पॉप्युलेट होने के लिए अनिश्चित काल तक प्रतीक्षा करने के बजाय, आपका एजेंट तुरंत कोई भी संदेश भेजना शुरू कर सकता है जो पास किए जा रहे चरों पर निर्भर नहीं हैं। जब आपका एजेंट किसी ऐसे चर तक पहुंचने का प्रयास करता है जिसे बाहरी रूप से सेट किया जा रहा है, तो वह तब तक रुका रहता है जब तक कि मान नहीं आ जाता या टाइम-आउट नहीं हो जाता। विलंबता को न्यूनतम करने के लिए एजेंटों को अनुकूलित करने के बारे में अधिक जानें।

महत्त्वपूर्ण

बातचीत के सामान्य प्रवाह के दौरान, यदि आपका एजेंट कोई ऐसा चर निर्धारित करता है जो अन्यथा किसी बाह्य मान के लिए आता है, तो आपके एजेंट द्वारा निर्धारित किया गया मान ही मान्य होता है। संदर्भ में पारित किसी भी मान को नजरअंदाज कर दिया जाता है। यह नियम आपके एजेंट को विषयों में जानबूझकर सेट किए गए मानों को अधिलेखित करने से रोकता है।

एम्बेडेड एजेंट में वैश्विक वैरिएबल सेट करें

यदि आप अपने एजेंट को एक साधारण वेब पेज में एम्बेड कर रहे हैं, तो आप एजेंट के URL में वेरिएबल और उनकी परिभाषाएँ जोड़ सकते हैं। या, यदि आप थोड़ा और अधिक नियंत्रण चाहते हैं, तो आप प्रोग्रामेटिक रूप से वेरिएबल्स को कॉल करने और उपयोग करने के लिए <script> कोड ब्लॉक का उपयोग कर सकते हैं।

URL की क्वेरी स्ट्रिंग में वेरिएबल नाम Global. उपसर्ग के बिना वैश्विक वेरिएबल के नाम से मेल खाना चाहिए। उदाहरण के लिए, एक वैश्विक चर Global.UserName को क्वेरी में UserName के रूप में संदर्भित किया जाएगा।

निम्नलिखित उदाहरण चरों के लिए एक बुनियादी घोषणा का उपयोग करते हैं। उत्पादन परिदृश्य में, आप क्वेरी पैरामीटर या वैरिएबल परिभाषा के रूप में कोई अन्य वैरिएबल पास कर सकते हैं जो पहले से ही उपयोगकर्ता का नाम संग्रहीत करता है (उदाहरण के लिए, यदि आपके पास साइन-इन स्क्रिप्ट से उपयोगकर्ता नाम है)।

एजेंट के URL में वेरिएबल्स और उनकी परिभाषाओं को क्वेरी स्ट्रिंग पैरामीटर्स प्रारूप botURL?variableName1=variableDefinition1&variableName2=variableDefinition2 के रूप में जोड़ें.

उदाहरण के लिए:

  • आपके पास Global.UserName नामक एक वैश्विक चर है.
  • आपके एजेंट का URL https://web.powerva.microsoft.com/webchat/bots/12345 है.
  • अपनी वेबसाइट पर एजेंट वार्तालाप शुरू करते समय उपयोगकर्ता का नाम पास करने के लिए, UserName= क्वेरी स्ट्रिंग को इस प्रकार संलग्न करें: https://web.powerva.microsoft.com/webchat/bots/12345?UserName=Ana.

पैरामीटर नाम अक्षर-संवेदी होता है. username=Ana इस उदाहरण में भी काम करेगा.

कस्टम कैनवास में वैश्विक वैरिएबल जोड़ें

आप वेरिएबल को कस्टम कैनवास में भी जोड़ सकते हैं.

  1. पृष्ठ पर <script> अनुभाग में, जहां आपका एजेंट है, चर को निम्नानुसार परिभाषित करें, variableName1 उपसर्ग के बिना चर नाम के लिए Global. और परिभाषा के लिए variableDefinition1 प्रतिस्थापित करें। एकाधिक चरों को अल्पविराम (,) से अलग करें.

       const store = WebChat.createStore({}, ({ dispatch }) => next => action => {
         if (action.type === 'DIRECT_LINE/CONNECT_FULFILLED') {
           dispatch({
              type: "WEB_CHAT/SEND_EVENT",
              payload: {
                name: "pvaSetContext",
                value: {
                   "variableName1": "variableDefinition1",
                   "variableName2": "variableDefinition2"
                }
              },
            });
          }
            return next(action);
        });
    
  2. अपने <script> अनुभाग में, जब आप अपने एजेंट को एम्बेड करते हैं, तो store को कॉल करें, जैसा कि निम्नलिखित उदाहरण में है जहाँ store को जहाँ styleOptions को कॉल करने से ठीक पहले कॉल किया जाता है (आपको BOT_ID को अपने एजेंट की आईडी से बदलना होगा):

    const BOT_ID = "12345-5678";
    const theURL = "https://powerva.microsoft.com/api/botmanagement/v1/directline/directlinetoken?botId=" + BOT_ID;
    
    fetch(theURL)
        .then(response => response.json())
        .then(conversationInfo => {
            window.WebChat.renderWebChat(
                {
                    directLine: window.WebChat.createDirectLine({
                        token: conversationInfo.token,
                    }),
                    store,
                    styleOptions
                },
                document.getElementById('webchat')
            );
        })
        .catch(err => console.error("An error occurred: " + err));
    

एजेंट के प्रमाणीकरण सेटअप के आधार पर, आपके पास चयनित प्रमाणीकरण प्रदाता से संबद्ध वैश्विक चरों का एक सेट होता है। कौन से चर उपलब्ध हैं और उनका उपयोग कैसे करें, इसके बारे में विवरण के लिए, विषयों में उपयोगकर्ता प्रमाणीकरण जोड़ें देखें।