文档首页/云客服/API参考/座席操作类接口参考/呼叫数据:calldata/查询座席当前呼叫统计信息
更新时间：2025-11-13 GMT+08:00
查看PDF
分享

查询座席当前呼叫统计信息

前置条件

  • 座席已签入
  • 座席正在通话中

场景描述

座席签入后，查询座席当前呼叫统计信息。

此接口频繁调用存在性能问题。

接口方法

设置成“GET”。该接口仅支持GET方法，不支持PUT、POST和DELETE等方法。

接口URI

https://ip:port/agentgateway/resource/calldata/{agentid}/statistics

如果CC-Gateway单机部署，IP地址为CC-Gateway服务器地址，port为CC-Gateway服务器的HTTPS端口号，默认值为8043；如果CC-Gateway采用集群模式部署，IP请配置为NSLB地址， Port请配置为默认值8043。

NSLB上的CC-Gateway端口号，请以nslb用户登录任意一个NSLB节点，执行./nslbctl l查询，查询结果中，如下端口表示CC-Gateway通过NSLB面向第三方系统开放的端口。

SaaS场景下请咨询运维人员获取IP和Port。

表1 URI中携带的参数说明

序号

参数名

数据类型

选取原则

说明

1

agentid

string

True

座席的工号，取值范围：101～999999。

日志中的方法名

queryCallStatisticsInfo

请求说明

  • 消息头
    表2 请求头参数说明

    序号

    名称

    参数类型

    是否必选

    说明

    1

    Content-Type

    string

    True

    消息主体编码方式，缺省值：application/json; charset=UTF-8

    2

    Guid

    string

    True

    静态鉴权（AUTHMODE =1）签入接口返回的Guid；动态鉴权（AUTHMODE =2）轮询事件接口返回的Guid。

  • 消息体

    无

响应说明

表3 消息体参数说明

序号

名称

参数类型

说明

1

message

string

描述

2

retcode

string

错误码。取值如下：

0：成功

非0：失败

3

result

object

查询成功后，返回座席当前呼叫统计信息对象。

该对象的参数说明请参见表4。

表4 result对象参数说明

序号

名称

参数类型

说明

3.1

talktime

long

当日总通话时长，单位 s。

3.2

answernums

int

当日接听次数

3.3

noanswernums

int

当日久不应答次数

3.4

calloutnums

int

当日外呼次数

3.5

intercallnums

int

当日内部呼叫次数

3.6

interhelpnums

int

当日内部求助次数

3.7

transfernums

int

当日转接次数

3.8

transferoutnums

int

当日转出次数

3.9

transferivrnums

int

当日转IVR次数

3.10

redirectnums

int

重定向的次数

3.11

keepnums

int

保持次数

3.12

busynums

int

示忙次数

3.13

restnums

int

请假次数

3.14

restoutnums

int

超假次数

3.15

resttime

long

请假时长（秒）

3.16

restouttime

long

超假时长（秒）

3.17

agentrelease

int

主动释放数

3.18

busytime

long

示忙时长（秒）

触发事件

  • 无

错误结果码

  • 100-006
  • 100-007

报文样例

  • 消息头 
    Content-Type:application/json; charset=UTF-8
Guid：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1
  • 请求参数

    无

  • 响应参数 
    {
    "message": "",
    "retcode": "0",
    "result": {
        "talktime": 4328,
        "answernums": 5,
        "noanswernums": 0,
        "calloutnums": 0,
        "intercallnums": 5,
        "interhelpnums": 0,
        "transfernums": 0,
        "transferoutnums": 0,
        "transferivrnums": 0,
        "redirectnums": 0,
        "keepnums": 0,
        "busynums": 0,
        "restnums": 0,
        "restoutnums": 0,
        "resttime": 0,
        "restouttime": 0,
        "agentrelease": 1,
        "busytime": 0
    }
}