实时统计座席通话数据。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| EnterpriseId |
integer |
是 |
呼叫中心 id |
7000002 |
| Fields |
string |
否 |
统计项名称;取队列实时统计的统计字段名称,多个队列统计项之间使用英文逗号","分隔,默认查询所有统计项 |
"" |
| Cnos |
string |
否 |
说明:根据座席工号查询指定座席的统计项名称支持按照多个座席工号进行查询,多个座席工号之间使用英文逗号","分隔,默认查询账户下所有座席的统计信息 |
1111 |
| IsUseGno |
integer |
否 |
是否需要外呼组查询;说明:0 关闭外呼组查询,1 开启外呼组查询。默认为关闭状态 |
0 |
| Gno |
string |
否 |
说明:根据外呼组编号查询指定座席的统计项名称支持按照多个外呼组编号进行查询,多个座席工号之间使用英文逗号","分隔,默认查询账户下所有座席的统计信息 |
WH123 |
| Limit |
integer |
否 |
条数;正整数,默认值是 10,最大值是 500 |
10 |
| Offset |
integer |
否 |
查询页码数的起始条数;正整数,默认值是 0;与 limit 同步使用,例:offset=50,limit=10,表示查询第 6 页,每页 10 条数据,即总记录的第 51-60 条数据 |
0 |
| StartHour |
integer |
否 |
统计时间段;正整数,0~23,最大值是 23 时 |
0 |
| EndHour |
integer |
否 |
统计时间段;正整数,1~24,最大值是 24 时 |
23 |
| IsNeedQueueName |
string |
否 |
是否需要返回队列名称;0:不需要(默认) 1:需要 |
0 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| AccessDeniedDetail |
string |
废弃参数 |
无 |
| RequestId |
string |
请求 ID |
9FF70B74-1B3C-44C1-ACDF-8DF962988F0E |
| Message |
string |
返回信息。 |
OK |
| Data |
object |
返回数据。 |
|
| AgentStatistics |
array<object> |
座席统计项数组 |
|
|
object |
|||
| Idle_count |
string |
总空闲次数 |
5 |
| GroupName |
string |
外呼组名称 |
gpname |
| Max_idle_time |
string |
最大空闲时长 |
52375 |
| Cno |
string |
座席工号 |
1111 |
| Ob_bridge_count |
string |
总外呼通话次数 |
4 |
| Min_ob_calling_time |
string |
外呼呼叫最小时长 |
8 |
| Gno |
string |
外呼组编号 |
WH123 |
| Preview_ob_max_bridge_time |
string |
双方接听最大通话时长 |
41 |
| Min_ob_wrapup_time |
string |
外呼整理最小时长 |
30 |
| Max_ob_bridge_time |
string |
外呼通话最大时长 |
41 |
| Ob_bridge_time |
string |
外呼通话时长 |
144 |
| Preview_ob_total_count |
string |
预览外呼数 |
5 |
| Max_ob_wrapup_time |
string |
外呼整理最大时长 |
30 |
| Ob_wrapup_count |
string |
总外呼整理次数 |
4 |
| CurrentState |
string |
status: 代表座席状态,状态每个值对应的含义: stateIdle: 置闲; statePause: 置忙; stateCalling: 呼叫中; stateInuse: 通话中; stateWrapup: 整理, loginTime: 代表座席登录时间, startTime: 代表开始通话的时间 |
{\"state\":\"stateIdle\",\"startTime\":\"1491462675\"} |
| Ob_calling_time |
string |
外呼呼叫时长 |
67 |
| Idle_time |
string |
总空闲时长 |
54344 |
| QueueName |
string |
队列名 |
0005,0006,test测试 |
| Preview_ob_valid_calls |
string |
预览外呼有效通话次数 |
4 |
| Min_ob_bridge_time |
string |
外呼通话最小时长 |
29 |
| Ob_wrapup_time |
string |
外呼整理时长 |
120 |
| Preview_ob_agent_answered_count |
string |
预览外呼座席接听数 |
4 |
| Preview_ob_min_bridge_time |
string |
双方接听最小通话时长 |
29 |
| Preview_ob_both_answered_count |
string |
预览外呼双方接听数 |
4 |
| Ob_calling_count |
string |
总外呼呼叫次数 |
5 |
| Min_idle_time |
string |
最小空闲时长 |
9 |
| Preview_ob_total_bridge_time |
string |
双方接听总通话时长 |
144 |
| Max_ob_calling_time |
string |
外呼呼叫最大时长 |
31 |
| Preview_ob_valid_total_bridge_time |
string |
预览外呼有效通话总时长 |
144 |
| Total |
string |
总数据条数 |
26 |
| Date |
string |
日期,格式为:yyyy-MM-dd |
2026-04-06 |
| Code |
string |
状态码。 |
OK |
示例
正常返回示例
JSON格式
{
"AccessDeniedDetail": "无",
"RequestId": "9FF70B74-1B3C-44C1-ACDF-8DF962988F0E",
"Message": "OK",
"Data": {
"AgentStatistics": [
{
"Idle_count": "5",
"GroupName": "gpname",
"Max_idle_time": "52375",
"Cno": "1111",
"Ob_bridge_count": "4",
"Min_ob_calling_time": "8",
"Gno": "WH123",
"Preview_ob_max_bridge_time": "41",
"Min_ob_wrapup_time": "30",
"Max_ob_bridge_time": "41",
"Ob_bridge_time": "144",
"Preview_ob_total_count": "5",
"Max_ob_wrapup_time": "30",
"Ob_wrapup_count": "4",
"CurrentState": "{\\\"state\\\":\\\"stateIdle\\\",\\\"startTime\\\":\\\"1491462675\\\"}",
"Ob_calling_time": "67",
"Idle_time": "54344",
"QueueName": "0005,0006,test测试",
"Preview_ob_valid_calls": "4",
"Min_ob_bridge_time": "29",
"Ob_wrapup_time": "120",
"Preview_ob_agent_answered_count": "4",
"Preview_ob_min_bridge_time": "29",
"Preview_ob_both_answered_count": "4",
"Ob_calling_count": "5",
"Min_idle_time": "9",
"Preview_ob_total_bridge_time": "144",
"Max_ob_calling_time": "31",
"Preview_ob_valid_total_bridge_time": "144"
}
],
"Total": "26",
"Date": "2026-04-06"
},
"Code": "OK"
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。