setContextProvider

تعرض القناة متعددة الاتجاهات لـ Customer Service مجموعة من الإمكانات التي توسع قدرة Dynamics 365 Customer Service Enterprise لتمكين المؤسسات من الاتصال والتفاعل مع عملائها على الفور عبر قنوات المراسلة الرقمية. مطلوب ترخيص إضافي للوصول إلى القناة متعددة الاتجاهات لـ Customer Service. لمزيد من المعلومات، راجع نظرة عامة على تسعير Dynamics 365 Customer Service وصفحات خطة تسعير Dynamics 365 Customer Service.

يعين موفر السياق لقنوات المحادثة المباشرة. تقوم وظيفة موفر السياق، عند استدعاؤها، بإرجاع السياق المراد استخدامه لتهيئة جلسة محادثة.

هام

• يتم دعم طريقة setContextProvider فقط للدردشة غير المصادق عليها. بالنسبة للدردشة المصادق عليها، يجب عليك استخدام رمز الويب المميز ل JSON (JWT). مزيد من المعلومات: إرسال رموز المصادقة المميزة
• يمكنك تمرير 100 متغير سياق مخصص فقط خلال كل جلسة دردشة.
• يجب استدعاء أساليب SDK للدردشة المباشرة بعد رفع الحدث lcw:ready . يمكنك الاستماع إلى هذا الحدث عن طريق إضافة مستمع الحدث الخاص بك على كائن النافذة.
• لا تحتاج إلى استخدام الطريقة setContextProvider إذا كنت تستخدم startChat واجهة برمجة تطبيقات SDK لتمرير السياق وتهيئة جلسة الدردشة.

إعراب

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

المعلمات

المعلمة‬	نوع	الوصف
contextProvider	الدالة	الدالة التي عند استدعاؤها، ترجع السياق المخصص

قيمة الإرجاع

None

مثال

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 على قيمة متغيرات السياق.

ستعرض السمة isDisplayable ، إذا تم تعيينها إلى true، العناصر التي تم تمريرها في علامة التبويب الثالثة في عنصر تحكم ملخص المحادثة لمحادثة.

إشعار

إذا لم يتم إنشاء أي متغيرات سياق ضمن دفق العمل المباشر باسم منطقي مطابق، إنشاء المتغيرات في وقت التشغيل باستخدام النوع String. مزيد من المعلومات: متغيرات السياق

تمرير الخدمة الذاتية للعميل كسياق

يمكنك تمرير الخدمة الذاتية للعميل كسياق في بداية محادثة مع هذا العميل. 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	فشل تنفيذ أسلوب موفر السياق

المعلومات ذات الصلة

مرجع واجهة برمجة تطبيقات JavaScript لحزمة تطوير البرامج (SDK) للدردشة المباشرة
عرض سياق مخصص