任務相關
任務創建初始化
接口：GET /v1/task/create
返回
{
"meta": {
"enum_disable_dial_timegroup": [{
"uuid": "146979fe-3864-4817-ad76-13b37f43bb1c", // 禁呼時間id
"name": "休息時間"
}, {
"uuid": "cf44b8fc-a60f-499e-a5c8-5340963a56a3",
"name": "午休時間"
}, {
"uuid": "a6c20127-1199-4b87-bffa-75ed3e368fd0",
"name": "早會時間"
}],
"caller_line_list": [{ // 線路列表
"name": "尊享ai.zxycall.com一",
"value": "37d73edf-4628-4cf1-8beb-758433fd0aab", // 使用線路id
"residue": 1, // 剩余并發，只能選大于1的
"call_line": 1, // 線路總并發
"available_at": "2019-12-18 00:00:00",
"call_number": "13530525008" // 主叫號碼
}],
"max_recycle_limit": "50", // 可設置最大重撥次數 [棄用，使用重呼規則]
"auto_recycle_rules": [{ // 重呼規則
"id": 1, // 重呼規則id
"name": "測試重呼規則", // 重呼規則名稱
"remark": "test", // 重呼規則備注
"status": true, // 重呼規則狀態
}],
"customer_service": [{ // 客服組
"id": 21,
"user_id": "4d99d91c-f5d9-49da-88da-758977cc58a9",
"name": "組2",
"created_at": "2019-05-10 16:03:09",
"updated_at": "2019-05-15 18:01:40",
"caller_line_id": "37d73edf-4628-4cf1-8beb-758433fd0aab", // 使用的轉接線路，只能不為null的
"status": 1 // 是否可用，必須選為1的
}],
"outbound_group": [{ // 話術分組
"id": 390, // 話術分組ID
"name": "測試話術【復制】", // 話術分組名稱
"user_id": "4d99d91c-f5d9-49da-88da-758977cc58a9",
"debug": true, // 是否開啟調試模式，開啟后全部話術走tts
"deleted_at": null,
"created_at": "2019-02-24 14:24:23",
"updated_at": "2019-02-24 14:24:23",
"link_word_group_id": null, // 使用的銜接詞組id
"tag_scene_id": null, // 關聯的業務場景id
"default": false
}]
}
}
部分字段解釋
caller_line_list使用的線路列表，只能使用residue大于1的
enum_disable_dial_timegroup禁呼時間段列表
任務創建
接口：POST /v1/task
data
參數 類型 示例 解釋 required
caller_line_id string 37d73edf-4628-4cf1-8beb-758433fd0aab 使用線路列表caller_line_list的value yes
customer_service_id int 1 使用客服組的id no
destination_extension int 297 使用話術分組的id yes
disable_dial_timegroup string 146979fe-3864-4817-ad76-13b37f43bb1c 禁用呼叫時間的uuid yes
maximumcall int 1 并發數(不得超過選用線路的residue) yes
name string 測試任務 任務名稱 yes
random_assignment_number int 0 固定為0 yes
recycle_limit int 1 呼叫失敗最大重撥次數[棄用，有且只能為0] yes
remark string 第一個任務 任務描述 no
_originate_timeout int 60 撥號超時 yes
call_pause_second int 10 每通電話的呼叫間隔，單并發的建議間隔10秒，多并發可選擇0秒 yes
auto_recycle_rule_id int 1 重呼規則id yes
部分字段解釋
話術分組列表需要自己請求接口，在其他中；
客服列表需要自己請求接口，在其他中；
返回
{
"start": 0, // 此任務的實體
"alter_datetime": "2020-03-06 22:38:02",
"destination_dialplan": "XML",
"destination_context": "default",
"originate_variables": "{execute_on_media=start_da2}",
"maximumcall": 1,
"recycle_limit": 0,
"name": "測試",
"remark": "測試",
"destination_extension": 1197,
"disable_dial_timegroup": "146979fe-3864-4817-ad76-13b37f43bb1c",
"random_assignment_number": 0,
"caller_line_id": "83f180c4-00f3-4aaa-bc41-6cba4493e892",
"call_pause_second": 10,
"_originate_timeout": 60,
"customer_service_id": 21,
"auto_recycle_rule_id": 103,
"_origination_caller_id_number": "13530525008",
"dial_format": "user/admin",
"call_notify_url": "http://127.0.0.1:81/api/hangup_notify",
"call_notify_type": 2,
"uuid": "02f5bb4a-8a09-4eae-8969-6c2a3732f774",
"user_id": "4d99d91c-f5d9-49da-88da-758977cc58a9",
"create_datetime": "2020-03-06 22:38:02",
"start_str": "暫停",
"group_str": "測試",
"progress_bar": { // 此任務當前進度
"total": 0,
"progress": 0,
"percent": 0
},
"group": { // 此任務使用的話術分組
"id": 1197,
"name": "測試",
"user_id": "4d99d91c-f5d9-49da-88da-758977cc58a9",
"debug": true,
"deleted_at": null,
"created_at": "2020-03-06 15:17:41",
"updated_at": "2020-03-06 15:17:41",
"link_word_group_id": null,
"tag_scene_id": null,
"default": true
}
}
任務修改
接口：PUT /v1/task/{task_id}
參數同創建任務
外呼任務列表
接口：GET /v1/task
返回
{
"data": [{
"uuid": "dfc36b34-b398-4f6b-b263-cd64c53e5185", // 任務id
"name": "測試任務",
"create_datetime": "2019-05-07 15:15:40",
"alter_datetime": "2019-05-17 10:58:58",
"start": 0, // 任務狀態，1開啟|0暫停
"maximumcall": 1, // 最大并發呼叫量
"call_per_second": 10,
"recycle_limit": 1, // 呼叫失敗最大重撥次數 [啟用，使用重呼規則]
"random_assignment_number": 0,
"disable_dial_timegroup": "146979fe-3864-4817-ad76-13b37f43bb1c", // 禁呼時間組ID
"destination_extension": 447, // 使用話術分組ID
"destination_dialplan": "XML",
"destination_context": "default",
"scheduling_policy_ratio": null,
"scheduling_queue": null,
"dial_format": "user/admin",
"domain": null,
"remark": null,
"sort": 1,
"originate_variables": "{execute_on_media=start_da2}",
"_originate_timeout": 60,
"_origination_caller_id_number": "13530525008", // 主叫號碼
"user_id": "4d99d91c-f5d9-49da-88da-758977cc58a9",
"caller_line_id": "37d73edf-4628-4cf1-8beb-758433fd0aab", // 使用線路ID
"customer_service_id": null, // 使用客服組ID
"auto_recycle_rule_id": 103, //重呼規則ID
"call_notify_url": "http://127.0.0.1:81/api/hangup_notify",
"call_notify_type": 2,
"call_pause_second": 10, //呼叫間隔（秒）
"start_str": "暫停",
"group_str": "test",
"progress_bar": { // 任務進度 [棄用，需要專門請求 任務撥打進度 接口]
"total": 2,
"progress": 2,
"percent": 100
},
"caller_line": { //線路
"id": "af69c544-a170-4a2d-b740-20bf66cc7ff4",
"name": "南京-云蝠智能-17361984317",
"user_id": "4d99d91c-f5d9-49da-88da-758977cc58a9",
"description": null,
"deadline_at": "2020-11-20 00:00:00",
"available_time": 31536000,
"begin_at": "2020-02-28 22:23:24",
"call_line": 1,
"call_line_used": 1,
"call_number_prefix": "17361984317",
"is_call_number_enable": 1,
"is_call_number_prefix_editable": 0,
"dial_string": "user/admin",
"dial_string_mode": 1,
"db_public_id": null,
"db_private_id": null,
"node_ip": "59.111.104.155",
"node_status": "1",
"created_at": "2020-02-28 22:24:48",
"updated_at": "2020-03-04 20:51:03",
"feature": 7
},
"auto_recycle_rule": {
"id": 103,
"user_id": "4d99d91c-f5d9-49da-88da-758977cc58a9",
"name": "默認",
"remark": "默認",
"status": true,
"created_at": "2020-02-13 10:35:05",
"updated_at": "2020-02-13 10:35:05",
"is_default": true
},
"disable_time_group": {
"uuid": "cf44b8fc-a60f-499e-a5c8-5340963a56a3",
"name": "午休時間",
"domain": "",
"user_id": "4d99d91c-f5d9-49da-88da-758977cc58a9",
"created_at": null,
"updated_at": null
},
"group": { // 使用話術組
"id": 447,
"name": "test",
"user_id": "4d99d91c-f5d9-49da-88da-758977cc58a9",
"debug": true,
"deleted_at": null,
"created_at": "2019-03-17 13:14:55",
"updated_at": "2019-03-17 13:14:55",
"default": false
}
}]
}
任務的刪除
接口：GET /v1/task/destroy/{task_id}
任務的啟動
接口：GET /v1/task/start/{id}
任務暫停
接口：GET /v1/task/stop/{id}
向任務里導入號碼
接口：POST /v1/task/import_task_customer/{task_id}
data
{
"customer_info_list": [
{"phone": "18611228822"}, // 電話號碼
{"phone": "18611228811"},
{"phone": "18611228800"},
{"phone": "18611228899"}
]
}
任務撥打進度
接口：GET /v1/task/task_progress/{task_id}
返回
{
"code": 200,
"status": "ok",
"message": "獲取任務進度成功",
"data": {
"task_id": "772dd881-dcf7-42ee-a32b-b40a0ee5afb7",
"progress": {
"total": 10, //任務下號碼總量
"progress": 10, //已經撥打數量
"percent": 100 //進度
}
}
}
重置號碼呼叫狀態
接口：PUT /v1/task/{task_id}/number_reset
1.data
參數 類型 示例 解釋 required
status array [“12”] 篩選你所需要重呼的號碼的狀態 no
created_at array [“2020-3-10”,“2020-3-10”] 篩選號碼導入時間 no
keyword string 12345678901 指定號碼 no
2.返回
{
"code": 200,
"status": "ok",
"message": "重呼號碼成功",
"data": ""
}
根據任務ID獲取標簽場景，母標簽，標簽
接口：GET /v1/task/{task_id}/tag
1.data
參數 類型 示例 解釋 required
task_id string qazwsxedc123456 任務ID yes
2.返回
{
"code": 200,
"status": "ok",
"message": "獲取標簽信息成功",
"data": {
"tag_scene": {
"id": "0e62b98f-a5b9-46f8-ad95-dd18e0bb062e",
"name": "標簽場景2",
"description": "我是描述2"
},
"tag_groups": [
{
"id": "1",
"name": "標簽組1"
},
{
"id": "4",
"name": "標簽組2"
}
],
"tags": [
{
"id": "12",
"name": "測試標簽",
"description": "33"
},
{
"id": "20",
"name": "加油",
"description": "加油"
},
{
"id": "11",
"name": "標簽2",
"description": "33"
}
]
}
}
通話相關
