获取呼叫任务列表,支持按照条件查询。
接口说明
前置条件
调用前需在云联络中心控制台创建呼叫中心实例,并从实例访问地址中获取 EnterpriseId。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| EnterpriseId |
integer |
是 |
呼叫中心 id 调用前需在云联络中心控制台创建呼叫中心实例,并从实例访问地址中获取实例 ID。 |
7000002 |
| Type |
integer |
是 |
任务类型;1:预测外呼任务,2:自动外呼任务 |
1 |
| Name |
string |
否 |
任务名称;需进行 UTF-8 格式的 URLEncode 编码 |
name1 |
| Status |
integer |
否 |
任务状态;0.初始 1.运行中 2.暂停 3.结束 |
3 |
| AutoStart |
integer |
否 |
定时开始;0.关闭 1.开启 |
0 |
| AutoStop |
integer |
否 |
定时结束;0.关闭 1.开启 |
0 |
| TimeType |
integer |
否 |
时间过滤条件;1.任务启动时间 2.任务结束时间 3.任务创建时间 |
1 |
| StartTime |
string |
否 |
查询开始时间;格式说明:"2019-10-11 00:00:00" |
2026-04-20 10:00:00 |
| EndTime |
string |
否 |
查询结束时间;格式说明:"2019-10-11 23:59:59" |
2026-04-20 20:00:00 |
| Start |
integer |
否 |
从第几条开始获取;大于等于 0,默认 0 |
0 |
| Limit |
integer |
否 |
需要取出的数据条数;大于 0,最大不能超过 100,默认 10 |
10 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| AccessDeniedDetail |
string |
访问被拒绝详细信息。 |
None |
| RequestId |
string |
请求 ID。 |
D9CB3933-9FE3-4870-BA8E-2BEE91B69D23 |
| Message |
string |
返回信息。 |
OK |
| Data |
object |
返回数据。 |
|
| TaskProperties |
array<object> |
任务列表 |
|
|
object |
|||
| CallVariables |
string |
座席通道变量 |
[{"key1":"value1"},{"key2":"value2"}] |
| OverTime |
string |
任务结束时间 |
example |
| CustomerClidType |
integer |
客户侧外显规则,1.随机 2.按区号 |
1 |
| CustomerVoice |
string |
客户侧提示音 |
example |
| EnterpriseId |
string |
呼叫中心 Id |
7000002 |
| Name |
string |
任务名称 |
name1 |
| Cnos |
string |
座席工号列表 |
1111,2222 |
| Concurrency |
integer |
最大并发限制 |
3 |
| StatusDescription |
string |
任务状态描述 |
"" |
| AgentGroup |
string |
外呼组号 |
WH124 |
| CustomerClids |
string |
客户侧外显号码列表 |
02138276106 |
| AutoComplete |
integer |
自动完成,0.关闭 1.开启 |
0 |
| AutoStart |
integer |
定时开始,0.关闭 1.开启 |
0 |
| CustomerClidWeightFlag |
integer |
外显号码比例配置开关,0.关闭 1.开启 |
0 |
| Status |
integer |
任务状态,0.初始 1.运行中 2.暂停 3.结束 |
2 |
| PauseTime |
string |
任务暂停时间点 格式:yyyy-MM-dd HH:mm:ss。 |
2026-04-20 11:00:00 |
| AutoStartDay |
string |
定时开始日期,格式:yyyy-MM-dd,如:2017-02-11 |
2017-02-11 |
| ClidProperty |
string |
外显规则,Json 格式,外显号码选择规则:默认区号,是否匹配省会等;如:{"defaultAreaCode":"010", "isMatchCapital":"1"} |
example |
| RetryStrategyOnlyToday |
integer |
重试仅当天生效,0.关闭 1.开启,删除待重试的数据和待呼叫的数据 2.开启,删除待重试的数据 3.开启,删除待呼叫的数据 |
4 |
| WarmUpDuration |
integer |
任务预热时间,单位秒 |
9 |
| PredictAdjust |
integer |
超呼率 |
60 |
| StartTime |
string |
任务开始时间 示例采用 HH:mm 格式。 |
09:00 |
| AutoTaskType |
integer |
呼叫方式,0.连续呼叫 1.间隔呼叫 |
50 |
| AutoStartTime |
string |
定时开始时间,格式:HH:mm:ss,如:08:00:00 |
08:00:00 |
| ForceEndFlag |
integer |
定时完成时强制结束任务,开启配置后,当任务到定时完成时间时无论任务中的号码是否已经呼完,均将任务状态设置为结束。适用于对数据有呼叫时间限制的场景。注:任务在结束状态时无法再次启动。 0:否,1:是 |
0 |
| Id |
integer |
外呼任务 Id |
59 |
| Quotiety |
number |
骚扰率,支持小数,精确到小数点两位 |
1.0 |
| AutoTriggerTimeStrategy |
string |
间隔呼叫时间段,呼叫的时间段配置。参数格式:时间条件编号。支持多个,多个使用英文","逗号隔开,如:9,22 |
9,22 |
| RetryStrategy |
string |
重试策略, 「基础模式」 数据结构为 Json 格式 |
{"retry":2,"strategy":[{"round":1,"time":"1-1-1"},{"round":2,"time":"2-2-2"}]} |
| CustomerTimeout |
integer |
客户超时时间,单位秒 |
17 |
| Description |
string |
任务描述 |
desc |
| AutoStopDay |
string |
定时完成日期,格式:yyyy-MM-dd,如:2017-02-11 |
2017-02-11 |
| TimeStrategy |
string |
禁止呼叫时间限制,在特定的时间段内禁止呼叫。参数格式:时间条件编号。支持多个,多个使用英文","逗号隔开,如:9,22。 |
9,22 |
| CustomerClidWeight |
string |
外显号码比例配置内容 |
[{"number":"123,345","weight":"5"},{"number":"567,789","weight":"5"}] |
| MinAvailableAgentCount |
integer |
最小可用座席数 |
2 |
| AgentTimeout |
integer |
座席超时时间,单位秒 |
10 |
| AnswerRate |
integer |
初始化预计客户接通率 |
50 |
| CustomerMoh |
string |
客户侧等待音 |
no |
| UserFields |
string |
任务自定义字段 |
[{"key1":"value1"},{"key2":"value2"}] |
| CallGroupType |
integer |
指定座席方式,1.座席工号列表 2.外呼组 |
1 |
| CreateTime |
string |
任务创建时间 ,格式为: yyyy-MM-dd HH:mm:ss |
2025-10-12 18:03:14 |
| OverCallLimitCnos |
string |
超过呼叫限制的座席 |
0 |
| PauseDuration |
integer |
任务暂停时长(针对自动启动时间段) 单位分钟 |
1 |
| AutoStop |
integer |
定时完成,0.关闭 1.开启 |
0 |
| Wrapup |
integer |
座席整理时间,单位秒 |
13 |
| MaxWaitTime |
integer |
座席最大等待时间,单位秒 |
34 |
| CallRouteStrategy |
integer |
呼叫流转模式, 1.直连座席 2.AI 转人工 直连座席模式:客户接听后直接分配座席,无空闲座席可溢出语音导航(需配置语音导航),保障高优先级客户直连体验 AI 转人工:客户接入后,优先进入语音导航中配置的智能体机器人,按交互结果决定是否转接座席,提升自动化覆盖率,降低人工成本 |
1 |
| StatusTriggerType |
integer |
任务状态变更类型,0.系统变更 1.人为变更 |
0 |
| CallPriorityStrategy |
string |
呼叫顺序,数据结构为 Json 格式 |
{"strategy":[{"sort":1,"type":"retryCall", "desc":0},{"sort":2,"type":"firstCall","orderType":0}]} |
| Type |
integer |
任务类型,1.预测外呼任务 2.自动外呼任务 |
1 |
| IsRewarm |
integer |
暂停后重新预热,0.关闭,1 开启 |
0 |
| RetryStrategyTimeType |
integer |
重试策略时间类型,1.基于首次呼叫时间 2.基于上次呼叫时间 |
1 |
| AutoStopTime |
string |
定时完成时间,格式:HH:mm:ss,如:17:00:00 |
17:00:00 |
| CallLimitStrategy |
string |
座席当日接听数限制,JsonArray 格式[{"cnos":["2000","2001"],"limit":"5"}] |
[{"cnos":["2000","2001"],"limit":"5"}] |
| CallStrategy |
integer |
座席分配规则,1.随机 2.顺序 3.座席未进线最大时(从上一次呼叫结束到当前的总时长) 4.座席状态[空闲]最长时长(座席最近一次切换为空闲状态的持续时长) |
1 |
| IvrId |
integer |
语音导航 Id,预测外呼使用场景:直连座席模式下如果客户接听后未在特定时间内(默认 2 秒)找到可用座席,通话将溢出到语音导航继续排队找座席。同时支持在呼转座席,座席未接听时也溢出到语音导航,需要开启企业配置生效。AI 转人工模式下,呼叫先转到语音导航 自动外呼使用场景:客户接听后,转到的语音导航 |
133 |
| CustomerClidsCategory |
integer |
客户侧外显号码类型,1.外显固话 2.外显手机号 4.外显号码池 5.外显导航 |
1 |
| Code |
string |
响应码 |
OK |
示例
正常返回示例
JSON格式
{
"AccessDeniedDetail": "None",
"RequestId": "D9CB3933-9FE3-4870-BA8E-2BEE91B69D23",
"Message": "OK",
"Data": {
"TaskProperties": [
{
"CallVariables": "[{\"key1\":\"value1\"},{\"key2\":\"value2\"}]",
"OverTime": "example",
"CustomerClidType": 1,
"CustomerVoice": "example",
"EnterpriseId": "7000002",
"Name": "name1",
"Cnos": "1111,2222",
"Concurrency": 3,
"StatusDescription": "\"\"",
"AgentGroup": "WH124",
"CustomerClids": "02138276106",
"AutoComplete": 0,
"AutoStart": 0,
"CustomerClidWeightFlag": 0,
"Status": 2,
"PauseTime": "2026-04-20 11:00:00",
"AutoStartDay": "2017-02-11",
"ClidProperty": "example",
"RetryStrategyOnlyToday": 4,
"WarmUpDuration": 9,
"PredictAdjust": 60,
"StartTime": "09:00",
"AutoTaskType": 50,
"AutoStartTime": "08:00:00",
"ForceEndFlag": 0,
"Id": 59,
"Quotiety": 1,
"AutoTriggerTimeStrategy": "9,22",
"RetryStrategy": "{\"retry\":2,\"strategy\":[{\"round\":1,\"time\":\"1-1-1\"},{\"round\":2,\"time\":\"2-2-2\"}]}",
"CustomerTimeout": 17,
"Description": "desc",
"AutoStopDay": "2017-02-11",
"TimeStrategy": "9,22",
"CustomerClidWeight": "[{\"number\":\"123,345\",\"weight\":\"5\"},{\"number\":\"567,789\",\"weight\":\"5\"}]",
"MinAvailableAgentCount": 2,
"AgentTimeout": 10,
"AnswerRate": 50,
"CustomerMoh": "no",
"UserFields": "[{\"key1\":\"value1\"},{\"key2\":\"value2\"}]",
"CallGroupType": 1,
"CreateTime": "2025-10-12 18:03:14",
"OverCallLimitCnos": "0",
"PauseDuration": 1,
"AutoStop": 0,
"Wrapup": 13,
"MaxWaitTime": 34,
"CallRouteStrategy": 1,
"StatusTriggerType": 0,
"CallPriorityStrategy": "{\"strategy\":[{\"sort\":1,\"type\":\"retryCall\", \"desc\":0},{\"sort\":2,\"type\":\"firstCall\",\"orderType\":0}]}",
"Type": 1,
"IsRewarm": 0,
"RetryStrategyTimeType": 1,
"AutoStopTime": "17:00:00\n\n",
"CallLimitStrategy": "[{\"cnos\":[\"2000\",\"2001\"],\"limit\":\"5\"}]",
"CallStrategy": 1,
"IvrId": 133,
"CustomerClidsCategory": 1
}
]
},
"Code": "OK"
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。