setContextProvider

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

लाइव चैट चैनलों के लिए संदर्भ प्रदाता सेट करता है। संदर्भ प्रदाता फ़ंक्शन, जब आह्वान किया जाता है, तो चैट सत्र को प्रारंभ करने के लिए उपयोग किए जाने वाले संदर्भ को लौटाता है।

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

  • setContextProvider विधि केवल अनधिकृत चैट के लिए समर्थित है। प्रमाणित चैट के लिए, आपको JSON वेब टोकन (JWT) का उपयोग करना होगा। अधिक जानकारी: प्रमाणीकरण टोकन भेजें
  • आप प्रत्येक चैट सत्र के दौरान केवल 100 कस्टम संदर्भ चर पास कर सकते हैं।
  • लाइव चैट एसडीके विधियों को एलसीडब्ल्यू: रेडी इवेंट उठाए जाने के बाद लागू किया जाना चाहिए। आप विंडो ऑब्जेक्ट पर अपना स्वयं का ईवेंट श्रोता जोड़कर इस ईवेंट को सुन सकते हैं।
  • यदि आप संदर्भ को पास करने और चैट सत्र को प्रारंभ करने के setContextProvider लिए एसडीके एपीआई का उपयोग कर रहे हैं तो आपको विधि का उपयोग startChat करने की आवश्यकता नहीं है।

सिंटैक्स

Microsoft.Omnichannel.LiveChatWidget.SDK.setContextProvider(contextProvider);

पैरामीटर्स

मापदंड Type विवरण
संदर्भप्रदाता फलन फ़ंक्शन जो आह्वान किए जाने पर, कस्टम संदर्भ लौटाता है

मान देता है

कोई नहीं

उदाहरण

window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
        // Set the custom context provider
        // Throws error if contextProvider is not a function
        Microsoft.Omnichannel.LiveChatWidget.SDK.setContextProvider(function contextProvider(){
                   //Here it is assumed that the corresponding work stream would have context variables with logical name of 'contextKey1', 'contextKey2', 'contextKey3'. If no context variable exists with a matching logical name, items are created assuming Type:string               
	               return {
                             'contextKey1': {'value': 'contextValue1', 'isDisplayable': true},
                             'contextKey2': {'value': 12.34, 'isDisplayable': false},
                             'contextKey3': {'value': true}
                   };
        });
});

पूर्ववर्ती नमूना कोड में, विशेषता में value संदर्भ चर का मान होता है।

विशेषता, यदि सेट की जाती है isDisplayabletrue, तो पास किए गए आइटम को वार्तालाप के लिए वार्तालाप सारांश नियंत्रण पर तीसरे टैब में प्रदर्शित करेगा.

नोट

यदि मिलान तार्किक नाम के साथ लाइव वर्कस्ट्रीम के तहत कोई संदर्भ चर नहीं बनाया गया है, तो चर स्ट्रिंग प्रकार के साथ रनटाइम पर बनाए जाते हैं। अधिक जानकारी: संदर्भ चर

प्रसंग कुंजियाँ प्रदर्शित करें.

संदर्भ के रूप में ग्राहक की स्वयं सेवा पास करें

आप उस ग्राहक के साथ वार्तालाप की शुरुआत में संदर्भ के रूप में ग्राहक की स्वयं सेवा पास कर सकते हैं. setContextProvider विधि ग्राहक और एजेंट के बीच एक नई बातचीत के लिए, स्वयं सेवा प्रकार के संदर्भ के हिस्से के रूप में हाल ही में ग्राहक कार्यों को पास करती है। प्रत्येक स्वयं सेवा कार्रवाई के लिए एक आगंतुक यात्रा रिकॉर्ड बनाया जाता है।

यहां एक नमूना कोड है जो दिखाता है कि विधि का उपयोग setContextProvider कैसे करें।

window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){

Microsoft.Omnichannel.LiveChatWidget.SDK.setContextProvider(function contextProvider(){
    return {
            'SelfService': { 'value' : 
                '[ {"msdyn_displaytitle":"Page visited", "msdyn_starttime":"yyyy-mm-ddThh:mm:ssZ","msdyn_type":192350000}, \
                   {"msdyn_displaytitle":"Phrase searched", "msdyn_starttime":"yyyy-mm-ddThh:mm:ssZ","msdyn_type":192350001}, \
                   {"msdyn_displaytitle":"Knowledge article viewed", "msdyn_starttime":"yyyy-mm-ddThh:mm:ssZ","msdyn_type":192350002}, \
                   {"msdyn_displaytitle":"Custom action performed", "msdyn_starttime":"yyyy-mm-ddThh:mm:ssZ","msdyn_type":192350003} \
                 ]'
             }, // Additional context can be added as shown below
                //Here it is assumed that the corresponding work stream would have context variables with logical name of 'contextKey1', 'contextKey2', 'contextKey3'. If no context variable exists with a matching logical name, items are created assuming Type:string
                'contextKey1': {'value': 'contextValue1', 'isDisplayable': true},
                'contextKey2': {'value': 12.34, 'isDisplayable': false},
                'contextKey3': {'value': true}
         };
    });
});

स्वयं सेवा क्रियाओं को ट्रैक करने के लिए नमूना स्क्रिप्ट के लिए जिन्हें स्वयं सेवा पोर्टल में शामिल किया जा सकता है, स्वयं सेवा नमूना कोड देखें।

त्रुटि कोड

इस विधि के लिए निम्न त्रुटि उत्पन्न कर सकते हैं।

त्रुटी कोड त्रुटि संदेश
1 प्रसंग प्रदाता विधि निष्पादन विफल रहा

लाइव चैट SDK टूल के लिए JavaScript API संदर्भ
कस्टम संदर्भ प्रदर्शित करें