Updated on 2023-09-27 GMT+08:00

POST /CCSQM/rest/ccisqm/v1/qualitytask/createQualityTask

Scenario

This interface is invoked to create a manual review task.

Method

POST

URI

https://Domain name/apiaccess/CCSQM/rest/ccisqm/v1/qualitytask/createQualityTask (For example, the domain name is service.besclouds.com.)

Request Description

Table 1 Request header parameters

No.

Parameter

Type

Mandatory or Not

Description

1

Content-Type

String

No

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

2

x-app-key

String

No

App key

3

Authorization

String

Yes

Authentication field. The format is Bearer {Value of AccessToken returned by the tokenByAkSk interface}. (A space is required after Bearer.)

4

x-UserId

String

Yes

Operator ID

You can sign in to the system and go to the employee management page to view the value of userId returned by an interface.

Table 2 Request body parameters

No.

Parameter

Type

Mandatory or Not

Description

1.1

currentRole

String

Yes

User ID

1.2

startTimeMillis

Number

No

Call start time

1.3

endTimeMillis

Number

No

Call end time

1.4

fixedColumns

Object

Yes

Sample inspection details

1.4.1

maxNum

Number

No

Maximum sample inspection quantity. The value ranges from 0 to 10000.

1.4.2

qualityCondition

Integer

No

Sample inspection status. The options are 0, 1, and 2.

1.4.3

qualityNum

Number

Yes

Sample inspection quantity. The value is greater than 1.

1.4.4

qualityType

Number

Yes

Sample inspection quantity type. The options are 1, 2, and 3.

1.4.5

scoreStart

Integer

No

Minimum machine score. The value ranges from 0 to 10000.

1.4.6

scoreEnd

Integer

No

Maximum machine score. The value ranges from 0 to 10000.

1.4.7

durationStart

Integer

No

Minimum call duration. The value ranges from 0 to 100000000.

1.4.8

durationEnd

Integer

No

Maximum call duration. The value ranges from 0 to 100000000.

1.4.9

staffIds

Array [String]

No

Agent list

1.4.10

interactionType

Integer

Yes

Inspection type

  • 0: voice
  • 2: text

1.5

qualityTask

Object

Yes

Sample inspection tasks

1.5.1

planName

String

Yes

Sample inspection task name. The value can contain a maximum of 32 characters.

Response Description

  • Status code: 200
Table 3 Response body parameters

No.

Parameter

Type

Mandatory or Not

Description

1.1

resultCode

String

No

Return code

  • 0409000: success
  • Others: failure

1.2

resultDesc

String

No

Return description

  • Status code: 400

    Incorrect request. Check the request path and parameters.

  • Status code: 401

    Unauthorized operation. 1. Check whether you have purchased related services. 2. Contact customer service to check the status of your account.

  • Status code: 404

    The requested content is not found. Check the request path.

  • Status code: 500

    Business failure. Check the values of parameters in the request.

Error Codes

None

Example

  • Scenario: Create a manual review task.

    Request header:

    x-app-key:************************************  
    X-UserID:1611917095665261978  
    Authorization:Bearer ********************************

    Request parameters:

    {
    	"customColumns": null,
    	"currentRole": "qualityDirector",
    	"startTimeMillis": "",
    	"endTimeMillis": "",
    	"fixedColumns": {
    		"maxNum": 10,
    		"qualityCondition": 0,
    		"qualityNum": 100,
    		"qualityType": 1,
    		"scoreStart": 10,
    		"scoreEnd": 120,
    		"staffIds": []
    	},
    	"qualityTask": {
    		"planName": "234"
    	}
    }

    Response parameters:

    {
    	"qualityTaskId": "16239245027406915901",
    	"resultCode": "0409000",
    	"resultDesc": "Operation successful."
    }