修改外呼任务的基础信息。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| 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"}]} |
| 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}]} |
| 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"
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。