查询队列的设置

查询单个或多个队列的详细信息，如：队列号码、队列名称、静态坐席、动态坐席等。

Endpoint

POST /api/v1.1.0/queue/query?token={token}

请求参数

名称 是否必需 类型 描述
queueid 否 String 队列号码。
  • 查询单个队列：设置 queueid 为 IVR 号码。

    例如："queueid":"6700"

  • 查询多个队列：设置 queueid 为 IVR 号码，多个 IVR 之间用 , 隔开。

    例如："queueid": "6700,6701,6702"

  • 查询所有队列：不带 queueid 请求参数。

响应参数

名称 类型 描述
queues Object 对象参数。
queuenumber Int 队列号码。
queuename String 队列号码。
password String 加入动态坐席的密码。
ringstrategy String 响铃策略。
  • Ring All
  • Least Recent
  • Fewest Calls
  • Random
  • Rrmemory
  • Linear
failoveraction String 呼入失败目的地。
agents String 固定坐席。
dynamicagents String 动态坐席。
agenttimeout String 坐席响铃时间。
agentannounce String 坐席应答提示音。
wrapuptime Int 休息时间。
ringinuse String 使用中振铃。
  • on：启用。
  • off：关闭。
retry Int 重试间隔时间。
musiconhold String 等待音乐。
maxwaittime Int 最大等待时间。
joinempty String 无座席时允许呼入。
  • on：启用。
  • off：关闭。
leavewhenempty String 无座席时结束等待。
  • on：启用。
  • off：关闭。
joinannounce String 进入队列提示音。
announcepos String 公告当前位置。
  • on：启用。
  • off：关闭。
announcefreq String 用户公告频率。
announceholdtime Int 公告等待时间。
userannounce String 系统公告提示音。
userannouncefreq Int 系统公告频率。
breakoutkey String 按键 DTMF。
breakoutaction String 按键目标。
breakoutdest String 按键目标的最终目的地。
idannouncement String 报工号提示音文件名。没有设置则默认不播报。此字段默认为 none。
注： 查询队列时此参数为必须返回参数。
satisfactionsurvey String 满意度调查需要播放的提示音文件名。没有设置则默认不播报。此字段默认为 none。

实际示例

请求示例

查询队列6701。

POST /api/v1.1.0/queue/query?token=1e3b3ebb6a974cb42ed31de5413df52d HTTP/1.1
Content-Type:application/json; charset=utf-8
Host: 192.168.5.150
{
    "queueid": "6701"
}

查询所有队列。

POST /api/v1.1.0/queue/query?token=1e3b3ebb6a974cb42ed31de5413df52d HTTP/1.1
Content-Type:application/json; charset=utf-8
Host: 192.168.5.150
响应示例
HTTP/1.1 200 OK
Access-control-allow-origin: *
Access-control-allow-methods: GET, POST, OPTIONS, PUT, DELETE
{
    "status": "Success",
    "queues": [
        {
            "queuenumber": "6700",
            "password": "6700123",
            "queuename": "6700",
            "ringstrategy": "Ring All",
            "failoveraction": "Hang up",
            "agents": "103,102,",
            "dynamicagents":"Local/4001@only-dialextension-q6700,
      ","agenttimeout":"10","agentannounce":"[None
            ]","wrapuptime":"10",
      "ringinuse": "on",
            "retry": "10",
            "musiconhold": "[None]",
            "maxwaittime": "30",
            "joinempty": "on",
            "leavewhenempty": "on",
            "joinannounce": "[None]",
            "announcepos": "off",
            "announcefreq": "15",
            "announceholdtime": "on",
            "userannounce": "[None]",
            "userannouncefreq": "60",
            "breakoutkey": "0",
            "breakoutaction": "Hang up",
            "satisfactionsurvey": "None",
            "idannouncement": "Default"
        }
    ]
}