更新时间:2025-11-13 GMT+08:00
分享

下载座席技能变更详单索引

场景描述

下载座座席技能变更详单索引压缩包zip文件(yyyymmdd_ responseId),可查看每个zip包对应的座席技能变更详单(yyyymmddhhmmssSSS+3位随机数_agentSkillInfo.csv)。

使用说明

  • 前提条件
    • 已调用“生成座席技能变更详单索引”在后台生成文件。
    • 已通过鉴权(Authorization)、获得接入地址。
  • 使用限制

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

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

接口方法

POST

接口URI

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

其中,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 请求参数说明

序号

名称

参数类型

是否必选

默认值

说明

1

agentSkillInfoFileName

String

True

座席技能变更详单索引文件名称。

调用“座席技能详单索引”接口获取。

格式:yyyyMMdd_{responseId}.zip。

例如:

调用生成座席技能变更详单索引接口的日期为2023-04-06

获取到的responseId为9239cb50a8384bb0ab503441bf089446

则该参数值为20230406_9239cb50a8384bb0ab503441bf089446.zip

响应说明

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

当调用本接口响应失败,则返回相应的错误码信息。

表3 响应消息参数说明

序号

名称

参数类型

说明

1

resultCode

String

请求返回的结果码

0:成功

非0:错误码参考

2

resultDesc

String

请求结果描述。

3

resultData

Object

请求响应数据。

报文样例

  • 请求头
    POST /CCFS/resource/ccfs/ivr/deleteFile  HTTP/1.1
    Authorization: auth-v2/ak/2021-08-31T09:38:50.872Z/content-length;content-type;host/c12f0ed0******************941bdd106
    Accept: */*
    Content-Type: application/json;charset=UTF-8
    Content-Length: 193
  • 请求参数
    {
        "request": {
            "version": "2.0"
        },
        "msgBody": {
            "agentSkillInfoFileName": "20180702_9239cb50a8384bb0ab503441bf089446.zip"
        }
    }
  • 响应参数
    {
        "resultData": null,
        "resultCode": "0",
        "resultDesc": "success"
    }

相关文档