注意，本接口的使用需要进行接口鉴权
CallCenter外呼任务接口对接
外呼任务接口简介： 提供查询未完成外呼任务的能力，并能够通过接口导入外呼任务数据
1.查询未完成外呼任务接口
-
HTTP请求方式：POST
-
请求地址：{HOST}/v20170704/dianxiao/queryOutboundTask/{ACCOUNTID}?sig={sig}
-
请求时请将{HOST}换成对接数据查询中获取到的请求域名，{ACCOUNTID}替换为账户编号，{SIG}是根据鉴权规则生成的，请看鉴权文档，查看具体的生成规则
-
鉴权文档：接口鉴权
-
请求示例:
http://apis.7moor.com/v20170704/dianxiao/queryOutboundTask/account?sig=xxx=41276A8E7767352A0FE7456D20F03D3
返回值：
| 返回值 | 含义 |
| success | 是否请求成功 |
| message | 响应信息 |
| data | 返回的数据，json格式 |
| taskName | 外呼任务名字 |
| taskId | 外呼任务id |
| memo | 外呼任务描述 |
| phoneTotal | 外呼任务号码总数 |
| agentsNum | 外呼任务参与座席个数 |
| createTime | 外呼任务创建时间 |
| source | 外呼任务用户数据来源 |
| lastTime | 外呼任务最后更新时间 |
- 返回成功示例:
{
"message": "there are dealing task",
"success": true,
"data": [
{
"taskName": "20171129_b",
"taskId": "9e656890-d4b3-11e7-82ff-cbd9805b4059",
"memo": "",
"phoneTotal": 5,
"agentsNum": 1,
"createTime": "2017-11-29 11:15:57",
"lastTime": "2017-11-29 12:02:04",
"source": "网络"
}
]
}
2.查询所有外呼任务接口
-
HTTP请求方式：POST
-
请求地址：{HOST}/v20170704/dianxiao/queryAllOutboundTask/{ACCOUNTID}?sig={sig}
-
请求时请将{HOST}换成对接数据查询中获取到的请求域名，{ACCOUNTID}替换为账户编号，{SIG}是根据鉴权规则生成的，请看鉴权文档，查看具体的生成规则
-
鉴权文档：接口鉴权
-
请求示例:
http://apis.7moor.com/v20170704/dianxiao/queryAllOutboundTask/account?sig=xxx=41276A8E7767352A0FE7456D20F03D3
- 请求体:
{
"status": "close"
}
请求体字段解说明：
status：dealing 进行中，close已关闭，archive已归档，如果传{} 表示获取所有状态的任务
返回值：
| 返回值 | 含义 |
| success | 是否请求成功 |
| message | 响应信息 |
| data | 返回的数据，json格式 |
| taskName | 外呼任务名字 |
| taskId | 外呼任务id |
| memo | 外呼任务描述 |
| phoneTotal | 外呼任务号码总数 |
| agentsNum | 外呼任务参与座席个数 |
| createTime | 外呼任务创建时间 |
| source | 外呼任务用户数据来源 |
| lastTime | 外呼任务最后更新时间 |
- 返回成功示例:
{
"message": "there are dealing task",
"success": true,
"data": [
{
"taskName": "20171129_b",
"taskId": "9e656890-d4b3-11e7-82ff-cbd9805b4059",
"memo": "",
"phoneTotal": 5,
"agentsNum": 1,
"createTime": "2017-11-29 11:15:57",
"lastTime": "2017-11-29 12:02:04",
"source": "网络"
}
]
}
3.外呼任务导入数据接口
-
HTTP请求方式：POST
-
请求地址：{HOST}/v20170704/dianxiao/insertOutboundTaskData/{ACCOUNTID}?sig={sig}
-
请求时请将{HOST}换成对接数据查询中获取到的请求域名，{ACCOUNTID}替换为账户编号，{SIG}是根据鉴权规则生成的，请看鉴权文档，查看具体的生成规则
-
鉴权文档：接口鉴权
-
请求示例:
https://apis.7moor.com/v20170704/dianxiao/insertOutboundTaskData/N00000000013
?sig=41276A8E7767352A0FE7456D20F03D3
- 请求体:
{
"exten" : "8002",
"isPhone" : "plan",
"taskId" : "c371dbe0-c938-11e7-9bd0-a35d26d86723",
"numbers" : [
{
"phone":"15210105523",
"name" :"容联七陌",
"title" :"test1"
},
{
"phone":"13785127283",
"name" :"容联七陌",
"title" :"test2",
}
]
}
请求体字段解说明：
| 字段 | 类型 | 是否必须 | 备注 |
| exten | String | 是 | 坐席号，创建本次导入号码任务的坐席 |
| isPhone | String | 是 | 号码晒重方式：global（全局，包括所有的任务、用户数据），allPlan（所有任务，所有未归档的任务），plan（当前任务，当前操作的任务） |
| taskId | String | 是 | 任务ID |
| numbers | List | 是 | 导入的数据，此值类型为List，长度不得超过10000， 单位元素结构为 {phone:xxx，name:xxx，title:xxx} phone ----联系电话 name ----用户名称 title ----描述 |
返回值：
- 外呼任务导入号码成功返回示例:
{
"success": true,
"code": 200,
"message": "200 OK"
}
- 外呼任务导入号码失败返回示例:
{
"success": false,
"message": "please check your parametes!",
"code": 400
}
4.创建外呼任务接口
-
HTTP请求方式：POST
-
请求地址：{HOST}/v20180426/call/saveCustTaskApi/{ACCOUNTID}?sig={sig}
-
请求时请将{HOST}换成对接数据查询中获取到的请求域名，{ACCOUNTID}替换为账户编号，{SIG}是根据鉴权规则生成的，请看鉴权文档，查看具体的生成规则
-
鉴权文档：接口鉴权
-
请求示例:
https://apis.7moor.com/v20180426/call/saveCustTaskApi/N00000000013
?sig=41276A8E7767352A0FE7456D20F03D3
- 请求体:
{
"taskName":"task00111",
"memo":"示例",
"effective":30,
"pattern":"1",
"workload":30,
"agentsNum":["8001"]
}
请求体字段解说明：
| 字段 | 类型 | 是否必须 | 备注 |
| taskName | String | 是 | 任务名称 |
| memo | String | 是 | 描述 非必填 |
| effective | number | 是 | 有效通话时长 |
| pattern | String | 是 | 基础任务量 1：有效通话数；2：有效通话时长 |
| workload | number | 是 | 具体数值，所有坐席默认值 |
| agentsNum | array | 是 | 坐席工号，必填，至少一个，不传报错 |
返回值：
- 外呼任务创建成功返回示例:
{
"success": true,
"taskID": "6b381f10-c90d-11eb-b958-3b03bb346fd3",
"message": "200 ok!"
}
- 外呼任务创建失败返回示例:
{
"success": false,
"message": "任务名称已存在，请重新输入"
}