代理程式活動端點

只要小工具的狀態有任何變更，系統就會建立代理活動記錄。可能是登入小工具、收到 DeltaCast 通話通知，或是接聽通話等其他狀態。每項活動都會建立新的物件。請參閱下列模型，確認哪些欄位可能含有 (PII)：

[
  {
    "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	當使用者撥打電話，且系統向服務專員提供多播或 DeltaCast 通話通知時，就會發生這個事件。
call_pick_up_attempt	代理程式嘗試接聽多播或 DeltaCast 通話時發生的事件。
call_picked_up	當代理程式接聽多播或 Delta 播送通話時發生的事件。
deltacast_call_notification_offered	此事件會記錄使用者已透過多點傳播呼叫佇列，然後系統會將 DeltaCast 呼叫廣播給該佇列中的服務專員。
deltacast_call_pick_up_attempt	代理嘗試接聽 deltacsted 通話時發生的事件
deltacast_call_picked_up	代理程式成功接聽 Delta 播送的通話時發生的事件。
deltacast_call_missed	代理人未接聽透過 DeltaCast 撥打的電話時發生的事件
multicast_call_notification_offered	此事件會記錄使用者已撥打多點傳播佇列電話，且多點傳播電話已向該佇列中的服務專員廣播
multicast_call_pick_up_attempt	當專員嘗試接聽多播電話時發生的事件
multicast_call_picked_up	當代理接聽多播電話時發生的事件
call_outbound_dialing	當服務專員在小工具中使用撥號鍵盤撥打電話給使用者時，就會發生這個事件。
user_status_changed	當服務專員變更小工具的狀態時，系統會觸發這項事件。
login	當服務專員登出小工具時發生的事件
logout	代理登入小工具時發生的事件

服務專員活動記錄

參數	必填	資料類型	定義
sort_column	FALSE	字串	根據回應物件中的任何欄位排序回應。
sort_direction	FALSE	ASC 或 DESC	註明排序方向，是遞增還是遞減
頁面	FALSE	字串	搭配「per」使用，註明記錄的頁面。舉例來說，如果 per 設為 200，而 page 設為 2，則回應會包含記錄 201 到 400，因為第 1 頁會包含記錄 1 到 200。
/	FALSE	字串	與頁面配對，記錄一頁記錄中會包含多少筆記錄。舉例來說，如果 per 設為 200，而 page 設為 2，則回應會包含記錄 201 到 400，因為第 1 頁會包含記錄 1 到 200。
started_at[from]	FALSE	世界標準時間	建立「started at」欄位的下限。系統會傳回輸入值之後的所有記錄。
started_at[to]	FALSE	世界標準時間	建立「開始時間」欄位的上限。傳回的所有記錄都會早於輸入值。
ended_at[from]	FALSE	世界標準時間	建立 ended_at 欄位的下限。系統會傳回輸入值之後的所有記錄。
ended_at[to]	FALSE	世界標準時間	建立「結束時間」欄位的上限。傳回的所有記錄都會早於輸入值。
duration[from]	FALSE	數字	建立時間長度欄位的下限。系統會傳回輸入值之後的所有記錄。
duration[to]	FALSE	數字	建立時間長度欄位的上限。傳回的所有記錄都會早於輸入值。
id[]	FALSE	Array[String]	字串陣列。要搜尋及傳回的記錄 ID
agent_id[]	FALSE	Array[String]	依代理 ID 篩選回覆
activity[]	FALSE	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[]	FALSE	Array[String]	依代理商 ID 篩選回覆。Whodunnit 是服務專員物件的子集，並使用相同的 agent_id 做為主鍵
call_id[]	FALSE	Array[String]	依輸入的通話 ID 篩選記錄
chat_id[]	FALSE	Array[String]	依輸入的對話 ID 篩選記錄

端點：

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

更多要求/回應範例：

要求範例：代理商活動記錄範例

內文：無

回覆範例：代理活動記錄範例

[
    {
        "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