生成座席操作详单索引

场景描述

调用该API，则会根据条件生成座席操作详单的索引文件。文件生成后，文件名称（agentOprInfoFileName）会通过回调的方式发送到callBackURL携带的回调地址上。

回调callBackURL需要鉴权，详见C2 监控/系统外呼/话单/知识库类接口鉴权方式。

使用说明

• 前提条件
  • 开发者环境已经构建，座席正常签入并进行相关操作，开发者有独立服务器并且已经绑定回调地址（callBackURL）。
  • 企业帐号（accountId：租间ID）、座席ID（agentId），可自由组合生成座席操作详单索引文件。如果均没有传入，则生成指定时间段内该appId下相应的数据记录。
  • 已通过鉴权（Authorization）、获取接入地址。
  • 请检查CC-FS配置文件“/home/ccfsapp/webapps/ccfsapp/WEB-INF/classes/config/servicecloud.base.properties”的“aicc.ssl.trustAll”是否配置为false，请配置为false，然后参考下面步骤放置证书。
    1. 以运维用户登录CC-FS的服务器，切换到root用户下。

       su - root

    2. 将CC-FS生成索引文件通知回调地址加载的第三方证书上传至AICC的truststore.jks证书的同一目录中，目录为：“$HOME/conf”，具体目录请以实际环境为准。
    3. 修改上传的第三放证书的属组。

       chown ccfsapp:ccfsapp XXX.jks

    4. 执行下面的命令将第三方证书导入到truststore.jks中。

       keytool -import -alias xxx -file XXX.jks -keystore truststore.jks

       请依据界面提示输入truststore.jks证书密码。

    5. 在环境上删除XXX.jks证书。
    6. 重启CC-FS。

       进入“/home/ccfsapp/bin”目录，执行如下命令。

       ./shutdown.sh;./startup.sh

• 使用限制

  开发者只能访问该帐号下的数据信息，开发者帐号（appId）和企业帐号（accountId）必须对应。

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

接口方法

POST

接口URI

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

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

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

请求说明

响应说明

调用本接口获得响应分为两部分：

（1）调用本接口立即得到响应

该响应消息参数说明详见表4。

（2）平台生成数据记录文件后回调第三方的响应。

该响应由request，msgBody两部分组成。msgBody参数说明详见表7-回调返回消息请求Body中msgBody参数说明。

request包含响应版本号version（默认2.0）。

msgBody由responseId（座席操作详单文件名组成部分），fileName（待下载座席操作详单zip名称），accountId（租间ID）组成。

若回调没有成功（ccfs没有收到回调地址的成功响应，或没有响应体），ccfs会重试，间隔10分钟重试一次，直到成功或者超过重试次数。

报文样例

• 请求头

  POST /CCFS/resource/ccfs/queryAgentOprInfoData HTTP/1.1
  Authorization: auth-v2/ak/2018-07-02T02:42:49Z/content-length;content-type;host
  /7a8fb9d620e******************5c5df0cce3c6a253
  Accept: */*
  Host: 10.154.198.164
  Content-Type: application/json;charset=UTF-8
  Content-Length: 297

• 请求参数

  {
      "request": {
          "version": "2.0"
      },
      "msgBody": {
          "beginTime": "2018-06-29 10:42:49",
          "endTime": "2018-07-02 10:42:49",
          "accountId": "",
          "agentId": "",
          "callBackURL": "https://10.57.118.171:8000"
      }
  }

• 响应头

  HTTP/1.1 200 OK
  Content-Type: application/json;charset=UTF-8
  Date: Mon, 02 Jul 2018 02:43:03 GMT

• 响应参数

  {
      "response": {
          "version": "2.0",
          "resultCode": "0",
          "resultMsg": "success"
      },
      "resultData": {
          "responseId": "9239cb50a8384bb0ab503441bf089446"
      },
      "resultCode": "0",
      "resultDesc": "success"
  }

• 呼叫中心向回调地址返回的消息示例

  消息头

  POST / HTTP/1.1
  Accept: */*
  Content-Type: application/json;charset=UTF-8
  Authorization: auth-v2/ak/2018-07-02T02:43:03Z/content-length;content-type;host
  /c5bd683******************ef5747bd572c28
  Host: 10.57.118.171
  Content-Length: 208

  消息参数

  {
      "request": {
          "version": "2.0"
      },
      "msgBody": {
          "responseId": "9239cb50a8384bb0ab503441bf089446",
          "agentOprInfoFileName": "20180702_9239cb50a8384bb0ab503441bf089446.zip"
      }
  }