שליחת הקשר מותאם אישית במהלך צ'אט חי

ההקשר המותאם אישית הוא אוסף של זוגות מפתחות או ערכים. רק ערכים פרימיטיביים מותרים לכל מפתח. המפתחות חייבים להתאים למשתני הקשר שנוצרים עבור זרם העבודה המשויך. אם לא נוצרו משתני הקשר תחת זרם עבודה חי עם שם לוגי תואם, משתנים נוצרים בזמן ריצה בהנחה שהסוג הוא מחרוזת. ספק ההקשר המותאם אישית יופעל על-ידי הרכיב הגרפי של הצ'אט החי בעת הפעלת צ'אט חדש. מכיוון שהערכים תלויי רישיות, השתמש בהתאמה מדויקת כדי להעביר אותם למשתני ההקשר. מידע נוסף: שיקולים עבור משתני הקשר

חשוב

• לצ'אט מאומת, ניתן גם להעביר הקשר ב-JSON Web Token (JWT). מידע נוסף: שליחת אסימוני אימות.
• באפשרותך להעביר רק 100 משתני הקשר מותאמים אישית במהלך כל הפעלת צ'אט.

כאשר לקוח מתחיל צ'אט מהפורטל, באפשרותך להעביר הקשר מותאם אישית לריבוי ערוצים עבור Customer Service. ניתן להשתמש בהקשר מותאם אישית זה כדי להציג מידע בממשק המשתמש וכדי ליצור כללי ניתוב שבסופו של דבר קובעים את התור שאליו עליך לנתב את הצ'אטים.

בצע את השלבים הבאים כדי לשלוח הקשר מותאם אישית כשאתה מתחיל צ'אט:

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
חומר עזר בנושא API של JavaScript של SDK בצ'אט חי
קביעת תצורה של משתני הקשר עבור בוט