נקודות קצה של פעילות הסוכן

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

[
  {
    "id": 0,
    "agent_id": 0,
    "whodunnit": {
      "id": 0,
      "name": "string",
      "last_name": "string",
      "first_name": "string",
      "agent_number": "string",
      "avatar_url": "string"
    },
    "status": {
      "id": 0,
      "name": "string",
      "color": "string"
    },
    "started_at": "2018-06-06T21:12:24.766Z",
    "ended_at": "2018-06-06T21:12:24.766Z",
    "duration": 0,
    "activity": "login",
    "call_id": 0,
    "chat_id": 0
  }
]

בטבלה הבאה מופיע סיכום של כל הפעילויות שיכולות לגרום ליצירה של יומן פעילות.

פעילות	תיאור
chat_picked_up	אירוע שמתרחש כשנציג מרים את הטלפון
chat_pick_up_attempt	אירוע שמתרחש כשסוכן מנסה להפוך לסוכן המשיב
chat_notification_offered	אירוע שמתרחש כשמשתמש קצה מבקש סשן צ'אט ונשלחת התראה לסוכנים שהוקצו לתור הזה.
call_notification_offered	אירוע שמתרחש כשמשתמש קצה מתקשר וסוכן מקבל התראה על שיחה מסוג multicast או deltacast.
call_pick_up_attempt	אירוע שמתרחש כשסוכן מנסה לענות לשיחה מסוג מולטיקאסט או דלתאקאסט.
call_picked_up	אירוע שמתרחש כשסוכן עונה לשיחה מסוג multicast או deltacast.
deltacast_call_notification_offered	אירוע שמציין שמשתמש קצה התקשר לתור עם שידור מרובה כתובות, ואז שיחת deltacast משודרת לסוכן בתור הזה.
deltacast_call_pick_up_attempt	אירוע שמתרחש כשסוכן מנסה לענות לשיחה שמועברת באמצעות DeltaCasted
deltacast_call_picked_up	אירוע שמתרחש כשסוכן עונה בהצלחה לשיחה שמועברת באמצעות דלתאקאסט.
deltacast_call_missed	אירוע שמתרחש כשסוכן לא עונה לשיחה שמועברת אליו באמצעות DeltaCast
multicast_call_notification_offered	אירוע שמציין שמשתמש קצה התקשר לתור עם שידור מרובה משתתפים, ואז השיחה משודרת לסוכנים בתור הזה
multicast_call_pick_up_attempt	אירוע שמתרחש כשסוכן מנסה לענות לשיחה שמועברת למספר נמענים
multicast_call_picked_up	אירוע שמתרחש כשסוכן עונה לשיחה שמועברת למספר נמענים
call_outbound_dialing	אירוע שמתרחש כשסוכן משתמש בחייגן בווידג'ט כדי להתקשר למשתמש קצה.
user_status_changed	אירוע שמתרחש כשנציג משנה את המצב של הווידג'ט שלו
login	אירוע שמתרחש כשנציג מתנתק מהווידג'ט
התנתקות	אירוע שמתרחש כשנציג מתחבר לווידג'ט

יומני פעילות של סוכנים

פרמטר	חובה	סוג הנתונים	הגדרה
sort_column	לא נכון	String	מיון התגובה על סמך שדה כלשהו באובייקט התגובה.
sort_direction	לא נכון	‫ASC או DESC	הערה לגבי כיוון המיון, בסדר עולה או יורד
ייפתח	לא נכון	String	התאמה לכל דף כדי לציין את מספר הדף של הרשומות. לדוגמה, אם הערך של per הוא 200 והערך של page הוא 2, התגובה תכיל את רשומות 201 עד 400, כי page 1 יכיל את רשומות 1 עד 200.
לכל	לא נכון	String	השדה הזה משויך לדף ומציין כמה רשומות ייכללו בדף של רשומות. לדוגמה, אם הערך של per הוא 200 והערך של page הוא 2, התגובה תכיל את רשומות 201 עד 400, כי דף 1 יכיל את רשומות 1 עד 200.
started_at[from]	לא נכון	השעה לפי שעון UTC	יוצרת גבול תחתון לשדה started at. כל הרשומות שיוחזרו יהיו אחרי הערך שהוזן.
started_at[to]	לא נכון	השעה לפי שעון UTC	יוצר גבול עליון של השדה started at. כל הרשומות שיוחזרו יהיו לפני הערך שהוזן.
ended_at[from]	לא נכון	השעה לפי שעון UTC	יוצרת גבול תחתון של השדה ended at. כל הרשומות שיוחזרו יהיו אחרי הערך שהוזן.
ended_at[to]	לא נכון	השעה לפי שעון UTC	יוצרת גבול עליון של השדה 'הסתיים ב'. כל הרשומות שיוחזרו יהיו לפני הערך שהוזן.
duration[from]	לא נכון	מספר	יוצרת גבול תחתון של שדה משך הזמן. כל הרשומות שיוחזרו יהיו אחרי הערך שהוזן.
duration[to]	לא נכון	מספר	יוצר גבול עליון לשדה משך הזמן. כל הרשומות שיוחזרו יהיו לפני הערך שהוזן.
id[]	לא נכון	Array[String]	‫Array[Strings]. מזהה הרשומות שרוצים לחפש ולהחזיר
agent_id[]	לא נכון	Array[String]	סינון התשובה לפי מזהה הסוכן
activity[]	לא נכון	Array[String]	מסננים את הרשומות לפי המשימה או הפעילות שהסוכן ביצע. הערכים האפשריים הם: login, logout, call_outbound_dialing, deltacast_call_notification_offered, deltacast_call_pick_up_attempt, deltacast_call_picked_up, deltacast_call_projected, deltacast_call_missed, deltacast_call_bounced, multicast_call_notification_offered, multicast_call_pick_up_attempt, multicast_call_picked_up, user_status_changed, chat_notification_offered, chat_pick_up_attempt, chat_picked_up
whodunnit_id[]	לא נכון	Array[String]	סינון התשובה לפי מזהה הסוכן. האובייקט Whodunnit הוא קבוצת משנה של אובייקט הסוכן, והוא משתמש באותו agent_id כמפתח הראשי שלו
call_id[]	לא נכון	Array[String]	סינון הרשומות לפי מזהי שיחות שהוזנו
chat_id[]	לא נכון	Array[String]	סינון הרשומות לפי מזהי הצ'אטים שהוזנו

נקודת קצה (endpoint):

Method: GET
Type: 
URL: https://{​{subdomain}​}.{​{domain}​}/manager/api/v1/agent_activity_logs

דוגמאות נוספות לבקשות ולתשובות:

דוגמה לבקשה: דוגמה ליומני פעילות של סוכנים

Body: None

דוגמה לתגובה: דוגמה ליומני פעילות של סוכן

[
    {
        "id": 190578,
        "agent_id": 118,
        "status": {
            "id": -10,
            "name": "Offline",
            "color": "grey",
        },
        "started_at": "2017-12-22T00:54:18.000Z",
        "ended_at": null,
        "duration": 0,
        "call_id": null,
        "chat_id": null,
        "activity": "logout",
        "whodunnit": null
    },
    {
        "id": 199548,
        "agent_id": 118,
        "status": {
            "id": -10,
            "name": "Offline",
            "color": "grey",
        },
        "started_at": "2018-01-09T22:54:26.000Z",
        "ended_at": null,
        "duration": 0,
        "call_id": null,
        "chat_id": null,
        "activity": "logout",
        "whodunnit": null
    },
    {
        "id": 190577,
        "agent_id": 118,
        "status": {
            "id": -10,
            "name": "Offline",
            "color": "grey",
        },
        "started_at": "2017-12-22T00:54:18.000Z",
        "ended_at": "2018-01-08T22:54:22.000Z",
        "duration": 1548004,
        "call_id": null,
        "chat_id": null,
        "activity": "user_status_changed",
        "whodunnit": null
    },
    {
        "id": 199547,
        "agent_id": 118,
        "status": {
            "id": -10,
            "name": "Offline",
            "color": "grey",
        },
        "started_at": "2018-01-09T22:54:26.000Z",
        "ended_at": null,
        "duration": 0,
        "call_id": null,
        "chat_id": null,
        "activity": "user_status_changed",
        "whodunnit": null
    },
    {
        "id": 190270,
        "agent_id": 118,
        "status": {
            "id": -1,
            "name": "Unavailable",
            "color": "red",
        },
        "started_at": "2017-12-21T21:34:14.000Z",
        "ended_at": "2017-12-22T00:54:18.000Z",
        "duration": 12004,
        "call_id": null,
        "chat_id": null,
        "activity": "user_status_changed",
        "whodunnit": null
    },
    {
        "id": 198036,
        "agent_id": 118,
        "status": {
            "id": -1,
            "name": "Unavailable",
            "color": "red",
        },
        "started_at": "2018-01-08T22:54:22.000Z",
        "ended_at": "2018-01-09T22:54:26.000Z",
        "duration": 86404,
        "call_id": null,
        "chat_id": null,
        "activity": "user_status_changed",
        "whodunnit": null
    },
    {
        "id": 22249,
        "agent_id": 129,
        "status": {
            "id": -10,
            "name": "Offline",
            "color": "grey",
        },
        "started_at": "2017-06-19T18:34:39.000Z",
        "ended_at": null,
        "duration": 0,
        "call_id": null,
        "chat_id": null,
        "activity": "login",
        "whodunnit": null
    }
]

קוד הסטטוס: 200