文档首页/云客服/API参考/话单类接口参考/接口说明/数据访问接口/下载座席操作详单索引
更新时间：2025-11-13 GMT+08:00
查看PDF
分享

下载座席操作详单索引

场景描述

下载座席操作详单索引压缩包zip文件（yyyymmdd_ responseId），可查看每个zip包对应的座席操作详情描述记录（yyyymmddhhmmssSSS+3位随机数_agentOprInfo.csv）。

使用说明

  • 前提条件
    • 已调用“生成座席操作详单索引”在后台生成文件。
    • 已通过鉴权（Authorization）、获得接入地址。
  • 使用限制

    开发者只能下载自己帐号下的文件，开发者帐号（appId）和数据记录文件名称（agentOprInfoFileName）必须对应。

    开发者账号（appId）包含在鉴权认证字符串中，详见C2 监控/系统外呼/话单/知识库类接口鉴权方式。

接口方法

POST

接口URI

https://ip:port/CCFS/resource/ccfs/downloadAgentOprInfoFile

其中，ip为CC-FS安装的服务器IP地址，port为CC-FS的HTTPS端口号。

如果经过NSLB路由，ip为NSLB的服务器IP地址，port为CC-FS服务在NSLB映射的HTTPS端口号。

请求说明

表1 请求Headers参数说明

序号

名称

参数类型

是否必选

默认值

说明

1

Content-Type

String

True

无

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

2

Authorization

String

True

无

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

表2 请求Body中request参数说明

序号

名称

是否必选

参数类型

默认值

说明

1

version

True

String（1-32）

2.0

协议版本。当前固定值为2.0。

表3 请求Body中msgBody参数说明

序号

名称

是否必选

参数类型

默认值

说明

1

agentOprInfoFileName

True

String（1-49）

无

座席操作详单索引文件名称，已调用“生成座席操作详单索引”获取。

格式：yyyyMMdd_{responseId}.zip。

例如：已调用“生成座席操作详单索引”接口，调用“生成座席操作详单索引”接口的日期为2018-07-02，获取到的录音索引responseId为9239cb50a8384bb0ab503441bf08944，则该参数值为20180702_9239cb50a8384bb0ab503441bf089446.zip。

响应说明

当调用本接口响应成功，则从httpresponse消息中获取文件的二进制数据生成话单文件，文件后缀名为.zip，文件中各参数定义参考话单录音索引文件定义，响应中content-type字段为Application/Octet-stream;charset=UTF-8。

当调用本接口响应失败，则返回相应的错误码信息，错误码响应数据结构请查看表4，resultData为保留字段，默认为空字符串。

表4 响应消息参数说明

序号

名称

参数类型

说明

1

resultCode

String

请求返回的结果码，详见错误码参考。

2

resultDesc

String

请求结果描述。

3

resultData

Object

请求响应数据

4

response

Object

请求结果对象，参数说明详见表5

不推荐使用，为兼容老版本保留字段。

表5 响应消息response参数说明

序号

名称

参数类型

说明

4.1

version

String（1-32）

协议版本，如2.0。

4.2

resultCode

String(1-32)

请求返回的结果码，详见错误码参考。

4.3

resultMsg

String

请求结果描述。

报文样例

  • 请求头 
    POST /CCFS/resource/ccfs/downloadAgentOprInfoFile HTTP/1.1
Authorization: auth-v2/ak/2018-07-02T02:43:08Z/content-length;content-type;host
/ae066c2f5de******************afc161cb7e66f5d
Accept: */*
Host: 10.154.198.164
Content-Type: application/json;charset=UTF-8
Content-Length: 193
  • 请求参数 
    {
    "request": {
        "version": "2.0"
    },
    "msgBody": {
        "agentOprInfoFileName": "20180702_9239cb50a8384bb0ab503441bf089446.zip"
    }
}
父主题：数据访问接口