查询队列的通话状态

查询特定队列的通话状态。

请求 URL 

GET {base_url}/{api_path}/queue/call_status?access_token={access_token}

请求参数

参数 是否必填 类型 说明
id 是 Integer 队列的唯一 ID。
注： 可使用 搜索特定队列 接口查询队列的 ID。

响应参数

参数 类型 说明
errcode Integer 返回错误码。
  • 0：请求成功。
  • 非零值：请求失败。
注： 更多错误码和错误信息说明，请参见 错误码 & 错误信息。
errmsg String 返回信息。
  • SUCCESS：请求成功。
  • FAILURE：请求失败。
waiting_list Array <Waiting_List> 队列中等待接听的来电信息。
active_list Array <Active_List> 队列中正在进行的通话的信息。
waiting_calls Integer 队列中等待接听的来电数量。
active_calls Integer 队列中正在进行的通话的数量。
ringing_list Array <Ringing_List> 队列中正在响铃中的来电信息。
ringing_calls Integer 队列中正在响铃的来电数量。
Waiting_List
参数 类型 说明
call_id String 来电的唯一 ID。
caller_number String 呼叫者号码。
caller_display_name String 呼叫者姓名。
callee_number String 队列的 ID。
callee_display_name String 队列的名称。
duration Integer 来电在队列中等待的时间 (单位：秒)。
Active_List
参数 类型 说明
call_id String 通话的唯一 ID。
caller_number String 呼叫者号码。
caller_display_name String 呼叫者姓名。
callee_number String 接听来电的坐席的分机号码。
callee_display_name String 接听来电的坐席的姓名。
duration Integer 通话时间 (单位：秒)。
Ringing_List
参数 类型 说明
call_id String 来电的唯一 ID。
caller_number String 呼叫者号码。
caller_display_name String 呼叫者姓名。
callee_number String 响铃中的坐席的分机号码。
callee_display_name String 响铃中的坐席姓名。
duration Integer 坐席已响铃时间 (单位：秒)。

示例

请求示例

查询 ID 为 3 的队列的当前通话状态。

GET /openapi/v1.0/queue/call_status?access_token=CJal3eRlDZ987eX672NtVXsImV2wR8TZ&id=3 HTTP/1.1
Host: 192.168.5.150:8088

响应示例

HTTP/1.1 200 OK
{
    "errcode": 0,
    "errmsg": "SUCCESS",
    "waiting_list": [
        {
            "call_id": "1699424450.42",
            "caller_number": "5505501",
            "caller_display_name": "Leo Ball",
            "callee_number": "6402",
            "callee_display_name": "技术支持",
            "duration": 5
        }
    ],
    "active_list": [
        {
            "call_id": "1699424409.38",
            "caller_number": "5003301",
            "caller_display_name": "",
            "callee_number": "1006",
            "callee_display_name": "Kristin Hale",
            "duration": 24
        },
        {
            "call_id": "1699424381.30",
            "caller_number": "5003001",
            "caller_display_name": "Joe Lewis",
            "callee_number": "1001",
            "callee_display_name": "Phillip Huff",
            "duration": 56
        }
    ],
    "waiting_calls": 1,
    "active_calls": 2,
    "ringing_list": [
        {
            "call_id": "1699424450.144",
            "caller_number": "5505501",
            "caller_display_name": "Leo Ball",
            "callee_number": "1003",
            "callee_display_name": "Joe Lewis",
            "duration": 3
        }
    ],
    "ringing_calls": 1
}