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

Modifying a Skill Queue (modifySkill)

Scenario

Modify a skill queue.

Interface Method

POST

URI

https://Domain name/apiaccess/rest/cc-management/v1/skill/modifySkill. For example, the domain name is service.besclouds.com.

Request Description

Table 1 Request header parameters

No.

Parameter

Type

Mandatory

Description

1

X-APP-KEY

String

No

App key, which is the user ID. Contact the operation personnel to obtain the app key.

2

Authorization

String

Yes

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

Table 2 Request body parameters

No.

Parameter

Type

Mandatory

Description

1.1

description

String

No

Skill short name or description. The value can contain a maximum of 50 characters, including Chinese characters, letters, and digits.

1.2

maxWaitTime

Number

No

Maximum queuing duration, in seconds. The maximum value is 60000.

1.3

maxWaitNum

Number

No

Maximum number of users waiting in a queue. The maximum value is 10000.

1.4

maxAgentWrapupTime

Number

No

Duration of the wrap-up state, in seconds. The maximum value is 3600.

1.5

skillParam

Object

No

Skill queue parameter information. When the media type is 53, 2, or 18, only noAgents, busy, and timeOut are available. When the media type is 53, deviceType must be set to 1. When the media type is 5 or 19, the noAgents, busy, timeOut, answerFunction, and waitVoice parameters are mandatory.

1.5.1

noAgents

Object

Yes

No-agents-on-duty configuration.

1.5.1.1

deviceType

String

No

Device type.

3: IVR

1: skill queue

1.5.1.2

transferType

String

Yes

Handling policy.

Release: If the parameter is set to this value, other parameters at the same level are left blank.

Transfer: If the parameter is set to this value, other parameters at the same level are mandatory.

1.5.1.3

value

Number

No

For a skill queue, the value of this parameter is the skill queue ID. For an IVR flow, the value of this parameter is the IVR flow ID.

1.5.2

busy

Object

Yes

Busy queuing or queuing overflow configuration.

1.5.2.1

deviceType

String

No

Device type.

3: IVR

1: skill queue

1.5.2.2

transferType

String

Yes

Handling policy.

Release: If the parameter is set to this value, other parameters at the same level are left blank.

Transfer: If the parameter is set to this value, other parameters at the same level are mandatory.

1.5.2.3

value

Number

No

For a skill queue, the value of this parameter is the skill queue ID. For an IVR flow, the value of this parameter is the IVR flow ID.

1.5.3

answerFunction

String

No

Answer type configuration. The options are 0 (report employee ID) and 2 (report no voice).

1.5.4

timeOut

Object

Yes

Queuing timeout configuration.

1.5.4.1

deviceType

String

No

Device type.

3: IVR

1: skill queue

1.5.4.2

transferType

String

Yes

Handling policy.

Release: If the parameter is set to this value, other parameters at the same level are left blank.

Transfer: If the parameter is set to this value, other parameters at the same level are mandatory.

1.5.4.3

value

Number

No

For a skill queue, the value of this parameter is the skill queue ID. For an IVR flow, the value of this parameter is the IVR flow ID.

1.5.5

waitVoice

Object

No

Queuing configuration.

1.5.5.1

parameterType

String

Yes

Voice: If the parameter is set to this value, other parameters at the same level are left blank.

IVR: If the parameter is set to this value, other parameters at the same level are mandatory.

1.5.5.2

id

String

No

For an IVR flow, the value of this parameter is the IVR flow ID.

1.6

skillId

Integer

Yes

Skill queue ID.

1.7

name

String

No

Skill queue name.

Response Description

  • Response status code: 200
    Table 3 Response body parameters

    No.

    Parameter

    Type

    Mandatory

    Description

    1.1

    returnCode

    String

    No

    Operation result. The options are as follows: 0: success; other values: failure.

    1.2

    description

    String

    No

    Prompt information.

  • Response status code: 401

    Authentication fails.

  • Response status code: 404

    The requested resource does not exist.

  • Response status code: 500

    An exception occurs on the server.

Error Code

None.

Example

Request header:

Content-Type:application/json
X-APP-KEY: XXXXXXXXXXXXXXXXXXXXXXX
Authorization: Bearer XXXXXXXXXXXXXXXXXXXXXXX

Request parameters:

{
    "skillId": 3,
    "description": "2021ok",
    "maxWaitTime": 60
}

Response parameters:

{
    "returnCode": "0",
    "description": "Update Skill successfully"
}