상담사 활동 로그는 위젯의 상태가 변경될 때마다 생성되는 기록입니다. 위젯에 로그인하거나, 델타캐스트 통화 알림을 받거나, 통화를 수락하는 등 다양한 상태가 있을 수 있습니다. 각 활동은 새 객체를 새로 만듭니다. 다음 모델을 참고하여 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 | 상담사가 deltacsted 통화에 응답하려고 할 때 발생하는 이벤트 |
| 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이면 페이지 1에 1~200이 포함되므로 응답에 레코드 201~400이 포함됩니다. |
| / | FALSE | 문자열 | 레코드 페이지에 포함될 레코드 수를 나타내는 페이지와 쌍을 이룹니다. 예를 들어 per이 200이고 page가 2이면 페이지 1에 1~200이 포함되므로 응답에는 레코드 201~400이 포함됩니다. |
| 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