이메일 엔드포인트는 이메일 세션 객체에 대한 액세스를 제공합니다.
다음은 이메일 지원 리소스의 모델입니다. 모델을 검토하여 PII가 포함될 수 있는 필드를 확인합니다.
[
{
"id": 1442,
"lang": "en",
"email_status": "paused",
"created_at": "2024-01-30T07:09:48.813Z",
"assigned_at": "2024-01-30T07:09:49.000Z",
"finished_at": "2024-02-29T10:00:11.000Z",
"updated_at": "2024-02-29T10:00:11.948Z",
"queue_duration": 0,
"email_duration": 10207,
"out_ticket_id": null,
"out_ticket_url": null,
"total_thread_numbers": 2,
"selected_menu": {
"id": 0,
"name": "string",
"parent_id": 0,
"position": 0,
"deleted": true,
"hidden": "string",
"menu_type": "email_menu",
"output_msg": "string"
},
"menu_path": {
"items_count": 0,
"name": "string",
"materialized_path": "string"
},
"agent_info": {
"id": 0,
"name": "string", //This may be considered PII
"last_name": "string", //This may be considered PII
"first_name": "string", //This may be considered PII
"agent_number": "string", //This may be considered PII
"avatar_url": "string"
},
"end_user": {
"id": 0,
"identifier": "string", //This may be considered PII
"out_contact_id": "string"
},
"email_attachments": [
{
"id": 0,
"file_type": "email_content",
"url": "string" //This may be considered PII
}
],
"email_threads": [
{
"id": 0,
"subject": "string", //This may be considered PII
"attachment_count": 0,
"direction": "string",
"is_read": true,
"is_draft": false,
"created_at": "2023-12-27T09:55:05.546Z",
"updated_at": "2023-12-27T09:55:50.701Z"
},
],
"transfers": [
{
"id": 0,
"status": "transferring",
"created_at": "2024-01-12T19:49:52.896Z",
"updated_at": "2024-01-12T19:55:35.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", //This may be considered PII
"last_name": "string", //This may be considered PII
"first_name": "string", //This may be considered PII
"agent_number": "string", //This may be considered PI
"avatar_url": "string"
},
"to_agent": {
"id": 0,
"name": "string", //This may be considered PII
"last_name": "string", //This may be considered PII
"first_name": "string", //This may be considered PII
"agent_number": "string", //This may be considered PI
"avatar_url": "string"
}
}
],
"handle_durations": [
{
"agent_id": 0,
"email_duration": 0,
"menu_path_id": 0,
"menu_path": "string",
"lang": "en",
"transfer": false,
"transfer_id": 1,
"assignment_type": "string",
"started_at": "2024-01-10T07:27:14.000Z",
"ended_at": "2024-01-10T07:27:20.000Z",
}
],
"queue_durations": [
{
"agent_id": 0,
"queue_duration": 0,
"menu_path_id": 0,
"menu_path": "string",
"lang": "en",
"started_at": "2024-01-10T07:27:14.000Z",
"ended_at": "2024-01-10T07:27:20.000Z",
"assignment_type": "string",
}
],
"consumer_handle_durations": [
{
"id": 100,
"email_duration": 314,
"attachments_count": 10,
"started_at": "2016-02-19T18:50:08.000Z",
"ended_at": "2016-02-19T18:55:22.000Z"
}
]
}
]
이메일
| 매개변수 | 필수 | 데이터 유형 | 정의 |
|---|---|---|---|
| sort_column | FALSE | 문자열 | 응답 객체의 필드를 기준으로 응답을 정렬합니다. |
| sort_direction | FALSE | ASC 또는 DESC | 정렬 방향(오름차순 또는 내림차순)을 나타냅니다. |
| 페이지 | FALSE | 문자열 | 레코드의 페이지를 나타내기 위해 per와 함께 사용됩니다. 예를 들어 per이 200이고 page가 2인 경우 응답에는 레코드 201~400이 포함됩니다. |
| / | FALSE | 문자열 | 레코드 페이지에 포함될 레코드 수를 나타내는 페이지와 쌍을 이룹니다. 예를 들어 per이 200이고 page가 2인 경우 응답에는 레코드 201~400이 포함됩니다. |
| assigned_at[from] | FALSE | UTC 시간 | 할당된 시간 필드의 하한을 만듭니다. 반환되는 모든 레코드는 입력된 값 이후의 값입니다. |
| assigned_at[to] | FALSE | UTC 시간 | 할당된 at 필드의 상한을 만듭니다. 반환되는 모든 레코드는 입력된 값 이전입니다. |
| finished_at[from] | FALSE | UTC 시간 | 완료된 시간 필드의 하한을 만듭니다. 반환되는 모든 레코드는 입력된 값 이후의 값입니다. |
| finished_at[to] | FALSE | UTC 시간 | 완료된 시간 필드의 상한을 만듭니다. 반환되는 모든 레코드는 입력된 값 이전입니다. |
| updated_at[from] | FALSE | UTC 시간 | 업데이트된 at 필드의 하한을 만듭니다. 반환되는 모든 레코드는 입력된 값 이후의 값입니다. |
| updated_at[to] | FALSE | UTC 시간 | updated_at 필드의 상한을 만듭니다. 반환되는 모든 레코드는 입력된 값 이전입니다. |
| created_at[from] | FALSE | UTC 시간 | 생성된 시간 필드의 하한을 만듭니다. 반환되는 모든 레코드는 입력된 값 이후의 값입니다. |
| created_at[to] | FALSE | UTC 시간 | 생성된 시간 필드의 상한을 만듭니다. 반환되는 모든 레코드는 입력된 값 이전입니다. |
| id[] | FALSE | Array[String] | 문자열 배열. 검색하고 반환할 레코드의 ID입니다. |
| agent_id[] | FALSE | Array[String] | 상담사 ID로 응답을 필터링합니다. |
| end_user_id[] | FALSE | Array[String] | 최종 사용자 ID를 기반으로 응답을 필터링합니다. |
| email_status[] | FALSE | Array[String] | 이메일이 이메일 수명 주기에서 어디에 있는지에 따라 레코드를 반환합니다. 가능한 값: unopened, active, paused, resolved, closed, reopened |
| total_thread_numbers[from] | FALSE | 숫자 | 전체 스레드 번호 필드의 하한을 만듭니다. 반환되는 모든 레코드는 입력된 값 이후의 값입니다. |
| total_thread_numbers[to] | FALSE | 숫자 | 총 스레드 수 필드의 상한을 만듭니다. 반환되는 모든 레코드는 입력된 값 이전입니다. |
엔드포인트:
Method: GET
Type:
URL: https://{{subdomain}}.{{domain}}/manager/api/v1/emails
요청/응답 예시 더보기:
요청 예시: 이메일 예시
질문: 없음
본문: 없음
응답 예시: 이메일 예시
[
{
"id": 1442,
"lang": "en",
"email_status": "paused",
"created_at": "2024-01-30T07:09:48.813Z",
"assigned_at": "2024-01-30T07:09:49.000Z",
"finished_at": "2024-02-29T10:00:11.000Z",
"updated_at": "2024-02-29T10:00:11.948Z",
"queue_duration": 0,
"email_duration": 10207,
"out_ticket_id": null,
"out_ticket_url": null,
"total_thread_numbers": 2,
"selected_menu": {
"id": 16,
"name": "Test Queue",
"parent_id": null,
"position": 3,
"deleted": false,
"menu_type": "email_menu",
"output_msg": null,
"hidden": false
},
"menu_path": {
"items_count": 1,
"name": "Test Queue",
"materialized_path": "16"
},
"agent_info": {
"id": 4,
"agent_number": "Bill",
"name": "Test Agent",
"last_name": "Agent",
"first_name": "Test",
"avatar_url": "https://subdomain.somedomain.com/data_uri_upload20230919-78154-airlnu.png"
},
"end_user": {
"id": 1499,
"identifier": null,
"out_contact_id": null
},
"email_attachments": [],
"email_threads": [
{
"id": 2287,
"subject": "3001-002",
"attachment_count": 0,
"direction": "Outbound",
"is_read": true,
"is_draft": false,
"created_at": "2024-01-30T07:09:48.886Z",
"updated_at": "2024-01-30T07:09:48.886Z"
},
{
"id": 2291,
"subject": "Re: 3001-002",
"attachment_count": 0,
"direction": "Inbound",
"is_read": true,
"is_draft": false,
"created_at": "2024-01-30T09:29:11.019Z",
"updated_at": "2024-01-30T09:30:52.853Z"
},
{
"id": 2292,
"subject": "Re: 3001-002",
"attachment_count": 0,
"direction": "Outbound",
"is_read": true,
"is_draft": false,
"created_at": "2024-01-30T09:31:21.567Z",
"updated_at": "2024-01-30T09:31:21.567Z"
},
{
"id": 2293,
"subject": "Re: 3001-002",
"attachment_count": 2,
"direction": "Inbound",
"is_read": false,
"is_draft": false,
"created_at": "2024-01-30T09:32:57.966Z",
"updated_at": "2024-01-30T09:32:57.966Z"
},
{
"id": 2295,
"subject": "Re: 3001-002",
"attachment_count": 3,
"direction": "Inbound",
"is_read": false,
"is_draft": false,
"created_at": "2024-01-30T09:57:13.536Z",
"updated_at": "2024-01-30T09:57:13.536Z"
},
{
"id": 2296,
"subject": "Re: 3001-002",
"attachment_count": 3,
"direction": "Inbound",
"is_read": false,
"is_draft": false,
"created_at": "2024-01-30T09:59:58.514Z",
"updated_at": "2024-01-30T09:59:58.514Z"
}
],
"transfers": [],
"handle_durations": [
{
"id": 63,
"agent_id": 4,
"email_duration": 0,
"menu_path_id": 5,
"menu_path": "Test Queue",
"lang": "en",
"transfer": false,
"transfer_id": null,
"started_at": "2024-01-30T07:09:48.813Z",
"ended_at": "2024-01-30T07:09:48.886Z",
"assignment_type": "auto",
"status": 1
},
{
"id": 65,
"agent_id": 4,
"email_duration": 130,
"menu_path_id": 5,
"menu_path": "Test Queue",
"lang": "en",
"transfer": false,
"transfer_id": null,
"started_at": "2024-01-30T09:29:11.019Z",
"ended_at": "2024-01-30T09:31:21.567Z",
"assignment_type": "auto",
"status": 1
},
{
"id": 67,
"agent_id": 4,
"email_duration": 1455,
"menu_path_id": 5,
"menu_path": "Test Queue",
"lang": "en",
"transfer": false,
"transfer_id": null,
"started_at": "2024-01-30T09:32:57.966Z",
"ended_at": "2024-01-30T09:57:13.536Z",
"assignment_type": "auto",
"status": 1
},
{
"id": 68,
"agent_id": 4,
"email_duration": 164,
"menu_path_id": 5,
"menu_path": "Test Queue",
"lang": "en",
"transfer": false,
"transfer_id": null,
"started_at": "2024-01-30T09:57:13.536Z",
"ended_at": "2024-01-30T09:59:58.514Z",
"assignment_type": "auto",
"status": 1
},
{
"id": 70,
"agent_id": 4,
"email_duration": 96,
"menu_path_id": 5,
"menu_path": "Test Queue",
"lang": "en",
"transfer": false,
"transfer_id": null,
"started_at": "2024-01-30T09:31:21.567Z",
"ended_at": "2024-01-30T09:32:57.966Z",
"assignment_type": "auto",
"status": 1
},
{
"id": 71,
"agent_id": 4,
"email_duration": 8362,
"menu_path_id": 5,
"menu_path": "Test Queue",
"lang": "en",
"transfer": false,
"transfer_id": null,
"started_at": "2024-01-30T07:09:48.886Z",
"ended_at": "2024-01-30T09:29:11.019Z",
"assignment_type": "auto",
"status": 1
}
],
"queue_durations": [
{
"id": 15,
"agent_id": 4,
"ended_at": "2024-01-30T07:09:49.308Z",
"lang": "en",
"menu_path_id": 5,
"menu_path": "Test Queue",
"queue_duration": 0,
"started_at": "2024-01-30T07:09:49.139Z",
"assignment_type": "auto",
"status": 1
}
],
"consumer_handle_durations": [
{
"id": 1,
"email_duration": 8362,
"started_at": "2024-01-30T07:09:48.886Z",
"ended_at": "2024-01-30T09:29:11.019Z",
"attachments_count": 0
},
{
"id": 2,
"email_duration": 96,
"started_at": "2024-01-30T09:31:21.567Z",
"ended_at": "2024-01-30T09:32:57.966Z",
"attachments_count": 2
},
{
"id": 4,
"email_duration": 1455,
"started_at": "2024-01-30T09:32:57.966Z",
"ended_at": "2024-01-30T09:57:13.536Z",
"attachments_count": 0
},
{
"id": 5,
"email_duration": 164,
"started_at": "2024-01-30T09:57:13.536Z",
"ended_at": "2024-01-30T09:59:58.514Z",
"attachments_count": 3
}
]
},
{
"id": 1443,
"lang": "en",
"email_status": "paused",
"created_at": "2024-01-30T07:25:34.736Z",
"assigned_at": "2024-01-30T07:25:35.000Z",
"finished_at": "2024-02-29T09:40:05.000Z",
"updated_at": "2024-02-29T09:40:05.784Z",
"queue_duration": 0,
"email_duration": 1396,
"out_ticket_id": null,
"out_ticket_url": null,
"total_thread_numbers": 1,
"selected_menu": {
"id": 16,
"name": "Test Queue",
"parent_id": null,
"position": 3,
"deleted": false,
"menu_type": "email_menu",
"output_msg": null,
"hidden": false
},
"menu_path": {
"items_count": 1,
"name": "Test Queue",
"materialized_path": "16"
},
"agent_info": {
"id": 4,
"agent_number": "Bill",
"name": "Test Agent",
"last_name": "Agent",
"first_name": "Test",
"avatar_url": "https://subdomain.somedomain.com/data_uri_upload20230919-78154-airlnu.png"
},
"end_user": {
"id": 1500,
"identifier": null,
"out_contact_id": null
},
"email_attachments": [],
"email_threads": [
{
"id": 2288,
"subject": "3001-003",
"attachment_count": 0,
"direction": "Outbound",
"is_read": true,
"is_draft": false,
"created_at": "2024-01-30T07:25:34.833Z",
"updated_at": "2024-01-30T07:25:34.833Z"
},
{
"id": 2289,
"subject": "Re: 3001-003",
"attachment_count": 0,
"direction": "Inbound",
"is_read": false,
"is_draft": false,
"created_at": "2024-01-30T09:15:43.549Z",
"updated_at": "2024-01-30T09:15:43.549Z"
},
{
"id": 2294,
"subject": "Re: 3001-003",
"attachment_count": 0,
"direction": "Inbound",
"is_read": false,
"is_draft": false,
"created_at": "2024-01-30T09:39:00.127Z",
"updated_at": "2024-01-30T09:39:00.127Z"
}
],
"transfers": [],
"handle_durations": [
{
"id": 64,
"agent_id": 4,
"email_duration": 0,
"menu_path_id": 5,
"menu_path": "Test Queue",
"lang": "en",
"transfer": false,
"transfer_id": null,
"started_at": "2024-01-30T07:25:34.736Z",
"ended_at": "2024-01-30T07:25:34.833Z",
"assignment_type": "auto",
"status": 1
},
{
"id": 66,
"agent_id": 4,
"email_duration": 1396,
"menu_path_id": 5,
"menu_path": "Test Queue",
"lang": "en",
"transfer": false,
"transfer_id": null,
"started_at": "2024-01-30T09:15:43.549Z",
"ended_at": "2024-01-30T09:39:00.127Z",
"assignment_type": "auto",
"status": 1
}
],
"queue_durations": [
{
"id": 16,
"agent_id": 4,
"ended_at": "2024-01-30T07:25:35.503Z",
"lang": "en",
"menu_path_id": 5,
"menu_path": "Test Queue",
"queue_duration": 0,
"started_at": "2024-01-30T07:25:35.280Z",
"assignment_type": "auto",
"status": 1
}
],
"consumer_handle_durations": [
{
"id": 3,
"email_duration": 1396,
"started_at": "2024-01-30T09:15:43.549Z",
"ended_at": "2024-01-30T09:39:00.127Z",
"attachments_count": 0
}
]
}
]
상태 코드: 200