编辑自动外呼任务
服务描述
本接口,可用于编辑云呼叫中心自动外呼任务基本信息,规则如下:
1、不同任务状态下修改的任务信息不同,详见案例说明。
2、不能编辑任务名单和坐席分配名单数量,如需有需求详见"外呼任务-删除外呼名单"和"外呼任务-追加外呼名单"。
开发须知
调用本接口前,请先获取appId
服务地址
POST https://{您的专属域名}/speech/openapi/v1/task/outbound/edit
请求参数(任务状态:未开始)
参数 |
位置 |
类型 |
是否必填 |
说明 |
appId |
header |
String |
Y |
应用ID |
timestamp |
header |
String |
Y |
时间戳,毫秒 |
sign |
header |
String |
Y |
签名 |
Content-Type |
header |
String |
Y |
application/json |
taskId |
Body |
Long |
Y |
任务id |
taskName |
Body |
String |
Y |
任务名称(不能与其它任务名称重复),长度:1至50 |
taskExecStartDate |
Body |
String |
Y |
任务开始时间(yyyy-MM-dd) |
taskExecEndDate |
Body |
String |
Y |
任务结束时间(yyyy-MM-dd) |
taskExecTimes |
Body |
List<ExecTimeOpenDto> |
Y |
任务拨打时间段 |
taskDesc |
Body |
String |
N |
任务描述 |
skillSetId |
Body |
String |
Y |
技能组id,通过接口呼出技能组获取 |
outboundNumberGroupId |
Body |
String |
Y |
外呼号码组id,通过接口外呼号码组获取 |
strategyDisplaySwitch |
Body |
Boolean |
Y |
策略外显开关 true-开启 false-关闭,默认:关闭 |
sendNumberStrategy |
Body |
Integer |
Y |
送号策略(0-按倍率值计算 ; 1-预测式外呼) |
multiplyPower |
Body |
Integer |
送号策略=0:Y |
倍率值,范围:大于0 |
abandonmentRate |
Body |
Integer |
送号策略=1:Y |
放弃率,范围:1 至 5 |
outboundPhoneGroups |
Body |
List<PhoneGroupDto> |
Y |
号码批次,目前只支持1个号码组 |
maxRingingDuration |
Body |
Integer |
Y |
最大振铃时间(最小值20s,最大值50s,默认45s) |
acw |
Body |
Integer |
Y |
话后时长(1s-180s,默认10s) |
请求参数(任务状态:进行中、暂停)
参数 |
位置 |
类型 |
是否必填 |
说明 |
appId |
header |
String |
Y |
应用ID |
timestamp |
header |
String |
Y |
时间戳,毫秒 |
sign |
header |
String |
Y |
签名 |
Content-Type |
header |
String |
Y |
application/json |
taskId |
Body |
Long |
Y |
任务id |
outboundNumberGroupId |
Body |
String |
Y |
外呼号码组id,通过接口外呼号码组获取 |
strategyDisplaySwitch |
Body |
Boolean |
Y |
策略外显开关 true-开启 false-关闭,默认:关闭 |
sendNumberStrategy |
Body |
Integer |
Y |
送号策略(0-按倍率值计算 ; 1-预测式外呼) |
multiplyPower |
Body |
Integer |
送号策略=0:Y |
倍率值,范围:大于0 |
abandonmentRate |
Body |
Integer |
送号策略=1:Y |
放弃率,范围:1 至 5 |
outboundPhoneGroups |
Body |
List<PhoneGroupVo> |
Y |
号码批次,目前只支持1个号码组 |
ExecTimeOpenDto
参数 |
位置 |
类型 |
是否必填 |
说明 |
taskExecTimeStartStr |
Body |
String |
Y |
任务执行开始时间,格式:HH:mm:ss |
taskExecTimeEndStr |
Body |
String |
Y |
任务执行结束时间,格式:HH:mm:ss |
PhoneGroupDto
参数 |
位置 |
类型 |
是否必填 |
说明 |
name |
Body |
String |
Y |
号码批次名称 |
identify |
Body |
String |
Y |
号码批次标识,默认“default” |
autoOutboundSwitch |
Body |
Integer |
Y |
重呼设置开关(0-关闭;1-开启,默认0) |
autoOutboundInterval |
Body |
Integer |
自动重呼开启:Y |
重呼间隔(分钟),范围:5 至 2880 |
autoOutboundTimes |
Body |
Integer |
自动重呼开启:Y |
重呼次数,范围:1 至 3 |
请求示例数据:
POST https://abc.xyz/speech/openapi/v1/task/outbound/edit
sign: fo1OWX+JnfeonAFSGau2gwP1GvFa+RTw5czoBWoz+k3AjV8scDl6JnvFRDj8Lgt1nQxLlmcOhIBN4j7pEE/NAzYjXUFSGo308f5V9dHBnmGLYsqKmgma4cQZLBqHp9T43IZfRX8Zh2/Hp2HOmfTgos/L8GN6YPA8fQ2d5tbtJZrrkBuwA/LEezjOJxSRRRCrcS1ZFVvTZ+cIjYeO4QdC5r5I67LLY/nLbFAFUdQsCzUIytO09vUCLGlKierNhPfCtMzTgZSE9dWO5zJ3L2uCsXM7Od6mPROVpddVafF+BueKjtbL10PwDc9f1eBpGTpgmbOy8Bbx3NIyCjDvhc9Mag==
appId: 99845aaaaebd4d61acccc9b776208f12
timestamp: 1586314097995
请求Body(任务状态:未开始):
{
"taskId": 121,
"taskName": "自动外呼任务名称",
"taskExecStartDate": "2020-09-27",
"taskExecEndDate": "2020-09-27",
"taskExecTimes": [
{
"taskExecTimeStartStr": "11:36:00",
"taskExecTimeEndStr": "12:35:00"
}
],
"taskDesc": "自动外呼描述",
"skillSetId": "1462016331580064",
"outboundNumberGroupId": "1070678044124225",
"strategyDisplaySwitch":1,
"sendNumberStrategy": 0,
"abandonmentRate": 2,
"multiplyPower": 2,
"maxRingingDuration": 20,
"acw": 10,
"outboundPhoneGroups":[
{
"name":"外呼任务号码批次名称,如:本人、亲属、朋友",
"identify":"default",
"autoOutboundSwitch": 1,
"autoOutboundInterval": 5,
"autoOutboundTimes": 1
}
]
}
请求Body(任务状态:进行中、暂停):
{
"taskId": 121,
"outboundNumberGroupId": "1070678044124225",
"strategyDisplaySwitch":1,
"sendNumberStrategy": 0,
"abandonmentRate": 2,
"multiplyPower": 2,
"outboundPhoneGroups":[
{
"name":"外呼任务号码批次名称,如:本人、亲属、朋友",
"identify":"default",
"autoOutboundSwitch": 1,
"autoOutboundInterval": 5,
"autoOutboundTimes": 1
}
]
}
返回结果
参数 |
类型 |
说明 |
code |
String |
结果码 |
message |
String |
结果描述 |
data |
boolean |
是否编辑成功 |
CommunicateBaseVo
返回结果示例:
{
"code": "10000",
"message": "请求成功",
"data": true
}
结果码说明
结果码 |
说明 |
10000 |
请求成功 |
10001 |
鉴权失败 |
10002 |
找不到对应的公钥,请先上传公钥 |
20001 |
请求失败 |
29002 |
参数错误 |
29008 |
系统异常 |