获取多个任务
服务描述
本接口,可根据任务id集合获取外呼任务
开发须知
调用本接口前,请先获取appId
服务地址
POST https://{您的专属域名}/speech/openapi/v1/task/outbound/gets
请求参数
参数 |
位置 |
类型 |
是否必填 |
说明 |
appId |
header |
String |
Y |
应用ID |
timestamp |
header |
String |
Y |
时间戳,毫秒 |
sign |
header |
String |
Y |
签名 |
Content-Type |
header |
String |
Y |
application/json |
taskIds |
Body |
List |
Y |
任务id集合 |
请求示例数据:
POST https://abc.xyz/speech/openapi/v1/task/outbound/gets
sign: fo1OWX+JnfeonAFSGau2gwP1GvFa+RTw5czoBWoz+k3AjV8scDl6JnvFRDj8Lgt1nQxLlmcOhIBN4j7pEE/NAzYjXUFSGo308f5V9dHBnmGLYsqKmgma4cQZLBqHp9T43IZfRX8Zh2/Hp2HOmfTgos/L8GN6YPA8fQ2d5tbtJZrrkBuwA/LEezjOJxSRRRCrcS1ZFVvTZ+cIjYeO4QdC5r5I67LLY/nLbFAFUdQsCzUIytO09vUCLGlKierNhPfCtMzTgZSE9dWO5zJ3L2uCsXM7Od6mPROVpddVafF+BueKjtbL10PwDc9f1eBpGTpgmbOy8Bbx3NIyCjDvhc9Mag==
appId: 99845aaaaebd4d61acccc9b776208f12
timestamp: 1586314097995
请求Body
[1,2,3]
返回结果
参数 |
类型 |
说明 |
code |
String |
结果码 |
message |
String |
结果描述 |
data |
List<TaskInfo> |
任务数据 |
TaskInfo
参数 |
类型 |
说明 |
taskId |
Number |
任务id |
taskName |
String |
任务名称 |
taskType |
Integer |
任务类型(1自动外呼,2手动外呼) |
taskStatus |
Integer |
任务状态(1:未开始,2:已暂停,3:进行中,4.已完成,5.已过期,6.任务执行异常) |
taskExecStartDate |
String |
任务开始时间(YYYY-MM-DD) |
taskExecEndDate |
String |
任务结束时间(YYYY-MM-DD) |
taskExecTimes |
List<SpeechTaskExecTimeOpenDto> |
任务拨打时间段,自动外呼时有值 |
taskDesc |
String |
任务描述 |
skillSetId |
String |
技能组id,通过接口外呼技能组获取 |
skillSetName |
String |
技能组名称 |
outboundNumberGroupId |
String |
外呼号码组id,自动外呼时有值,通过接口外呼号码组获取 |
strategyDisplaySwitch |
Boolean |
策略外显开关(true:开启,false:关闭),自动外呼时有值 |
sendNumberStrategy |
Integer |
送号策略(0、按倍率值计算 ; 1、预测式外呼),自动外呼时有值 |
multiplyPower |
Integer |
倍率值,送号策略=0时必填 |
abandonmentRate |
Integer |
放弃率,送号策略=1时必填 |
maxRingingDuration |
Integer |
最大振铃时间(最小值20s,最大值50s,默认45s),自动外呼时有值 |
acw |
Integer |
话后时长(1s-180s,默认10s),自动外呼时有值 |
outboundPhoneGroups |
List<OutBoundTaskPhoneGroupVo> |
话后时长(1s-180s,默认10s) |
taskAgents |
List<SpeechTaskAgentOpenDto> |
坐席分配客户数量,手动外呼时有值 |
customerAmount |
int |
名单总数 |
completedCount |
int |
完成名单数量 |
connectedCount |
int |
已接通名单数量 |
connectPercentage |
String |
接通率(百分比) |
taskProgress |
String |
任务进度(百分比) |
SpeechTaskExecTimeOpenDto
参数 |
类型 |
说明 |
taskExecTimeStartStr |
String |
任务执行开始时间,格式:HH:mm:ss |
taskExecTimeEndStr |
String |
任务执行结束时间,格式:HH:mm:ss |
OutBoundTaskPhoneGroupVo
参数 |
类型 |
说明 |
name |
String |
号码组名称 |
identify |
String |
号码组-标识 |
autoOutboundSwitch |
Integer |
自动外呼- 自动重呼设置开关 1-开启 0-关闭 |
autoOutboundInterval |
Integer |
自动外呼- 自动重呼间隔时间(分钟) |
autoOutboundTimes |
Integer |
自动外呼- 自动重呼次数 |
SpeechTaskAgentOpenDto
参数 |
类型 |
说明 |
agentId |
Integer |
坐席id |
assignNum |
Integer |
分配客户数量 |
返回结果示例:
{
"code": "10000",
"message": "请求成功",
"data": {
"taskId": 1618,
"taskName": "autotest050",
"taskType": 1,
"taskStatus": 3,
"taskExecStartDate": "2020-09-20",
"taskExecEndDate": "2020-10-30",
"taskExecTimes": [
{
"taskExecTimeStartStr": "11:36:00",
"taskExecTimeEndStr": "21:35:00"
}
],
"taskDesc": "自动外呼",
"skillSetId": "1495152791910144",
"outboundNumberGroupId": "1070678044124425",
"strategyDisplaySwitch": true,
"sendNumberStrategy": 0,
"abandonmentRate": 1,
"multiplyPower": 1,
"maxRingingDuration": 20,
"acw": 10,
"taskAgents": null,
"outboundPhoneGroups": [
{
"name": "1",
"identify": "default",
"autoOutboundSwitch": 1,
"autoOutboundInterval": 5,
"autoOutboundTimes": 1
}
],
"customerAmount": 10,
"completedCount": 10,
"connectedCount": 5,
"connectPercentage": "50.00%",
"taskProgress": "100.00%"
}
}
结果码说明
结果码 |
说明 |
10000 |
请求成功 |
10001 |
鉴权失败 |
10002 |
找不到对应的公钥,请先上传公钥 |
20001 |
请求失败 |
29002 |
参数错误 |
29008 |
系统异常 |