查询队列的设置

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

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