编辑自动外呼任务

服务描述

本接口,可用于编辑云呼叫中心自动外呼任务基本信息,规则如下:

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 系统异常

results matching ""

    No results matching ""