Generating Index Files of Agent Skill Change Details

Description

This interface is invoked to generate an index file of agent skill change details based on conditions. After a file is generated, the file name (agentOprSkillFileName) is sent to the callback URL carried by callBackURL in callback mode.

The callback of the URL specified by callBackURL requires authentication. For details, see C2 Monitoring, System Outbound Call, CDR, and Knowledge Base Interface Authentication.

Usage Description

• Prerequisites
  • The developer environment has been established and calls can be made properly. The developer has an independent server and the server has been bound to the callback URL (callBackURL).
  • accountId, agentId, and callId are optional parameters, which can be flexibly combined to generate CDRs and recording index files. If none of the three parameters is specified, the corresponding data records of the developer in the specified period are generated.
  • You have passed the authorization and obtained the access URL.
  • You have set aicc.ssl.trustAll in the CC-FS configuration file /home/ccfsapp/webapps/ccfsapp/WEB-INF/classes/config/servicecloud.base.properties to false and performed the following steps to place the certificate:
    1. Log in to the CC-FS server as an O&M user and switch to the root user.

       su - root

    2. Upload the third-party certificate that needs to be loaded by the callback URL for notifying the index file generated by the CC-FS to the same directory ($HOME/conf) as the truststore.jks certificate file of the AICC. The directory varies according to the actual environment.
    3. Change the owner group of the uploaded third-party certificate.

       chown ccfsapp:ccfsapp XXX.jks

    4. Import the third-party certificate to truststore.jks.

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

       Enter the password of the truststore.jks certificate file as prompted.

    5. Delete the XXX.jks certificate from the environment.
    6. Restart the CC-FS.

       Go to the /home/ccfsapp/bin directory and run the following command:

       ./shutdown.sh;./startup.sh

• Usage restrictions

  A developer can access only the data of the account. The developer account (appId) must correspond to the enterprise account (tenant space ID: accountId).

  The developer account (appId) is contained in the authentication string. For details, see C2 Monitoring, System Outbound Call, CDR, and Knowledge Base Interface Authentication.

Interface Method

POST

URI

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

Set IP address to the IP address of the server where the CC-FS is installed and Port number to the HTTPS port number of the CC-FS.

If the request is routed through the NSLB, set ip to the IP address of the NSLB server and port to the HTTPS port number of the CC-FS service mapped on the NSLB.

Request Description

Example

• Request header

  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 parameters

  {
      "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"
      }
  }

• Response parameters

  {
      "resultData": null,
      "resultCode": "0",
      "resultDesc": "success"
  }