setContextProvider

'‏‫ריבוי ערוצים‬ לשירות לקוחות' מציע חבילת יכולות המרחיבות את העוצמה של Dynamics 365 Customer Service Enterprise כדי לאפשר לארגונים להתחבר באופן מיידי ולתקשר עם הלקוחות שלהם באמצעות ערוצים להעברת הודעות דיגיטליות. נדרש רישיון נוסף כדי לגשת ל'ריבוי ערוצים עבור Customer Service'. למידע נוסף, עיין בדפים סקירת מחירי Dynamics 365 Customer Service ותוכנית המחירים של Dynamics 365 Customer Service.

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

חשוב

• פעולת השירות setContextProvider נתמכת רק עבור צ'אט לא מאומת. עבור צ'אט מאומת, עליכם להשתמש באסימון האינטרנט של JSON (JWT). מידע נוסף: שליחת אסימוני אימות
• באפשרותך להעביר רק 100 משתני הקשר מותאמים אישית במהלך כל הפעלת צ'אט.
• יש להפעיל את שיטות ה-SDK של הצ'אט החי לאחר העלאת האירוע lcw:ready . אתה יכול להאזין לאירוע זה על ידי הוספת מאזין אירוע משלך לאובייקט החלון.
• אינך צריך להשתמש בשיטה setContextProvider אם אתה משתמש ב-API של startChat SDK כדי להעביר את ההקשר ולאתחל את הפעלת הצ'אט.

תחביר

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 מכילה את הערך של משתני ההקשר.

התכונה isDisplayable , אם מוגדרת ל- true, תציג את הפריטים שהועברו בכרטיסיה השלישית בפקד סיכום שיחה עבור שיחה.

הערה

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

העברת השירות העצמי של הלקוח כהקשר

באפשרותך להעביר את השירות העצמי של הלקוח כהקשר בתחילת שיחה עם לקוח זה. השיטה מעבירה את פעולות הלקוח 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}
         };
    });
});

כדי שקובץ ה- Script לדוגמה יעקוב אחר פעולות שירות עצמי שניתן לכלול בפורטל השירות העצמי, ראה קוד לדוגמה של שירות עצמי.

קודי שגיאה

השגיאה הבאה עשויה להתרחש עבור שיטה זו.

קוד שגיאה	הודעת שגיאה
1	ביצוע פעולת השירות של ספק ההקשר נכשל

מידע קשור

חומר עזר ל- API של JavaScript עבור SDK של צ'אט חי
הצגת הקשר מותאם אישית