Updated on 2025-11-13 GMT+08:00

Downloading Index Files of Agent Skill Change Details

Description

Download the ZIP packages (yyyymmdd_responseId) of index files of agent skill change details to view the file (yyyymmddhhmmssSSS + three-digit random number_agentSkillInfo.csv) of agent skill change details in each ZIP package.

Usage Description

  • Prerequisites
    • Files have been generated at the backend by invoking the interface for generating indexes of agent skill change details.
    • You have passed the authorization and obtained the access URL.
  • Usage restrictions

    Developers can only download files under their own accounts. The developer account (appId) must correspond to the data record file name (agentOprInfoFileName).

    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/downloadAgentSkillInfoFile

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 address to the IP address of the NSLB server and Port number to the HTTPS port number of the CC-FS service mapped on the NSLB.

Request Description

Table 1 Parameters in the request header

No.

Parameter

Value Type

Mandatory (Yes/No)

Default Value

Description

1

Content-Type

String

True

None

The value is fixed at application/json; charset=UTF-8.

2

Authorization

String

True

None

For details about the generation mode, see C2 Monitoring, System Outbound Call, CDR, and Knowledge Base Interface Authentication.

Table 2 Request parameter description

No.

Parameter

Value Type

Mandatory (Yes/No)

Default Value

Description

1

agentSkillInfoFileName

String

True

None

Name of an index file of agent skill change details

It is obtained by invoking the Agent Skill Details Index Files API.

The value is in yyyyMMdd_{responseId}.zip format.

Example:

The date when this interface is invoked is 2023-04-06.

The obtained value of responseId is 9239cb50a8384bb0ab503441bf089446.

The value of this parameter is 20230406_9239cb50a8384bb0ab503441bf089446.zip.

Response Description

If the interface is successfully invoked, the system obtains the binary data of the file from the HTTP response message to generate a CDR file whose file name extension is .zip. For details about the parameters in the CDR file, see the definitions in the index file of agent skill change. In the response, the content-type field is Application/Octet-stream;charset=UTF-8.

If the interface fails to be invoked, an error code is returned.

Table 3 Parameters in the response message

No.

Parameter

Value Type

Description

1

resultCode

String

Result code returned.

0: success

Others: See Error Code Reference.

2

resultDesc

String

Request result description.

3

resultData

Object

Response data.

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": {
            "agentSkillInfoFileName": "20180702_9239cb50a8384bb0ab503441bf089446.zip"
        }
    }
  • Response parameters
    {
        "resultData": null,
        "resultCode": "0",
        "resultDesc": "success"
    }