下载座席操作详单索引
场景描述
下载座席操作详单索引压缩包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 |
Content-Type |
String |
True |
无 |
固定填 application/json; charset=UTF-8。 |
2 |
Authorization |
String |
True |
无 |
生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。 |
序号 |
名称 |
是否必选 |
参数类型 |
默认值 |
说明 |
---|---|---|---|---|---|
1 |
version |
True |
String(1-32) |
2.0 |
协议版本。当前固定值为2.0。 |
序号 |
名称 |
是否必选 |
参数类型 |
默认值 |
说明 |
---|---|---|---|---|---|
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为保留字段,默认为空字符串。
序号 |
名称 |
参数类型 |
说明 |
---|---|---|---|
1 |
resultCode |
String |
请求返回的结果码,详见错误码参考。 |
2 |
resultDesc |
String |
请求结果描述。 |
3 |
resultData |
Object |
请求响应数据 |
4 |
response |
Object |
请求结果对象,参数说明详见表5 不推荐使用,为兼容老版本保留字段。 |
序号 |
名称 |
参数类型 |
说明 |
---|---|---|---|
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" } }