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
|
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.) |
|
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"
}
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot