CloudQueryTask - 获取呼叫任务列表

更新时间:
复制 MD 格式

获取呼叫任务列表,支持按照条件查询。

接口说明

前置条件

调用前需在云联络中心控制台创建呼叫中心实例,并从实例访问地址中获取 EnterpriseId。

调试

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

调试

授权信息

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

请求参数

名称

类型

必填

描述

示例值

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"}]} 格式说明: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"}]}

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}]},格式说明: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}]}

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"
}

错误码

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

变更历史

更多信息,参考变更详情。