CloudGetQueue - 获取队列信息

更新时间:
复制为 MD 格式

查询队列信息。

调试

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

调试

授权信息

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

请求参数

名称

类型

必填

描述

示例值

EnterpriseId

integer

呼叫中心 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"
}

错误码

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

变更历史

更多信息,参考变更详情