CloudUpdateTask - 修改呼叫任务

更新时间:
复制为 MD 格式

修改外呼任务的基础信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称

类型

必填

描述

示例值

EnterpriseId

integer

呼叫中心 id

7000002

TaskId

string

外呼任务 Id

133224

Name

string

任务名称;需进行 UTF-8 格式的 URLEncode 编码,长度小于 50 字

任务名称-1

Description

string

任务描述;需进行 UTF-8 格式的 URLEncode 编码,长度小于 200 字

描述任务信息

AutoStart

integer

定时开始;0.关闭 1.开启,默认关闭。值为 1 时 autoStartDay 和 autoStartTime 参数才生效,并且至少设置其中的一个

0

AutoStartDay

string

定时开始日期;autoStart=1 时生效。参数不传入时默认在当天的 autoStartTime 定时启动。格式:yyyy-MM-dd,如:2026-01-01

2026-01-01

AutoStartTime

string

定时开始时间;autoStart=1 时生效。参数不传入时默认在 autoStartDay 的 00:00:00 定时启动。格式:HH:mm:ss,如:08:00:00

08:00:00

AutoStop

integer

定时完成;0.关闭 1.开启,默认关闭。值为 1 时 autoStopDay 和 autoStopTime 参数才生效,并且至少设置其中的一个

0

AutoStopDay

string

定时完成日期;autoStop=1 时生效。参数不传入时默认在当天的 autoStopTime 定时完成。格式:yyyy-MM-dd,如:2026-01-01

定时完成日期;autoStop=1时生效。参数不传入时默认在当天的autoStopTime定时完成。格式:yyyy-MM-dd,如:2026-01-01

AutoStopTime

string

定时完成时间;autoStop=1 时生效。参数不传入时默认在 autoStopDay 的 23:59:59 定时完成。格式:HH:mm:ss,如:17:00:00

17:00:00

ForceEndFlag

integer

定时完成时强制结束任务;autoStop=1 时生效。0.关闭 1.开启,默认关闭。开启配置后,当任务到定时完成时间时无论任务中的号码是否已经呼完,均将任务状态设置为结束。适用于对数据有呼叫时间限制的场景。注:任务在结束状态时无法再次启动。

0

AutoTaskType

integer

0.连续呼叫 1.间隔呼叫,默认连续呼叫。配合定时开始(autoStart)和定时结束(autoStop)参数使用,如任务需要在每天的特定时间段内呼叫则开启间隔呼叫方式

0

AutoTriggerTimeStrategy

string

间隔呼叫时间段;autoTaskType=1 时必填。呼叫的时间段配置。参数格式:时间条件编号。支持多个,多个使用英文","逗号隔开,如:9,22。注:时间条件列表可通过查询时间条件设置列表接口获取

9,22

AutoComplete

integer

0.关闭 1.开启,默认开启。开启:任务中的号码呼叫完后,任务自动完成,状态设置为结束,关闭:任务中的号码呼叫完后,任务自动暂停,状态设置为暂停注:任务在结束状态时无法再次启动。

1

RetryStrategy

string

重试策略;「基础模式」数据结构为 Json 格式{"retry":2,"strategy":[{"round":1,"time":"1-1-1"},{"round":2,"time":"2-2-2"}]}格式说明:retry 是重试次数,round 是第几次重试,time 是第几次重试间隔的时间:1-1-1,第一个 1 是天,第二个 1 是小时,第三个 1 是分钟「高级模式」高级模式需要开启「号码状态识别」服务数据结构为 JsonArray 格式 [{"condition":{"sipCause":[710,719]},"retry":1,"sort":1,"strategy":[{"round":1,"time":"0-0-10"}]},{"condition":{"sipCause":[800]},"retry":1,"sort":2,"strategy":[{"round":2,"time":"0-0-10"}]}]格式说明:condition 是重试条件,sort 是重试条件的顺序,其余字段与基础模式一致 注:基础模式和高级模式的区分根据传入的参数格式自动识别。基于首次呼叫时间重试时,每轮的重试时间必须大于上一轮的时间

{"retry":2,"strategy":[{"round":1,"time":"1-1-1"},{"round":2,"time":"2-2-2"}]}

RetryStrategyTimeType

integer

重试策略时间类型;配置重试策略时生效。 1.基于首次呼叫时间 2.基于上次呼叫时间,默认基于首次呼叫时间

1

RetryStrategyOnlyToday

integer

任务仅当天生效;0.关闭 1.开启,删除待重试的数据和待呼叫的数据 2.开启,删除待重试的数据 3.开启,删除待呼叫的数据,默认关闭

0

CallPriorityStrategy

string

数据结构为 Json 格式{"strategy":[{"sort":1,"type":"retryCall", "desc":0},{"sort":2,"type":"firstCall","orderType":0}]}格式说明:sort 是重试号码和未呼叫号码的呼叫顺序 type:retryCall 重试号码、firstCall 未呼叫号码当 type=retryCall,desc:0.优先呼叫待重呼轮次数值较小的号码,即轮次靠前(如第 1 轮、第 2 轮)的号码先被呼叫 1.优先呼叫待重呼轮次数值较大的号码,即轮次靠后(如第 5 轮、第 4 轮)的号码先被呼叫当 type=firstCall 时,orderType:随机呼叫,0 顺序(优先级) 1 随机 2 顺序(导入时间)

{"strategy":[{"sort":1,"type":"retryCall", "desc":0},{"sort":2,"type":"firstCall","orderType":0}]}

CustomerClidsCategory

integer

客户侧外显号码类型;1.外显固话 2.外显手机号 4.外显号码池 5.外显导航注:推荐使用外显导航,可以灵活调整和控制外显策略。其他类型将逐步下线

1

CustomerClids

string

客户侧外显号码列表;customerClidsCategory=1 或 2 时必填。支持多个,多个直接使用英文逗号','分隔。不建议使用

64203667,23434294

CustomerClidType

integer

客户侧外显规则;customerClidsCategory=1 或 2 时生效。1.随机 2.按区号,默认随机。不建议使用

1

ClidProperty

string

外显规则;customerClidType=2 时生效。Json 格式,外显号码选择规则:默认区号,是否匹配省会等;如:{"defaultAreaCode":"010", "isMatchCapital":"1"}。不建议使用

{"defaultAreaCode":"010", "isMatchCapital":"1"}

CustomerClidWeightFlag

integer

外显号码比例配置开关;customerClidsCategory=1 时生效。0.关闭 1.开启,默认关闭。不建议使用

0

CustomerClidWeight

string

外显号码比例配置内容;customerClidsCategory=1 且 customerClidWeightFlag=1 时生效。JsonArray 格式 [{"number":"123,345","weight":"5"}, {"number":"567,789","weight":"5"}],不建议使用

[{"number":"123,345","weight":"5"}, {"number":"567,789","weight":"5"}]

CustomerClidsGroup

string

客户侧外显号码池名称或外显导航标识;customerClidsCategory=4 或 5 时必填。customerClidsCategory=4 时 customerClidsGroup 传号码池名称。customerClidsCategory=5 时 customerClidsGroup 传外显导航标识

示例值

CustomerTimeout

integer

客户超时时间;单位秒数,默认 30 秒,取值范围 5 ~ 60

55

CallRouteStrategy

integer

1.直连座席 2.AI 转人工 直连座席模式:客户接听后直接分配座席,无空闲座席可溢出语音导航(需配置语音导航),保障高优先级客户直连体验 AI 转人工:客户接入后,优先进入语音导航中配置的智能体机器人,按交互结果决定是否转接座席,提升自动化覆盖率,降低人工成本

1

IvrId

integer

语音导航 Id;参数 ivrId 和 ivrName 二选一,同时传入时 ivrId 生效,在创建自动外呼任务时 ivrId 或 ivrName 必选其一。预测外呼使用场景:如果客户接听后未在特定时间内(默认 2 秒)找到可用座席,通话将溢出到语音导航继续排队找座席。同时支持在呼转座席,座席未接听时也溢出到语音导航,需要开启企业配置生效自动外呼使用场景:客户接听后,转到的语音导航

13

IvrName

string

语音导航名称;参数 ivrId 和 ivrName 二选一,同时传入时 ivrId 生效,在创建自动外呼任务时 ivrId 或 ivrName 必选其一。

IvrName1

Concurrency

integer

任务维度限制最大并发数,实际并发不会超过最大并发限制。type=1 时,配置成 0 表示不限制,座席数量少于 10 时建议配置该参数

0

UserFields

string

任务自定义字段。JsonArray 格式;数组的每个元素只支持传递一组键值对,传递多组只取第一组,如 {"key", "value"}。 默认空值,示例:[{"name":"1234"},{"name1":"12345"}] 注:单个字段值的长度不能超过 1000 个字符

[{"name":"1234"},{"name1":"12345"}]

CallVariables

string

座席通道变量。JsonArray 格式;最大支持 5 个变量。默认空值, 示例:[{"name":"abcdefg","value":"${cdr_enterprise_id}"}] 注:单个字段值的长度不能超过 1000 个字符。变量会以 SIP_HEADER 的形式设置到座席侧通道

[{"name":"abcdefg","value":"${cdr_enterprise_id}"}]

TimeStrategy

string

禁呼时间;在特定的时间段内禁止呼叫。参数格式:时间条件编号。支持多个,多个使用英文","逗号隔开,如:9,22。注:时间条件列表可通过查询时间条件设置列表接口获取

9,22

Cnos

string

座席工号列表;callGroupType=1 时必填。支持多个座席工号,多个之间使用英文逗号','分隔注:一个座席只能在一个运行中的任务中

1111,2222

AgentGroup

string

外呼组号;callGroupType=2 时必填。注:一个外呼组可以绑定到多个任务,但只能同时运行一个任务中

6,7

CallStrategy

string

座席分配规则;1.随机 2.顺序 3.座席未进线最大时(从上一次呼叫结束到当前的总时长) 4.座席状态[空闲]最长时长(座席最近一次切换为空闲状态的持续时长),默认随机

1

AgentTimeout

integer

座席超时时间;单位秒数,默认 10 秒,取值范围 5 ~ 60

50

Wrapup

integer

座席整理时间;默认 30 秒,取值范围 1~10800,整理时间会影响每次呼叫的个数,值越大,呼叫号码个数会减小

30

MaxWaitTime

integer

座席最长等待时间;默认 40 秒,最小 10,最大 600,允许座席空闲的最大时间。任务执行过程中,如果座席平均空闲时间大于 maxWaitTime,每次呼叫个数会增加

40

MinAvailableAgentCount

integer

最小可用座席数;默认为 10,取值范围 1 ~ 10。任务内可用座席数小于当前值时,任务自动暂停,避免骚扰

10

Quotiety

number

骚扰率;默认值为 1,取值范围为大于 0,小于等于 20,支持小数,精确到小数点两位。值越小呼叫的号码越少,值越大呼叫的号码越多,座席利用率越高

19.00

PredictAdjust

integer

超呼率;默认值为 100,取值范围 50~400

100

CallLimitStrategy

string

座席当日接听的通话个数上限,使用方式详见下方说明;JsonArray 格式 [{"cnos":["2000","2001"],"limit":"5"}] 注:使用座席当日接听数限制功能需开启企业配置,功能开启并且配置上限后系统才开始统计当日接听数

[{"cnos":["2000","2001"],"limit":"5"}]

CustomerMoh

string

客户侧等待音;客户接听后呼叫座席,等待座席接听时播放的语音,默认为空白音。支持公共语音和企业语音,值为语音文件的 path,如:60000011533526918819

60000011533526918819

CustomerVoice

string

客户侧提示音;客户接听后呼转座席前播放的语音,提示音播放完成后再找座席,默认无提示音。支持公共语音和企业语音,值为语音文件的 path,如:60000011533526918819

60000011533526918819

AnswerRate

integer

初始化预计客户接通率;默认 50,取值范围 1~100,预热阶段的呼叫,按照此接通率计算呼叫频率

50

WarmUpDuration

integer

任务预热时间;默认 300 秒, 取值范围 60 ~ 600

370

IsRewarm

integer

暂停后重新预热;0.关闭,1 开启,默认开启,任务暂停后是否需要重新预热

1

返回参数

名称

类型

描述

示例值

object

AccessDeniedDetail

string

访问被拒绝详细信息。

RequestId

string

请求 ID。

6086693B-2250-17CE-A41F-06259AB6DB1B

Message

string

描述信息。

OK

Data

object

返回的数据内容。

OverTime

string

任务结束时间

2026-01-0114:00:00

CustomerTimeout

string

客户超时时间,单位秒

5

Description

string

任务描述。

任务描述

AutoStopDay

string

定时完成日期,格式:yyyy-MM-dd

2026-02-11

AgentTimeout

string

座席超时时间,单位秒

30

EnterpriseId

string

呼叫中心 id

8001654

Name

string

任务名称。

任务名称

Cnos

string

座席工号列表

1111

Concurrency

string

最大并发限制

10

CustomerClids

string

客户侧外显号码列表

42366453,74565327

AutoComplete

integer

自动完成,0.关闭 1.开启

0

AutoStart

string

定时开始,0.关闭 1.开启

0

AnswerRate

string

初始化预计客户接通率

55

Status

string

任务状态,0.初始 1.运行中 2.暂停 3.结束

3

CustomerMoh

string

客户侧等待音

客户侧等待音

AutoStartDay

string

定时开始日期,格式:yyyy-MM-dd

2026-02-11

UserFields

string

任务自定义字段,JsonArray 格式

[{"key1":"value1"},{"key2":"value2"}]

PredictAdjust

string

超呼率

超呼率

CreateTime

string

任务创建时间 ,格式为: yyyy-MM-dd HH:mm:ss

2026-02-10 14:00:00

StartTime

string

任务开始时间

2026-02-10 15:00:00

AutoStop

string

定时完成,0.关闭 1.开启

0

Wrapup

string

座席整理时间,单位秒

5

MaxWaitTime

string

座席最大等待时间,单位秒

10

Type

string

任务类型,1.预测外呼任务 2.自动外呼任务

2

AutoStartTime

string

定时开始时间,格式:HH:mm:ss,如:08:00:00

08:00:00

IsRandom

string

随机呼叫,0.关闭 1.开启

0

AutoStopTime

string

定时完成时间,格式:HH:mm:ss,如:17:00:00

17:00:00

Id

string

任务 ID。

123

IvrId

string

语音导航 Id

133

Quotiety

string

骚扰率,支持小数,精确到小数点两位

0.33

Code

string

状态码

OK

示例

正常返回示例

JSON格式

{
  "AccessDeniedDetail": "无",
  "RequestId": "6086693B-2250-17CE-A41F-06259AB6DB1B",
  "Message": "OK",
  "Data": {
    "OverTime": "2026-01-0114:00:00",
    "CustomerTimeout": "5",
    "Description": "任务描述",
    "AutoStopDay": "2026-02-11",
    "AgentTimeout": "30",
    "EnterpriseId": "8001654",
    "Name": "任务名称",
    "Cnos": "1111",
    "Concurrency": "10",
    "CustomerClids": "42366453,74565327",
    "AutoComplete": 0,
    "AutoStart": "0",
    "AnswerRate": "55",
    "Status": "3",
    "CustomerMoh": "客户侧等待音",
    "AutoStartDay": "2026-02-11",
    "UserFields": "[{\"key1\":\"value1\"},{\"key2\":\"value2\"}]",
    "PredictAdjust": "超呼率",
    "CreateTime": "2026-02-10 14:00:00",
    "StartTime": "2026-02-10 15:00:00",
    "AutoStop": "0",
    "Wrapup": "5",
    "MaxWaitTime": "10",
    "Type": "2",
    "AutoStartTime": "08:00:00",
    "IsRandom": "0",
    "AutoStopTime": "17:00:00",
    "Id": "123",
    "IvrId": "133",
    "Quotiety": "0.33"
  },
  "Code": "OK"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情