CloudGetQueue - 获取队列信息

更新时间:
复制 MD 格式

查询队列信息。

调试

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

调试

授权信息

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

请求参数

名称

类型

必填

描述

示例值

EnterpriseId

integer

是

呼叫中心 id

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

7000002

Qno

string

是

队列编号

355

返回参数

名称

类型

描述

示例值

object

AccessDeniedDetail

string

废弃参数

无

RequestId

string

请求 ID。

D9CB3933-9FE3-4870-BA8E-2BEE91B69D23

Message

string

返回信息。

OK

Data

object

返回数据

QueueSkills

array<object>

队列所需技能数组

object

SkillLevel

integer

技能值

5

CreateTime

string

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

2026-03-30 06:12:33

QueueId

integer

队列 id

51937

SkillId

integer

skill 的 id

48734

Id

integer

queueSkill 关系表中 id

51937

EnterpriseId

integer

呼叫中心 id

7000002

Queue

object

队列配置信息

ServiceLevel

integer

服务水平秒数,低于此时间内接听的认为是高服务水平

10

AnnounceSound

integer

播报固定语音 0 关闭 1 打开

0

WrapupTime

integer

整理时间,取值范围 3-3600 秒

30

MaxLen

integer

最大等待数,设置范围 0-999,0 表示不做任何限制

0

Description

string

队列名

queueName

AnnouncePosition

integer

位置播报 0 关闭 1 大于 announce_position_param 时播放 2 小于等于 announce_position_param 时播放

0

AnnounceSoundFile

string

固定语音文件

""

CreateTime

string

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

2026-03-30 06:12:33

QueueTimeout

integer

队列超时时间,取值范围 5-600 秒,默认 600 秒

600

AnnounceSoundFrequency

integer

播放固定语音周期,秒数

0

AnnouncePositionYouarenext

integer

是否播报'您是下一位',0 关闭,1 开启

0

AnnouncePositionParam

integer

多余少余 n 个时播报

0

MemberTimeout

integer

座席超时时间,取值范围 20-60 秒,默认 25 秒

60

Weight

integer

队列优先级,取值范围 1-10,数值越高,优先级越高

10

JoinEmpty

integer

队列中为空时是否可以 join,取值:1:置忙 2:通话中 4:振铃 8:无效 16:整理

1

EnterpriseId

integer

呼叫中心 Id

7000002

Qno

string

队列号

2632

MusicClass

string

等待语音 class

default

Strategy

string

呼叫策略:rrordered:技能优先 rrmemory:轮选 fewestcalls:平均 random:随机 linear:顺序 leastrecent:最长空闲时间

rrordered

Id

integer

队列 id

54473

Retry

integer

座席超时无应答,呼叫下一座席的延迟秒数

5

SayAgentno

boolean

语音报号,true:播报,false:不播报

false

VipSupport

integer

是否支持 vip,1:支持,0:不支持

0

AnnouncePositionFrequency

integer

位置播报周期,秒数

0

Code

string

状态码

OK

示例

正常返回示例

JSON格式

{
  "AccessDeniedDetail": "无",
  "RequestId": "D9CB3933-9FE3-4870-BA8E-2BEE91B69D23",
  "Message": "OK",
  "Data": {
    "QueueSkills": [
      {
        "SkillLevel": 5,
        "CreateTime": "2026-03-30 06:12:33",
        "QueueId": 51937,
        "SkillId": 48734,
        "Id": 51937,
        "EnterpriseId": 7000002
      }
    ],
    "Queue": {
      "ServiceLevel": 10,
      "AnnounceSound": 0,
      "WrapupTime": 30,
      "MaxLen": 0,
      "Description": "queueName",
      "AnnouncePosition": 0,
      "AnnounceSoundFile": "\"\"",
      "CreateTime": "2026-03-30 06:12:33",
      "QueueTimeout": 600,
      "AnnounceSoundFrequency": 0,
      "AnnouncePositionYouarenext": 0,
      "AnnouncePositionParam": 0,
      "MemberTimeout": 60,
      "Weight": 10,
      "JoinEmpty": 1,
      "EnterpriseId": 7000002,
      "Qno": "2632",
      "MusicClass": "default",
      "Strategy": "rrordered",
      "Id": 54473,
      "Retry": 5,
      "SayAgentno": false,
      "VipSupport": 0,
      "AnnouncePositionFrequency": 0
    }
  },
  "Code": "OK"
}

错误码

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

变更历史

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