文档首页/云客服/API参考/监控类接口参考/接口说明/实时数据查询类接口/座席维度实时接口/获取座席操作详情
更新时间：2025-11-13 GMT+08:00
查看PDF
分享

获取座席操作详情

场景描述

查询座席操作详情，所查询的数据留存日期为一天。

接口方法

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

请求URL

https://ip:port/rest/cmsapp/v1/openapi/agent/agentoprinfo

其中，公有云环境请联系管理员获取，ip为CC-CMS服务器地址，port为CC-CMS服务器的HTTPS端口号。

非公有云环境如果配置了NSLB服务，ip请填写NSLB的服务器地址，port为CC-CMS服务在NSLB映射的HTTPS端口号。

请求说明

表1 请求头参数

序号

名称

参数类型

是否必选

说明

1

Content-Type

String

True

固定填 application/json; charset=UTF-8。

2

Authorization

String

True

生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。

表2 消息体参数说明

参数名

数据类型

是否必选

说明

currentAgentId

int

True

座席工号，取值范围为0~999999。

operateType

int

False

操作类型，请参考表1。

beginTime

String

True

统计的开始时间，要符合“yyyy-MM-dd HH:mm:ss”格式，零时区时间。

时间区间必须满足15分钟的整数倍，且跨度不能大于24小时。

endTime

String

True

统计的结束时间，要符合“yyyy-MM-dd HH:mm:ss”格式，零时区时间。

时间区间必须满足15分钟的整数倍，且跨度不能大于24小时。

ccId

int

False

呼叫中心编号

  • 集成环境，默认值为系统管理员登录AICC系统后，通过“配置中心 > 系统管理 > CMS系统配置”查看的呼叫中心编号。若该配置为空，取值数据库t_cms_sysparam表中的sys_key="default_cc_id",sys_type="cms_system_config"对应的数据。
  • 独立部署环境，默认值为系统管理员登录AICC系统后，通过“配置中心 > 系统管理 > 参数配置”查看“默认呼叫中心标识”的值。

下面操作对象和操作原因都为“-”，表示对该操作类型不写座席操作详单。

响应消息

表3 消息体参数说明

参数名

数据类型

说明

result

String

查询结果。取值如下：

  • 0：成功
  • 其他：失败

失败的原因说明请参见错误码参考。

说明：

当前字段为兼容8.13及其之前版本接口响应参数使用。

resultCode

string

查询结果。取值如下：

  • "0100000"：成功
  • 其他：失败
  • 失败的原因说明请参见错误码参考。

resultDatas

List

查询成功后，返回结果信息的对象数组。

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

说明：

当前字段为兼容8.13及其之前版本接口响应参数使用。

resultDesc

List

查询成功后，返回结果信息的对象列表。

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

表4 resultDesc/resultDatas对象参数说明

参数名

数据类型

说明

id

string

配置ID

callId

string

呼叫ID

phoneNo

string

座席电话号码或会议id

subCcNo

int

子系统号

currentAgentId

int

业务代表的工号

currentSkillId

int

处理呼叫的技能队列ID

mediaType

int

媒体类型，请参见表1

submediaType

string

子媒体类型，取值范围：

beginTime

string

统计操作开始的时间，零时区

endTime

string

统计操作结束的时间，零时区

vdn

int

处理呼叫的虚拟呼叫中心编号

callType

int

呼叫类型，请参见表1

serviceNo

int

业务类型ID

说明：

当前参数无实际业务含义，请勿使用。

operateType

int

操作类型，请参见表1

operateObject

int

操作对象，请参见表1

operateCause

int

操作原因，请参见表1

agentType

int

座席类型，请参见表1

locationId

int

分布式节点编号

logonSn

string

签入序列号

skillInfoSn

string

座席拥有技能列表的索引

当取值为空时，表示座席不拥有任务技能。例如：座席签入时，此字段则为空。

样例报文

  • 请求头： 
    Content-Type: application/json;charset=UTF-8
Authorization: ******************
  • 请求参数： 
    {
    "ccId": 1,
    "operateType": 2,
    "currentAgentId": 35001,
    "beginTime": "2024-08-02 00:00:00",
    "endTime": "2024-08-02 23:00:00"
}
  • 响应参数： 
    {
    "result": "0",
    "resultCode": "0100000",
    "resultDatas": [
        {
            "callId": "5",
            "operateCause": 0,
            "vdn": 1,
            "agentType": 11,
            "operateType": 2,
            "currentSkillId": 1,
            "mediaType": 10,
            "submediaType": "Email",
            "operateObject": 23,
            "callType": 0,
            "phoneNo": "'05276789'",
            "logonSn": "2024080214194100005209009",
            "skillInfoSn": "2024080214194300005209050",
            "locationId": 1,
            "currentAgentId": 35001,
            "subCcNo": 1,
            "serviceNo": 1,
            "beginTime": "2024-08-02 06:19:44",
            "endTime": "2024-08-02 06:20:08",
            "id": "172257960827964297019273683535"
        }
    ],
    "resultDesc": [
        {
            "callId": "5",
            "operateCause": 0,
            "vdn": 1,
            "agentType": 11,
            "operateType": 2,
            "currentSkillId": 1,
            "mediaType": 10,
            "submediaType": "Email",
            "operateObject": 23,
            "callType": 0,
            "phoneNo": "'05276789'",
            "logonSn": "2024080214194100005209009",
            "skillInfoSn": "2024080214194300005209050",
            "locationId": 1,
            "currentAgentId": 35001,
            "subCcNo": 1,
            "serviceNo": 1,
            "beginTime": "2024-08-02 06:19:44",
            "endTime": "2024-08-02 06:20:08",
            "id": "172257960827964297019273683535"
        }
    ]
}

相关文档