注意,本接口的使用需要进行接口鉴权
云电销外呼任务接口对接
外呼任务接口简介: 提供查询未完成外呼任务的能力,并能够通过接口导入外呼任务数据
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/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
}