查询队列的通话状态
查询特定队列的通话状态。
请求 URL
GET {base_url}/{api_path}/queue/call_status?access_token={access_token}
请求参数
参数 | 是否必填 | 类型 | 说明 |
---|---|---|---|
id | 是 | Integer | 队列的唯一 ID。 注: 可使用 搜索特定队列 接口查询队列的
ID。
|
响应参数
参数 | 类型 | 说明 |
---|---|---|
errcode | Integer | 返回错误码。
注: 更多错误码和错误信息说明,请参见 错误码 & 错误信息。
|
errmsg | String | 返回信息。
|
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
}