다음은 채팅 리소스의 모델입니다. 이 모델을 참고하여 PII가 포함될 수 있는 필드를 확인하세요.
[
{
"id": 31354,
"lang": "en",
"chat_type": "Messaging Inbound (App Chat)",
"status": "finished",
"sub_status": "Disconnected by end user",
"created_at": "2019-07-17T07:27:14.000Z",
"assigned_at": "2019-07-17T07:27:20.000Z",
"ends_at": "2019-07-17T07:29:02.000Z",
"updated_at": "2019-07-17T07:29:02.000Z",
"first_msg_sent_at": "2019-07-17T07:27:26.000Z",
"last_msg_sent_at": "2019-07-17T07:27:28.000Z",
"wait_duration": 0, //Deprecated, use queue_duration instead
"queue_duration": 0,
"chat_duration": 0,
"verified": false,
"rating": 0,
"has_feedback": false,
"out_ticket_id": "string",
"out_ticket_url": "string",
"finish_reason": "finish_reason_none",
"fail_reason": null,
"message_count": 3,
"average_response_time": 0,
"longest_response_time": 0,
"selected_menu": {
"id": 0,
"name": "string",
"parent_id": 0,
"position": 0,
"deleted": true,
"hidden": "string",
"menu_type": "ivr_menu",
"output_msg": "string"
},
"menu_path": {
"items_count": 1,
"name": "Ringo",
"materialized_path": "3389"
},
"agent_info": {
"id": 0,
"name": "string",
"last_name": "string",
"first_name": "string",
"agent_number": "string",
"avatar_url": "string"
},
"end_user": {
"id": 0,
"identifier": "string",
"out_contact_id": "string"
},
"photos": [
{
"id": 0,
"photo_type": "photo",
"url": "string"
}
],
"videos": [
{
"id": 0,
"url": "string"
}
],
"transfers": [
{
"id": 0,
"status": "transferring",
"fail_reason": "nothing",
"created_at": "2018-06-07T19:49:52.896Z",
"from_menu": {
"items_count": 0,
"name": "string",
"materialized_path": "string"
},
"to_menu": {
"items_count": 0,
"name": "string",
"materialized_path": "string"
},
"from_agent": {
"id": 0,
"name": "string",
"last_name": "string",
"first_name": "string",
"agent_number": "string",
"avatar_url": "string"
},
"to_agent": {
"id": 0,
"name": "string",
"last_name": "string",
"first_name": "string",
"agent_number": "string",
"avatar_url": "string"
}
}
],
"handle_durations": [
{
"agent_id": 0,
"acw_duration": 0,
"chat_duration" 0,
"wait_duration": 0,
"menu_path_id": 0,
"lang": "en",
"transfer": false,
"started_at": "2019-07-17T07:27:14.000Z",
"ended_at": "2019-07-17T07:27:20.000Z",
"event": "chat_finished"
}
],
"queue_durations": [
{
"agent_id": 0,
"queue_duration" 0,
"menu_path_id": 0,
"lang": "en",
"transfer": false,
"started_at": "2019-07-17T07:27:14.000Z",
"ended_at": "2019-07-17T07:27:20.000Z",
"service_level_abandon_time_threshold": 10,
"service_level_event": "not_in_sla",
"service_level_target_percent": 90,
"service_level_target_time": 60,
"event": "answered"
}
],
"participants": [
{
"id": 0,
"type": "end_user",
"status": "waiting",
"call_id": 0,
"user_id": 0,
"end_user_id": 0,
"call_duration": 0,
"hold_duration": 0,
"connected_at": "2018-06-07T19:49:52.896Z",
"ended_at": "2018-06-07T19:49:52.896Z",
"fail_reason": "nothing"
}
]
}
"offer_type": "cascade",
"offer_events": [
{
"casting_time": "2019-07-17T07:27:15.000Z",
"group": "Group 1"
}
]
},
service_level_event 필드는 다음 값 중 하나일 수 있습니다.
| 서비스 수준 이벤트 | 설명 |
|---|---|
| in_sla | SLA 내에 응답한 통화 |
| not_in_sla | 정의된 SLA 내에 응답하지 않은 통화 |
| 제외됨 | 통화가 SLA 계산에 포함되지 않았습니다 (예: 통화를 포기한 경우). |
채팅
| 매개변수 | 필수 | 데이터 유형 | 정의 |
|---|---|---|---|
| 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이 포함됩니다. |
| assigned_at[from] | FALSE | UTC 시간 | assigned_at 필드의 하한을 만듭니다. 반환되는 모든 레코드는 입력된 값 이후의 값입니다. |
| assigned_at[to] | FALSE | UTC 시간 | 할당된 at 필드의 상한을 만듭니다. 반환되는 모든 레코드는 입력된 값 이전입니다. |
| ends_at[from] | FALSE | UTC 시간 | field에 끝의 하한을 만듭니다. 반환되는 모든 레코드는 입력된 값 이후의 값입니다. |
| ends_at[to] | FALSE | UTC 시간 | field에 끝의 상한을 만듭니다. 반환되는 모든 레코드는 입력된 값 이전입니다. |
| updated_at[from] | FALSE | UTC 시간 | updated_at 필드의 하한을 만듭니다. 반환되는 모든 레코드는 입력된 값 이후의 값입니다. |
| updated_at[to] | FALSE | UTC 시간 | updated_at 필드의 상한을 만듭니다. 반환되는 모든 레코드는 입력된 값 이전입니다. |
| created_at[from] | FALSE | UTC 시간 | 생성된 시간 필드의 하한을 만듭니다. 반환되는 모든 레코드는 입력된 값 이후의 값입니다. |
| created_at[to] | FALSE | UTC 시간 | 생성된 시간 필드의 상한을 만듭니다. 반환되는 모든 레코드는 입력된 값 이전입니다. |
| rating[from] | FALSE | 숫자 1~5 또는 null | 평점 필드의 하한을 만듭니다. 반환되는 모든 레코드는 입력된 값 이후의 값입니다. |
| rating[to] | FALSE | 숫자 1~5 또는 null | 평점 필드의 상한을 만듭니다. 반환되는 모든 레코드는 입력된 값 이전입니다. |
| first_msg_sent_at[from] | FALSE | UTC 시간 | 필드에서 전송된 첫 번째 메시지의 하한을 만듭니다. 반환되는 모든 레코드는 입력된 값 이후의 값입니다. |
| first_msg_sent_at[to] | FALSE | UTC 시간 | 전송된 첫 번째 메시지의 상한을 at 필드에 만듭니다. 반환되는 모든 레코드는 입력된 값 이전입니다. |
| last_msg_sent_at[from] | FALSE | UTC 시간 | 마지막 메시지 전송 시간 필드의 하한을 만듭니다. 반환되는 모든 레코드는 입력된 값 이후의 값입니다. |
| last_msg_sent_at[to] | FALSE | UTC 시간 | 필드에 전송된 마지막 메시지의 상한을 만듭니다. 반환되는 모든 레코드는 입력된 값 이전입니다. |
| chat_duration[from] | FALSE | 숫자 | 채팅 기간 필드의 하한을 만듭니다. 반환되는 모든 레코드는 입력된 값 이후의 값입니다. |
| chat_duration[to] | FALSE | 숫자 | 채팅 기간 필드의 상한을 만듭니다. 반환되는 모든 레코드는 입력된 값 이전입니다. |
| message_count[from] | FALSE | 숫자 | 메시지 수 필드의 하한을 만듭니다. 반환되는 모든 레코드는 입력된 값 이후의 값입니다. |
| message_count[to] | FALSE | 숫자 | 메시지 수 필드의 상한을 만듭니다. 반환되는 모든 레코드는 입력된 값 이전입니다. |
| average_response_time[from] | FALSE | 숫자 | 평균 응답 시간 필드의 하한을 만듭니다. 반환되는 모든 레코드는 입력된 값 이후의 값입니다. |
| average_response_time[to] | FALSE | 숫자 | 평균 응답 시간 필드의 상한을 만듭니다. 반환되는 모든 레코드는 입력된 값 이전입니다. |
| longest_response_time[from] | FALSE | 숫자 | 가장 긴 응답 시간 필드의 하한을 만듭니다. 반환되는 모든 레코드는 입력된 값 이후의 값입니다. |
| longest_response_time[to] | FALSE | 숫자 | 가장 긴 응답 시간 필드의 상한을 만듭니다. 반환되는 모든 레코드는 입력된 값 이전입니다. |
| wait_duration[from] | FALSE | 숫자 | 대기 시간 필드의 하한을 만듭니다. 반환되는 모든 레코드는 입력된 값 이후의 값입니다. |
| wait_duration[to] | FALSE | 숫자 | 대기 시간 필드의 상한을 만듭니다. 반환되는 모든 레코드는 입력된 값 이전입니다. |
| id[] | FALSE | Array[String] | Array[Strings] 검색하고 반환할 레코드의 ID |
| agent_id[] | FALSE | Array[String] | 상담사 ID로 응답을 필터링합니다. |
| end_user_id[] | FALSE | Array[String] | 최종 사용자 ID를 기반으로 응답을 필터링합니다. |
| chat_type[] | FALSE | Array[String] | 최종 사용자가 채팅에 액세스한 방식에 따라 레코드를 반환합니다. 가능한 값: 메시지 수신 (앱 채팅), 메시지 수신 (웹 채팅), 메시지 (SMS) |
| chat_status[] | FALSE | Array[String] | 사용자가 채팅 수명 주기의 어느 단계에 있는지에 따라 레코드를 반환합니다. 가능한 값: queued, assigned, finished, canceled, failed, no_response |
| verified[] | FALSE | 불리언 | 확인된 레코드 (True) 또는 확인되지 않은 레코드 (False)를 반환합니다. |
| chat_fail_reason[] | FALSE | Array[String] | 채팅이 실패한 이유에 따라 레코드를 반환합니다. 가능한 값: nothing, unknown, no_response, expired |
service_level_event 값은 다음 값을 가질 수 있습니다.
| 서비스 수준 이벤트 | 설명 |
|---|---|
| in_sla | SLA 내에 응답한 통화 |
| not_in_sla | 정의된 SLA 내에 응답하지 않은 통화 |
| 제외됨 | 통화가 SLA 계산에 포함되지 않았습니다 (예: 통화를 포기한 경우). |
엔드포인트:
Method: GET
Type:
URL: https://{{subdomain}}.{{domain}}/manager/api/v1/chats
요청/응답 예시 더보기:
요청 예시: 채팅
질문:
| 키 | 값 | 설명 |
|---|---|---|
| updated_at[from] | \{updated_at\[from\]\} | UTC 시간입니다. 업데이트된 시간 필드의 하한을 만듭니다. 반환되는 모든 레코드는 입력된 값 이후의 값입니다. |
| updated_at[to] | \{updated_at\[to\]\} | UTC 시간입니다. 업데이트된 시간 필드의 상한을 만듭니다. 반환되는 모든 레코드는 입력된 값 이전입니다. |
본문: 없음
응답 예시: 채팅
[
{
"id": 1,
"lang": "en",
"chat_type": "Messaging Inbound (App Chat)",
"status": "finished",
"created_at": "2016-02-26T18:35:54.000Z",
"assigned_at": "2016-02-26T18:36:05.000Z",
"ends_at": "2016-02-26T18:37:24.000Z",
"updated_at": "2016-02-26T18:37:24.000Z",
"first_msg_sent_at": null,
"last_msg_sent_at": null,
"chat_duration": 11,
"wait_duration": 22,
"queue_duration": 22,
"verified": true,
"rating": 5,
"has_feedback": false,
"out_ticket_id": "209",
"out_ticket_url": null,
"fail_reason": null,
"message_count": 0,
"average_response_time": 0,
"longest_response_time": 0,
"selected_menu": null,
"menu_path": null,
"agent_info": {
"id": 4,
"agent_number": "007",
"name": "Storm Trooper 1",
"last_name": "Storm",
"first_name": "Trooper 1",
},
"end_user": {
"id": 1,
"identifier": "Death Star Carpentry",
"out_contact_id": "360949501087"
},
"photos": [
{
"id": 3,
"photo_type": "photo",
"url": "true"
}
],
"consumer_handle_durations": [
{
"id": 100,
"chat_duration": 314,
"message_count": 10,
"response_count": 6,
"response_time_total": 85,
"response_time_max": 25,
"response_time_avg": 12,
"started_at": "2016-02-19T18:50:08.000Z",
"ended_at": "2016-02-19T18:55:22.000Z"
}
],
"consumer_event_durations": [
{
"id": 11,
"type": "csat",
"event": "finished",
"duration": 4,
"menu_path_id": 11,
"menu_path": "Deathstar/Shipping",
"lang": "en",
"started_at": "2016-02-19T18:54:39.000Z",
"ended_at": "2016-02-19T18:54:43.000Z"
}
],
"handle_durations": [
{
"id": 30001,
"agent_id": 4,
"acw_duration": 0,
"chat_duration": 11,
"menu_path_id": 11,
"menu_path": "Deathstar/Shipping",
"lang": "en",
"transfer": 0,
"transfer_id": null,
"started_at": "2016-03-02T23:24:08.000Z",
"ended_at": "2016-03-02T23:24:42.000Z",
"response_count": 11,
"response_time_total": 259,
"response_time_max": 29,
"response_time_avg": 24,
"assigned_connection_duration": 10
}
],
"queue_durations": [
{
"id": 41234,
"agent_id": 5,
"queue_duration": 22,
"menu_path_id": 11,
"menu_path": "Deathstar/Shipping",
"lang": "en",
"transfer": 0,
"transfer_id": null,
"transfer_cold": 0,
"started_at": "2016-03-02T23:23:56.000Z",
"ended_at": "2016-03-02T23:24:08.000Z",
"service_level_abandon_time_threshold": 10,
"service_level_event": "not_in_sla",
"service_level_target_percent": 90,
"service_level_target_time": 60
}
]
"videos": [],
"transfers": [],
"participants": [],
"virtual_agent": null,
"virtual_agent_deflected_escalations": [],
"virtual_agent_handle_durations": []
},
{
"id": 2,
"lang": "en",
"chat_type": "in-app",
"status": "finished",
"created_at": "2016-03-02T23:24:05.000Z",
"assigned_at": "2016-03-02T23:24:08.000Z",
"ends_at": "2016-03-02T23:24:42.000Z",
"updated_at": "2016-03-02T23:24:42.000Z",
"first_msg_sent_at": null,
"last_msg_sent_at": null,
"wait_duration": 12,
"queue_duration": 12,
"chat_duration": 34,
"verified": false,
"rating": 2,
"has_feedback": false,
"out_ticket_id": "214",
"out_ticket_url": null,
"fail_reason": null,
"message_count": 0,
"average_response_time": 0,
"longest_response_time": 0,
"selected_menu": null,
"menu_path": null,
"agent_info": null,
"end_user": {
"id": 1,
"identifier": "Death Star Carpentry",
"out_contact_id": "360949501087"
},
"photos": [],
"videos": [],
"transfers": [],
"participants": [],
"handle_durations": [
{
"id": 30001,
"agent_id": 4,
"acw_duration": 0,
"chat_duration": 34,
"menu_path_id": 11,
"menu_path": "Deathstar/Shipping",
"lang": "en",
"transfer": 0,
"transfer_id": null,
"started_at": "2016-03-02T23:24:08.000Z",
"ended_at": "2016-03-02T23:24:42.000Z",
"response_count": 11,
"response_time_total": 259,
"response_time_max": 29,
"response_time_avg": 24,
"assigned_connection_duration": 10
}
],
"queue_durations": [
{
"id": 41234,
"agent_id": 5,
"queue_duration": 12,
"menu_path_id": 11,
"menu_path": "Deathstar/Shipping",
"lang": "en",
"transfer": 0,
"transfer_id": null,
"transfer_cold": 0,
"started_at": "2016-03-02T23:23:56.000Z",
"ended_at": "2016-03-02T23:24:08.000Z",
"service_level_abandon_time_threshold": 10,
"service_level_event": "not_in_sla",
"service_level_target_percent": 90,
"service_level_target_time": 60
}
],
"virtual_agent": {
"id": 10,
"name": "D2-R2"
},
"virtual_agent_deflected_escalations": [
{
"id": 1,
"deflection": "after_hours",
"escalation_reason": "by_end_user_message",
"escalated_at": "2016-03-02T23:23:56.000Z",
"menu_path_id": 11,
"menu_path": "Deathstar/Shipping",
"lang": "en",
"virtual_agent": {
"id": 10,
"name": "D2-R2"
}
}
],
"virtual_agent_handle_durations": [
{
"id": 1,
"virtual_agent": {
"id": 10,
"name": "D2-R2"
},
"chat_duration": 11,
"escalation_reason": "by_end_user_message",
"response_count": 11,
"response_time_total": 34,
"response_time_max": 4,
"response_time_avg": 3,
"fallback_response_count": 1,
"initiated_by": "end_user",
"menu_path_id": 11,
"menu_path": "Deathstar/Shipping",
"lang": "en",
"transfer": false,
"transfer_id": null,
"started_at": "2016-03-02T23:23:16.000Z",
"ended_at": "2016-03-02T23:23:56.000Z"
}
]
}
]
상태 코드: 200