🎫工單
Last updated
Last updated
此區為工單相關對應資料，如「狀態」、「優先度」等代碼。
根據各種條件搜尋工單，詳細介紹請參考下表
除了工單本身資訊以外，也包含關聯的客戶，分類，子分類，聯絡記錄，處理人員，業主等資訊。
GET https://{API_DOMAIN}/api/v1/ticketcurl -X GET
-H "Content-Type: application/json"
"https://{API_HOST}/api/v1/ticket?per_page=15&page=1"{
"data": [
{
"id": 67,
"subject": "無法通話",
"content": "無法通話\n＃處理完成",
"due_at": null,
"status": 0,
"status_memo": null,
"priority": 0,
"contact": null,
"contact_id": null,
"sub_category": {
"id": 26,
"name": "建議",
"description": null,
"category": {
"id": 1,
"name": "電話功能",
"description": null
},
"category_id": 1
},
"sub_category_id": 26,
"creater": {
"id": 7,
"name": "Tommy Hsu",
"first_name": "Tommy",
"last_name": "Hsu",
"employee_no": "tommy",
"photo_url": "/employee/7/photo",
"identity_no": null,
"job_title_id": -1,
"department_id": -1,
"extension_id": 8,
"extension": {
"id": 8,
"type": 3,
"extension": "8005",
"description": null,
"media_cluster_id": null
},
"group_id": 2,
"group": {
"id": 2,
"name": "測試Ｂ組",
"description": null,
"supervisor_id": 1
},
"cti_agent_account": "ag8005",
"cti_agent": {
"id": 5,
"account": "ag8005",
"group_id": null
},
"created_at": "2019-04-12 12:51:34",
"updated_at": "2019-04-15 15:25:46"
},
"handler_id": 7,
"handler": {
"id": 7,
"name": "Tommy Hsu",
"first_name": "Tommy",
"last_name": "Hsu",
"employee_no": "tommy",
"photo_url": "/employee/7/photo",
"identity_no": null,
"job_title_id": -1,
"department_id": -1,
"extension_id": 8,
"extension": {
"id": 8,
"type": 3,
"extension": "8005",
"description": null,
"media_cluster_id": null
},
"group_id": 2,
"group": {
"id": 2,
"name": "測試Ｂ組",
"description": null,
"supervisor_id": 1
},
"cti_agent_account": "ag8005",
"cti_agent": {
"id": 5,
"account": "ag8005",
"group_id": null
},
"created_at": "2019-04-12 12:51:34",
"updated_at": "2019-04-15 15:25:46"
},
"interact_collections": [
{
"id": 149,
"is_acw_completed": true,
"first_enter_queue_at": "2019-04-18 16:51:57",
"acw_at": "2019-04-18 16:54:57",
"last_finished_at": "2019-04-18 16:52:10",
"handler_id": 7,
"handler": {
"id": 7,
"name": "Tommy Hsu",
"first_name": "Tommy",
"last_name": "Hsu",
"employee_no": "tommy",
"photo_url": "/employee/7/photo",
"identity_no": null,
"job_title_id": -1,
"department_id": -1,
"extension_id": 8,
"extension": {
"id": 8,
"type": 3,
"extension": "8005",
"description": null,
"media_cluster_id": null
},
"group_id": 2,
"group": {
"id": 2,
"name": "測試Ｂ組",
"description": null,
"supervisor_id": 1
},
"cti_agent_account": "ag8005",
"cti_agent": {
"id": 5,
"account": "ag8005",
"group_id": null
},
"created_at": "2019-04-12 12:51:34",
"updated_at": "2019-04-15 15:25:46"
},
"contact_id": null,
"memo": null,
"bound_type": 1,
"sponsor_id": 1,
"campaign_queue_id": null,
"result_id": 2
}
],
"sponsor_id": 1,
"sponsor": {
"id": 1,
"name": "default",
"description": null,
"is_immortal": true,
"mail_channels": []
},
"campaign_queue": null,
"campaign_queue_id": null,
"created_at": "2019-04-16 14:45:12",
"updated_at": "2019-04-18 16:54:16",
"termination_code_id": null,
"termination_code": null,
"category": {
"id": 1,
"name": "電話功能",
"description": null
},
"category_id": 1
},
{
"id": 66,
"subject": "工單 for TEST",
"content": "內容內容內容內容內容內容內容內容111111",
"due_at": null,
"status": 2,
"status_memo": null,
"priority": 0,
"contact": {
"id": 2,
"name": "小 閎",
"first_name": "小",
"last_name": "閎",
"membership_no": null,
"identity_no": "A123456789",
"gender": 0,
"birth_at": "1987-10-10",
"profile_id": 3,
"sponsor_id": 1,
"disturb_setting": null
},
"contact_id": 2,
"sub_category": {
"id": 23,
"name": "時效",
"description": null,
"category": {
"id": 2,
"name": "理賠相關",
"description": null
},
"category_id": 2
},
"sub_category_id": 23,
"creater": {
"id": 6,
"name": "Karick Tung",
"first_name": "Karick",
"last_name": "Tung",
"employee_no": "karick",
"photo_url": null,
"identity_no": null,
"job_title_id": -1,
"department_id": -1,
"extension_id": 5,
"extension": {
"id": 5,
"type": 3,
"extension": "8004",
"description": "井井",
"media_cluster_id": null
},
"group_id": 2,
"group": {
"id": 2,
"name": "測試Ｂ組",
"description": null,
"supervisor_id": 1
},
"cti_agent_account": "ag8004",
"cti_agent": {
"id": 4,
"account": "ag8004",
"group_id": null
},
"created_at": "2019-03-08 22:51:25",
"updated_at": "2019-04-17 13:31:00"
},
"handler_id": null,
"handler": null,
"interact_collections": [
{
"id": 108,
"is_acw_completed": true,
"first_enter_queue_at": "2019-04-16 14:18:24",
"acw_at": "2019-04-16 14:23:06",
"last_finished_at": "2019-04-16 14:18:49",
"handler_id": 6,
"handler": {
"id": 6,
"name": "Karick Tung",
"first_name": "Karick",
"last_name": "Tung",
"employee_no": "karick",
"photo_url": null,
"identity_no": null,
"job_title_id": -1,
"department_id": -1,
"extension_id": 5,
"extension": {
"id": 5,
"type": 3,
"extension": "8004",
"description": "井井",
"media_cluster_id": null
},
"group_id": 2,
"group": {
"id": 2,
"name": "測試Ｂ組",
"description": null,
"supervisor_id": 1
},
"cti_agent_account": "ag8004",
"cti_agent": {
"id": 4,
"account": "ag8004",
"group_id": null
},
"created_at": "2019-03-08 22:51:25",
"updated_at": "2019-04-17 13:31:00"
},
"contact_id": 2,
"memo": null,
"bound_type": 1,
"sponsor_id": 1,
"campaign_queue_id": null,
"result_id": 2
},
{
"id": 121,
"is_acw_completed": true,
"first_enter_queue_at": "2019-04-16 15:36:59",
"acw_at": "2019-04-16 15:54:48",
"last_finished_at": "2019-04-16 15:54:48",
"handler_id": 2,
"handler": {
"id": 2,
"name": "eason d",
"first_name": "eason",
"last_name": "d",
"employee_no": "eason",
"photo_url": "/employee/2/photo",
"identity_no": null,
"job_title_id": -1,
"department_id": -1,
"extension_id": 2,
"extension": {
"id": 2,
"type": 3,
"extension": "8002",
"description": null,
"media_cluster_id": null
},
"group_id": 2,
"group": {
"id": 2,
"name": "測試Ｂ組",
"description": null,
"supervisor_id": 1
},
"cti_agent_account": "ag8002",
"cti_agent": {
"id": 2,
"account": "ag8002",
"group_id": null
},
"created_at": "2018-11-09 13:21:17",
"updated_at": "2019-04-15 15:10:10"
},
"contact_id": 2,
"memo": "這次不知道幹嘛",
"bound_type": 1,
"sponsor_id": 1,
"campaign_queue_id": null,
"result_id": 2
}
],
"sponsor_id": 1,
"sponsor": {
"id": 1,
"name": "default",
"description": null,
"is_immortal": true,
"mail_channels": []
},
"campaign_queue": null,
"campaign_queue_id": null,
"created_at": "2019-04-16 14:22:13",
"updated_at": "2019-04-17 12:39:53",
"termination_code_id": 5,
"termination_code": {
"id": 5,
"name": "確認可否處理",
"description": null,
"status": 0,
"creater_id": 1
},
"category": {
"id": 2,
"name": "理賠相關",
"description": null
},
"category_id": 2
}
],
"meta": {
"current_page": 1,
"from": 1,
"last_page": 8,
"per_page": "2",
"to": 2,
"total": 16
}
}POST https://{API_DOMAIN}/api/v1/ticketcurl -X POST
'{"subject":"標題","content":"內容","status":2,"contact_id":1,"sub_category_id":1,"termination_code":5}'
-H "Content-Type: application/json"
"https://{API_HOST}/api/v1/ticket"請參考 工單 回應格式
{
"data" : {
"id": 1,
"subject": "標題",
"content": "內容",
"due_at": null,
"status": 2,
"status_memo": null,
"priority": 0,
"contact": {
"id": 1,
"name": "艾 魁爾",
"first_name": "艾",
"last_name": "魁爾",
"membership_no": null,
"identity_no": "A123456789",
"gender": 0,
"birth_at": "1987-10-10",
"profile_id": 3,
"sponsor_id": 1,
"disturb_setting": null
},
"contact_id": 1,
"sub_category": {
"id": 1,
"name": "時效",
"description": null,
"category": {
"id": 1,
"name": "理賠相關",
"description": null
},
"category_id": 1
},
"sub_category_id": 1,
"handler_id": null,
"handler": null,
"sponsor_id": null,
"sponsor": null,
"campaign_queue": null,
"campaign_queue_id": null,
"created_at": "2019-04-16 14:22:13",
"updated_at": "2019-04-17 12:39:53",
"termination_code_id": 5,
"termination_code": {
"id": 5,
"name": "確認可否處理",
"description": null,
"status": 0,
"creater_id": null
},
"category": {
"id": 1,
"name": "理賠相關",
"description": null
},
"category_id": 1
}
}GET https://{API_DOMAIN}/api/v1/ticket/{id}curl -X GET
-H "Content-Type: application/json"
"https://{API_HOST}/api/v1/ticket/1"請參考 工單 回應格式
{
"id": 1,
"subject": "標題",
"content": "內容",
"due_at": null,
"status": 2,
"status_memo": null,
"priority": 0,
"contact": {
"id": 1,
"name": "艾 魁爾",
"first_name": "艾",
"last_name": "魁爾",
"membership_no": null,
"identity_no": "A123456789",
"gender": 0,
"birth_at": "1987-10-10",
"profile_id": 3,
"sponsor_id": 1,
"disturb_setting": null
},
"contact_id": 1,
"sub_category": {
"id": 1,
"name": "時效",
"description": null,
"category": {
"id": 1,
"name": "理賠相關",
"description": null
},
"category_id": 1
},
"sub_category_id": 1,
"handler_id": null,
"handler": null,
"sponsor_id": null,
"sponsor": null,
"campaign_queue": null,
"campaign_queue_id": null,
"created_at": "2019-04-16 14:22:13",
"updated_at": "2019-04-17 12:39:53",
"termination_code_id": 5,
"termination_code": {
"id": 5,
"name": "確認可否處理",
"description": null,
"status": 0,
"creater_id": null
},
"category": {
"id": 1,
"name": "理賠相關",
"description": null
},
"category_id": 1
}PUT https://{API_DOMAIN}/api/v1/ticket/{id}curl -X PUT
-H "Content-Type: application/json"
'{"subject":"修改後的標題"}'
"https://{API_HOST}/api/v1/ticket/1"請參考 工單 回應格式
{
"id": 1,
"subject": "修改後的標題",
"content": "內容",
"due_at": null,
"status": 2,
"status_memo": null,
"priority": 0,
"contact": {
"id": 1,
"name": "艾 魁爾",
"first_name": "艾",
"last_name": "魁爾",
"membership_no": null,
"identity_no": "A123456789",
"gender": 0,
"birth_at": "1987-10-10",
"profile_id": 3,
"sponsor_id": 1,
"disturb_setting": null
},
"contact_id": 1,
"sub_category": {
"id": 1,
"name": "時效",
"description": null,
"category": {
"id": 1,
"name": "理賠相關",
"description": null
},
"category_id": 1
},
"sub_category_id": 1,
"handler_id": null,
"handler": null,
"sponsor_id": null,
"sponsor": null,
"campaign_queue": null,
"campaign_queue_id": null,
"created_at": "2019-04-16 14:22:13",
"updated_at": "2019-04-17 12:39:53",
"termination_code_id": 5,
"termination_code": {
"id": 5,
"name": "確認可否處理",
"description": null,
"status": 0,
"creater_id": null
},
"category": {
"id": 1,
"name": "理賠相關",
"description": null
},
"category_id": 1
}Http status 為 204
DELETE https://{API_DOMAIN}/api/v1/ticket/{id}GET https://{API_DOMAIN}/api/v1/employeecurl -X GET
-H "Content-Type: application/json"
"https://{API_HOST}/api/v1/employee"{
"data": [
{
"id": 17,
"name": "AG 8018",
"first_name": "AG",
"last_name": "8018",
"employee_no": "ag8018",
"photo_url": null,
"identity_no": null,
"job_title_id": 21,
"job_title": {
"id": 21,
"abbrev": null,
"name": "銷售專員",
"description": null
},
"department_id": -1,
"department": null,
"extension_id": -1,
"extension": null,
"profile": {
"id": 29,
"phones": []
},
"is_active": true,
"role": "",
"email": null,
"group_id": 3,
"group": {
"id": 3,
"name": "SUN1",
"description": null,
"supervisor_id": 9
},
"is_immortal": false,
"cti_agent_account": null,
"cti_agent": null,
"created_at": "2019-04-18 06:13:43",
"updated_at": "2019-04-18 06:16:51"
},
{
"id": 16,
"name": "AG 8017",
"first_name": "AG",
"last_name": "8017",
"employee_no": "ag8017",
"photo_url": null,
"identity_no": null,
"job_title_id": 21,
"job_title": {
"id": 21,
"abbrev": null,
"name": "銷售專員",
"description": null
},
"department_id": -1,
"department": null,
"extension_id": -1,
"extension": null,
"profile": {
"id": 30,
"phones": []
},
"is_active": true,
"role": "",
"email": null,
"group_id": 3,
"group": {
"id": 3,
"name": "SUN1",
"description": null,
"supervisor_id": 9
},
"is_immortal": false,
"cti_agent_account": null,
"cti_agent": null,
"created_at": "2019-04-18 06:13:24",
"updated_at": "2019-04-18 06:17:02"
},
{
"id": 15,
"name": "AG 8016",
"first_name": "AG",
"last_name": "8016",
"employee_no": "ag8016",
"photo_url": null,
"identity_no": null,
"job_title_id": 21,
"job_title": {
"id": 21,
"abbrev": null,
"name": "銷售專員",
"description": null
},
"department_id": -1,
"department": null,
"extension_id": -1,
"extension": null,
"profile": {
"id": 31,
"phones": []
},
"is_active": true,
"role": "",
"email": null,
"group_id": 3,
"group": {
"id": 3,
"name": "SUN1",
"description": null,
"supervisor_id": 9
},
"is_immortal": false,
"cti_agent_account": null,
"cti_agent": null,
"created_at": "2019-04-18 06:13:02",
"updated_at": "2019-04-18 06:17:13"
}
],
"meta": {
"current_page": 1,
"from": 1,
"last_page": 6,
"per_page": "3",
"to": 3,
"total": 17
}
}GET https://{API_DOMAIN}/api/v1/sponsorcurl -X GET
-H "Content-Type: application/json"
"https://{API_HOST}/api/v1/sponsor"{
"data": [
{
"id": 1,
"name": "default",
"description": null,
"is_immortal": true,
"mail_channels": []
}
],
"meta": {
"current_page": 1,
"from": 1,
"last_page": 1,
"per_page": 15,
"to": 1,
"total": 1
}
}GET https://{API_DOMAIN}/api/v1/ticket-termination-codecurl -X GET
-H "Content-Type: application/json"
"https://{API_HOST}/api/v1/ticket-termination-code"{
"data": [
{
"id": 1,
"name": "尚未知曉",
"description": null,
"status": 0,
"creater_id": 1
},
{
"id": 2,
"name": "已知曉",
"description": null,
"status": 0,
"creater_id": 1
},
{
"id": 3,
"name": "討論中",
"description": null,
"status": 1,
"creater_id": 1
},
{
"id": 4,
"name": "正在寫",
"description": null,
"status": 1,
"creater_id": 1
},
{
"id": 5,
"name": "確認可否處理",
"description": null,
"status": 0,
"creater_id": 1
},
{
"id": 6,
"name": "放棄",
"description": null,
"status": 3,
"creater_id": 1
},
{
"id": 7,
"name": "還有些東西未來處理",
"description": null,
"status": 2,
"creater_id": 1
},
{
"id": 8,
"name": "搞定",
"description": null,
"status": 2,
"creater_id": 1
}
],
"meta": {
"current_page": 1,
"from": 1,
"last_page": 1,
"per_page": 15,
"to": 8,
"total": 8
}
}GET https://{API_DOMAIN}/api/v1/categorycurl -X GET
-H "Content-Type: application/json"
"https://{API_HOST}/api/v1/category"{
"data": [
{
"id": 1,
"name": "電話功能",
"description": null,
"children": [
{
"id": 26,
"name": "建議",
"description": null
}
]
},
{
"id": 2,
"name": "理賠相關",
"description": null,
"children": [
{
"id": 23,
"name": "時效",
"description": null
}
]
},
{
"id": 3,
"name": "PA 相關",
"description": null,
"children": [
{
"id": 21,
"name": "保費計算方式",
"description": null
},
{
"id": 22,
"name": "最新優惠",
"description": null
}
]
},
{
"id": 4,
"name": "配送",
"description": null,
"children": [
{
"id": 25,
"name": "地區",
"description": null
}
]
},
{
"id": 5,
"name": "電子郵件",
"description": "電子郵件相關的功能",
"children": [
{
"id": 27,
"name": "後端程式BUG",
"description": "待修正處理的 BUG"
}
]
}
],
"meta": {
"current_page": 1,
"from": 1,
"last_page": 1,
"per_page": 15,
"to": 5,
"total": 5
}
}GET https://{API_DOMAIN}/api/v1/subcategorycurl -X GET
-H "Content-Type: application/json"
"https://{API_HOST}/api/v1/subcategory"
{
"data": [
{
"id": 21,
"name": "保費計算方式",
"description": null,
"category": {
"id": 3,
"name": "PA 相關",
"description": null
},
"category_id": 3
},
{
"id": 22,
"name": "最新優惠",
"description": null,
"category": {
"id": 3,
"name": "PA 相關",
"description": null
},
"category_id": 3
},
{
"id": 23,
"name": "時效",
"description": null,
"category": {
"id": 2,
"name": "理賠相關",
"description": null
},
"category_id": 2
},
{
"id": 24,
"name": "測試子分類",
"description": "測試子分類",
"category": null,
"category_id": null
},
{
"id": 25,
"name": "地區",
"description": null,
"category": {
"id": 4,
"name": "配送",
"description": null
},
"category_id": 4
},
{
"id": 26,
"name": "建議",
"description": null,
"category": {
"id": 1,
"name": "電話功能",
"description": null
},
"category_id": 1
},
{
"id": 27,
"name": "後端程式BUG",
"description": "待修正處理的 BUG",
"category": {
"id": 5,
"name": "電子郵件",
"description": "電子郵件相關的功能"
},
"category_id": 5
}
],
"meta": {
"current_page": 1,
"from": 1,
"last_page": 1,
"per_page": 15,
"to": 7,
"total": 7
}
}名稱
值
待處理
0
處理中
1
已解決
2
已關閉
3
名稱
值
低
0
中
1
高
2
緊急
3
PARAMETER
REQUIRED
DEFAULT
TYPE
DESCRIPTION
page
false
1
Number
目前在第幾頁
per_page
false
15
Number
每頁呈現多少筆
search
false
NULL
String
模糊搜尋工單標題和內容
contact_id
false
NULL
Number
客戶 id
statuses
false
NULL
Array
工單狀態 < 0: 待處理 1: 處理中 2: 已解決 3: 已關閉 >
due_at__start
false
NULL
Datetime
截止日期時間(起始)
due_at__end
false
NULL
Datetime
截止日期時間(結束)
created_at__start
false
NULL
Datetime
建立日期時間(起始)
created_at__end
false
NULL
Datetime
建立日期時間(結束)
sponsor_id
false
NULL
Number
業主 id
termination_code_ids
false
NULL
Array
狀態細項 id 陣列
handler_ids
false
NULL
Array
處理工單的員工之 id 陣列
creater_ids
false
NULL
Array
建立工單的員工之 id 陣列
PROPERTY
TYPE
DESCRIPTION
data
Array of objects
meta
Object
Pagination meta
PARAMETER
REQUIRED
DEFAULT
TYPE
DESCRIPTION
sponsor_id
false
NULL
Number
業主的 id
handler_id
false
NULL
Number
處理員工的 id
termination_code_id
false
NULL
Number
狀態細項的 id
subject
true
NULL
String
工單標題
content
true
NULL
String
工單內容
due_at
false
NULL
Datetime
工單截止時間
priority
false
0(最低)
Number
工單優先等級
status
false
0(待處理)
Number
工單處理狀態
status_memo
false
NULL
String
工單狀態備註
sub_category_id
false
NULL
Number
子分類
contact_id
false
NULL
Number
客戶的id
PROPERTY
TYPE
DESCRIPTION
data
Object
PARAMETER
DESCRIPTION
id
工單 id
PARAMETER
DESCRIPTION
id
工單 id
PARAMETER
REQUIRED
DEFAULT
TYPE
DESCRIPTION
sponsor_id
false
NULL
Number
業主的 id
handler_id
false
NULL
Number
處理員工的 id
termination_code_id
false
NULL
Number
狀態細項的 id
subject
false
NULL
String
工單標題
content
false
NULL
String
工單內容
due_at
false
NULL
Datetime
工單截止時間
priority
false
0(最低)
Number
工單優先等級
status
false
0(待處理)
Number
工單處理狀態
status_memo
false
NULL
String
工單狀態備註
sub_category_id
false
NULL
Number
子分類
contact_id
false
NULL
Number
客戶的id
PARAMETER
DESCRIPTION
id
工單 id
PARAMETER
REQUIRED
DEFAULT
TYPE
DESCRIPTION
page
false
1
Number
目前在第幾頁
per_page
false
15
Number
每頁呈現多少筆
search
false
NULL
String
模糊搜尋員工姓名，身分證，員工編號
PROPERTY
TYPE
DESCRIPTION
data
Array of objects
meta
Object
Pagination meta
PROPERTY
TYPE
DESCRIPTION
data
Array of objects
meta
Object
Pagination meta
PARAMETER
REQUIRED
DEFAULT
TYPE
DESCRIPTION
page
false
1
Number
目前在第幾頁
per_page
false
15
Number
每頁呈現多少筆
search
false
NULL
String
模糊搜尋員工姓名，身分證，員工編號
PROPERTY
TYPE
DESCRIPTION
data
Array of objects
meta
Object
Pagination meta
PROPERTY
TYPE
DESCRIPTION
id
Number
狀態細項 id
name
String
狀態細項名稱
description
String
狀態細項敘述
status
Number
對應的工單狀態 <0: 待處理 1: 處理中 2: 已完成 3: 已關閉>
creater_id
Number
該狀態細項的建立員工之id
PARAMETER
REQUIRED
DEFAULT
TYPE
DESCRIPTION
page
false
1
Number
目前在第幾頁
per_page
false
15
Number
每頁呈現多少筆
PROPERTY
TYPE
DESCRIPTION
data
Array of objects
meta
Object
Pagination meta
PARAMETER
REQUIRED
DEFAULT
TYPE
DESCRIPTION
page
false
1
Number
目前在第幾頁
per_page
false
15
Number
每頁呈現多少筆
category_id
false
Number
所屬的主分類id
PROPERTY
TYPE
DESCRIPTION
data
Array of objects
meta
Object
Pagination meta