إرسال سياق مخصص أثناء المحادثة المباشرة

السياق المخصص عبارة عن مجموعة من أزواج المفاتيح أو القيم. يسمح فقط بالقيم الأولية لأي مفتاح. يجب أن تتوافق المفاتيح مع متغيرات السياق التي تم إنشاؤها لدفق العمل المقترن. إذا لم يتم إنشاء أي متغيرات سياق ضمن دفق العمل المباشر باسم منطقي مطابق، يتم إنشاء المتغيرات في وقت التشغيل بافتراض النوع على أنه سلسلة. سيتم استدعاء موفر السياق المخصص بواسطة أداة المحادثة المباشرة عند بدء محادثة جديدة. نظرا لأن القيم حساسة لحالة الأحرف، استخدم المطابقة التامة لتمريرها إلى متغيرات السياق. مزيد من المعلومات: اعتبارات متغيرات السياق

هام

• بالنسبة للدردشة المصادقة، يمكنك أيضا تمرير السياق في رمز الويب JSON (JWT). تعرف على المزيد في إرسال رموز المصادقة المميزة.
• يمكنك تمرير 100 متغير سياق مخصص فقط خلال كل جلسة دردشة.

عندما يبدأ العميل محادثة من البوابة، يمكنك تمرير سياق مخصص إلى Dynamics 365 Contact Center. يمكن استخدام هذا السياق المخصص لعرض المعلومات على واجهة المستخدم وإنشاء قواعد التوجيه التي تحدد في النهاية قائمة الانتظار التي يجب عليك توجيه الدردشات إليها.

اتبع هذه الخطوات لإرسال سياق مخصص عند بدء محادثة:

1. يجب استدعاء أساليب SDK للدردشة المباشرة بعد رفع حدث lcw:ready . يمكنك الاستماع إلى هذا الحدث عن طريق إضافة مستمع الحدث الخاص بك على كائن النافذة.
2. بعد رفع الحدث lcw:ready ، قم بتسجيل موفر سياق مخصص باستخدام المحادثة المباشرة باستخدام طريقة setContextProvider .
3. ابدأ الدردشة باستخدام طريقة startChat .

نموذج التعليمات البرمجية

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': 'contextValue1', // string value
			'contextKey2': 12.34, // number value
			'contextKey3': true // boolean value
	};
}

window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
	// Handle LiveChat Ready event
	// SDK methods are ready for use now
	// Setting custom context provider to be used with Chat for Dynamics 365
	// The custom context provided by custom context provider can be used for routing the chat to a particular queue
	Microsoft.Omnichannel.LiveChatWidget.SDK.setContextProvider(contextProvider);
	// Starting a new chat
	Microsoft.Omnichannel.LiveChatWidget.SDK.startChat();
});

window.addEventListener("lcw:error", function handleLivechatErrorEvent(errorEvent){
	// Handle LiveChat SDK error event
	console.log(errorEvent);
});

للحصول على معلومات حول كيفية عرض متغيرات السياق في ملخص المحادثة، راجع عرض السياق المخصص.

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

setContextProvider
getContextProvider
removeContextProvider
مرجع واجهة برمجة تطبيقات JavaScript لحزمة تطوير البرامج (SDK) للدردشة المباشرة
تكوين متغيرات السياق لروبوت