getConversations

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

ניתן להשתמש בפונקציה זו כדי להביא רשימה של רשומות שיחה (msdyn_ocliveworkitem) עבור סוכן.

תחביר

Microsoft.Omnichannel.getConversations(input, correlationId);

פרמטרים

פרמטר סוג תיאור‬‏‫‬
קלט String קלט JSON. יש לו את הפורמט הבא:
{attributes, agentID, status, orderBy, createdBeforeDays}
כאשר:
  • attributesהוא מערך של מחרוזות המכילות שמות תכונות ישות
  • agentId היא מחרוזת המכילה מזהה ייחודי עבור הסוכן
  • status הוא מערך של מחרוזות עם ערכים המופרדים באמצעות פסיקים
  • orderBy הוא מערך של אובייקטים בתבנית:
    [{ attributeName: "<Attribute_Name>" descending:<בוליאני>}]
  • createdBeforeDaysהוא מספר הימים מאז יצירת השיחה

זהו agentId משתנה הקלט היחיד הנדרש והשאר הם אופציונליים.
correlationId String אופציונלי. מזהה ייחודי לרישום מדידת שימוש.

ערך החזרה

החזרת הבטחה שנפתרה או נדחתה בהתבסס על תוצאת הפעולה.

הערה

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

  • msdyn_ocliveworkitemid
  • msdyn_liveworkstreamid
  • msdyn_lastsessionid
  • סטטוסקוד
  • CreatedOn

דוגמה

מקטע הקוד הבא מביא את השיחה הממתינה כעת עבור מזהה הסוכן הנתון.

var input = { 
    "attributes": [
        "msdyn_title",
        "msdyn_channel"
        ],
    "agentId": "2b330c52-6844-4d36-8e05-03c78c9681dc",
    "status": [3], 
    "orderBy": [
        { 
            "attributeName": "createdon",
            "descending": true
        }
    ]
};
Microsoft.Omnichannel.getConversations(input).then(result => {
    console.log("result is as:", result); 
    }, (error) => {
        console.log("error is as:", error); 
    }
);

חומר עזר בנושא SDK של צ'אט חי
חומר עזר בנושא API של JavaScript בריבוי ערוצים
getConversationId
linkToConversation
unlinkFromConversation
openConversation
sendMessageToConversation