קבל את זמיןותAgent

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

מאחזר את זמינות הסוכן עבור תור בהתבסס על כללי הניתוב. מפתח ריבוי ערוצים יכול להשתמש ב- API זה כדי לקבוע אם אפשרות התחל שיחה צריכה להיות גלויה ללקוח וגם להצגת מידע כגון זמן המתנה ומיקום בתורים.

הערה

• הקשב לאירוע lcw:ready שהועלה על ידי צ'אט חי לפני שתתקשר לשיטות ה-SDK של הצ'אט החי. ניתן להפעיל את שיטות הצ'אט החי לאחר העלאת האירוע lcw:ready . אתה יכול להאזין לאירוע זה על ידי הוספת מאזין אירוע משלך לאובייקט החלון.
• ניתן לקרוא לשיטה זו מספר פעמים מצד הלקוח כאשר קלט הלקוח משתנה. המטמון בצד הלקוח מתרענן כל 2 דקות או כאשר הפרמטרים של הקשר הלקוח משתנים.
• ניתן לקרוא לשיטה זו 100 פעמים בדקה לכל ארגון בלבד. אם תחרוג מהמגבלה, תראה את קוד מצב התגובה של http 429 המציין ששלחת בקשות רבות מדי בפרק זמן שצוין.

תחביר

Microsoft.Omnichannel.LiveChatWidget.SDK.getAgentAvailability();

פרמטרים

ללא

ערך החזרה

שם	Type	תיאור
queueId	מחרוזת	תור היעד שבו הבקשה מנותבת בהתבסס על תצורת כלל הניתוב ונתוני הקלט (ערך הישות וההקשר המהווים חלק מכלל הניתוב מסופקים).
isQueueAvailable	בוליאני	מציג: - TRUE אם התור נמצא בשעות הפעילות. - FALSE אם התור נמצא מחוץ לשעות הפעילות.
StartTimeOfNextOperatingHour	תאריך ושעה	שעת ההתחלה (UTC) של שעות הפעילות של התור אם הוא מחוץ לשעות הפעילות. במהלך שעות הפעילות, מוחזר ערך של 01-01-0001.
EndTimeOfNextOperatingHour	תאריך ושעה	השעה (UTC) שבה שעות הפעילות מסתיימות עבור התור אם הוא מחוץ לשעות הפעילות. במהלך שעות הפעילות, מוחזר ערך של 01-01-0001.
nexttransitiontime	תאריך ושעה	השעה (UTC) שבה התור פועל שוב אם הוא מחוץ לשעות הפעילות. השעה שבה התור אינו פעיל מוצגת בשעות הפעילות.
positionInQueue	טלפון	המיקום בתור עבור לקוח הממתין מאחורי לקוחות אחרים באותו תור.
isAgentAvailable	בוליאני	מציג: - TRUE אם סוכנים בתור זמינים כעת לקבל בקשות על סמך כללי ניתוב והקצאה מוגדרים עבור זרם עבודה. ה- API מחזיר true גם אם בוט מצורף לזרם העבודה או לתור. אנו ממליצים לא להשתמש ב-API זה כאשר קיים בוט. - לא נכון אם סוכנים אינם זמינים לקבל בקשות.
averageWaitTime	טלפון	זמן המתנה ממוצע בדקות עבור לקוחות בתור היעד בהתבסס על נתוני 48 השעות האחרונות.

דוגמה

window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
               // Gets the agent availability
               Microsoft.Omnichannel.LiveChatWidget.SDK.getAgentAvailability();
});

העבר ערכי הקשר מותאמים אישית עבור הפונקציה כדי לוודא שההקשר מתקבל

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

הערה

אינך צריך לקרוא לפעולת השירות setContextProvider לפני שתתקשר ל- getAgentAvailability.

הנה קוד לדוגמה שמראה כיצד להשתמש בשיטה setContextProvider .

// To set the custom context, pass the custom context object as input parameter to agent availability

    // provider as part of the logic, so there is no need to set custom context before this call.

    Microsoft.Omnichannel.LiveChatWidget.SDK.getAgentAvailability({

        customContext : {

                'jwtToken': {'value':'token','isDisplayable':true},

                'Email': {'value':'mae.gibbins@contoso.com','isDisplayable':true},

                'client': {'value':'true','isDisplayable':true},

                'Emailing': {'value':'true','isDisplayable':true}

        }

    }

    );

מידע קשור

startChat
setContextProvider
הפניה ל- SDK של צ'אט חי