エージェント アクティビティ ログは、ウィジェットの状態が変更されたときに作成されるレコードです。ウィジェットへのログイン、デルタキャストの通話通知の取得、通話の承諾など、さまざまなステータスが考えられます。各アクティビティは新しいオブジェクトを作成します。次のモデルを参照して、どのフィールドに 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,
"wfm_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 | エンドユーザーが電話をかけ、マルチキャストまたはデルタキャストの通話通知がエージェントに提供されたときに発生するイベント。 |
| call_pick_up_attempt | エージェントがマルチキャストまたはデルタキャスト通話に応答しようとしたときに発生するイベント。 |
| call_picked_up | エージェントがマルチキャストまたはデルタキャスト通話に応答したときに発生するイベント。 |
| deltacast_call_notification_offered | エンドユーザーがマルチキャストでキューに電話をかけ、そのキュー内のエージェントにデルタキャスト通話がブロードキャストされたことを示すイベント。 |
| deltacast_call_pick_up_attempt | エージェントがデルタキャストされた通話に応答しようとしたときに発生するイベント |
| deltacast_call_picked_up | エージェントがデルタキャストされた通話に正常に応答したときに発生するイベント。 |
| deltacast_call_missed | エージェントがデルタキャストされた通話に応答しなかったときに発生するイベント |
| multicast_call_notification_offered | エンドユーザーがマルチキャスト対応のキューに電話をかけ、そのキュー内のエージェントにマルチキャスト通話がブロードキャストされたことを示すイベント |
| multicast_call_pick_up_attempt | マルチキャストされた通話にエージェントが応答しようとしたときに発生するイベント |
| multicast_call_picked_up | マルチキャスト通話にエージェントが応答したときに発生するイベント |
| call_outbound_dialing | エージェントがウィジェットのダイヤルパッドを使用してエンドユーザーに電話をかけたときに発生するイベント。 |
| user_status_changed | エージェントがウィジェットの状態を変更したときに発生するイベント |
| ログイン | エージェントがウィジェットからログアウトしたときに発生するイベント |
| 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 | UTC の時間 | started at フィールドの下限を作成します。返されるすべてのレコードは、入力された値より後のものになります。 |
| started_at[to] | FALSE | UTC の時間 | started at フィールドの上限を作成します。返されるすべてのレコードは、入力された値より前のものになります。 |
| ended_at[from] | FALSE | UTC の時間 | ended at フィールドの下限を作成します。返されるすべてのレコードは、入力された値より後のものになります。 |
| ended_at[to] | FALSE | UTC の時間 | ended at フィールドの上限を作成します。返されるすべてのレコードは、入力された値より前のものになります。 |
| duration[from] | FALSE | 数値 | 期間フィールドの下限を作成します。返されるすべてのレコードは、入力された値より後のものになります。 |
| duration[to] | FALSE | 数値 | 期間フィールドの上限を作成します。返されるすべてのレコードは、入力された値より前のものになります。 |
| id[] | FALSE | Array[String] | Array[Strings]。検索して返すレコードの 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",
"wfm_id": 36
},
"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",
"wfm_id": 36
},
"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",
"wfm_id": 36
},
"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",
"wfm_id": 36
},
"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",
"wfm_id": 12
},
"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",
"wfm_id": 12
},
"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",
"wfm_id": 36
},
"started_at": "2017-06-19T18:34:39.000Z",
"ended_at": null,
"duration": 0,
"call_id": null,
"chat_id": null,
"activity": "login",
"whodunnit": null
}
]
ステータス コード: 200