生成话单和录音索引

场景描述

调用该API，则会根据条件生成话单文件和录音索引文件。文件生成后，文件名称（billFileName）会通过回调的方式发送到callBackURL携带的回调地址上。

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

使用说明

• 前提条件
  • 开发者环境已经构建，能够正常进行呼叫，开发者有独立服务器并且已经绑定回调地址（callBackURL）。
  • 企业帐号（租间ID：accountId）、座席ID（agentId）以及话单ID（callId）为可选组合参数，可自由组合生成话单和录音索引文件。如果三者均没有传入，则生成指定时间段内该开发者下相应的数据记录。
  • 已通过鉴权（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）和企业帐号（租间ID：accountId）必须对应。

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

接口方法

POST

接口URI

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

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

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

请求说明

响应说明

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

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

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

该响应由request，msgBody两部分组成。

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

msgBody由responseId（话单文件名组成部分），billName（待下载话单zip名称），accountId（租间ID）组成。

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

报文样例

• 请求头

  POST /CCFS/resource/ccfs/queryBillData HTTP/1.1
  Authorization: auth-v2/ak/2018-07-02T02:42:49Z/content-length;content-type;host
  /7a8fb9d620ee488******************85c5df0cce3c6a253
  Accept: */*
  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": "",
          "callId": "",
          "dataType": "call_record",
          "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******************9def5747bd572c28
  Host: 10.57.118.171
  Content-Length: 208

  消息参数：

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