单个创建技能队列(createSkill)
场景描述
单个创建技能队列
接口方法
POST
接口URI
https://域名/apiaccess/rest/cc-management/v1/skill/createSkill,例如域名是service.besclouds.com
请求说明
序号 |
名称 |
参数类型 |
是否必选 |
说明 |
---|---|---|---|---|
1 |
X-APP-KEY |
string |
False |
appKey字段,用户标识,请联系运营人员获取appKey |
2 |
Authorization |
string |
True |
鉴权信息,值为Bearer + tokenByAKSK接口的返回值中的AccessToken(Bearer后有空格) |
序号 |
名称 |
参数类型 |
是否必选 |
说明 |
---|---|---|---|---|
1.1 |
mediaTypeId |
number |
True |
媒体类型。5:音视频;53:多媒体;2:语音点击通话;18:视频点击通话 |
1.2 |
description |
string |
True |
技能简称或描述,不超过50个字符(允许的字符包括中文、字母、数字) |
1.3 |
name |
string |
True |
技能队列的名称,不超过100个字节。 不允许的特殊字符: [ `~!#$%^&*()+=|{}':;',<>/?~!#¥%……&*()+|{}【】‘;:”“’。,、?]|\n|\r|\t |
1.4 |
maxWaitTime |
number |
True |
最大排队等待时间,单位秒,最大值60000 |
1.5 |
maxWaitNum |
number |
True |
最大排队等待人数,最大值10000 |
1.6 |
maxAgentWrapupTime |
number |
True |
整理态时长,单位秒,最大值3600 |
1.7 |
skillParam |
object |
True |
技能队列参数信息,媒体类型为53或2或18时,只有noAgents、busy和timeOut三项配置,媒体类型为53时deviceType的值只能为1;媒体类型为5或19时noAgents、busy、timeOut、answerFunction和waitVoice配置必填 |
1.7.1 |
noAgents |
object |
True |
无人上班配置 |
1.7.1.1 |
deviceType |
string |
False |
设备类型。 3:IVR 1:技能队列 |
1.7.1.2 |
transferType |
string |
True |
处理策略。 Release:释放,此时同级其他参数不填 Transfer:转接,此时同级其他参数必填 |
1.7.1.3 |
value |
number |
False |
技能队列时取skillId,IVR时取IVR流程编号id |
1.7.2 |
busy |
object |
True |
排队遇忙、溢出配置 |
1.7.2.1 |
deviceType |
string |
False |
设备类型。 3:IVR 1:技能队列 |
1.7.2.2 |
transferType |
string |
True |
处理策略。 Release:释放,此时同级其他参数不填 Transfer:转接,此时同级其他参数必填 |
1.7.2.3 |
value |
number |
False |
技能队列时取skillId,IVR时取IVR流程编号id |
1.7.3 |
answerFunction |
string |
False |
业务代表应答方式配置,0报工号2不报语音 |
1.7.4 |
timeOut |
object |
True |
排队超时配置 |
1.7.4.1 |
deviceType |
string |
False |
设备类型。 3:IVR 1:技能队列 |
1.7.4.2 |
transferType |
string |
True |
处理策略。 Release:释放,此时同级其他参数不填 Transfer:转接,此时同级其他参数必填 |
1.7.4.3 |
value |
number |
False |
技能队列时取skillId,IVR时取IVR流程编号id |
1.7.5 |
waitVoice |
object |
False |
排队等待配置 |
1.7.5.1 |
parameterType |
string |
True |
参数类型。 取值范围:
|
1.7.5.2 |
id |
string |
False |
IVR时取IVR流程编号id |
响应说明
- 响应状态码: 200
表3 响应体参数 序号
名称
参数类型
是否必选
说明
1.1
returnCode
string
True
操作结果。0:成功,非0为失败
1.2
description
string
False
提示信息
1.3
skillId
string
False
技能ID
- 响应状态码: 401
鉴权失败
- 响应状态码: 404
请求资源不存在
- 响应状态码: 500
服务器内部异常
错误码
无。
报文样例
请求头:
Content-Type:application/json X-APP-KEY:XXXXXXXXXXXXXXXXXXXXXXX Authorization:Bearer XXXXXXXXXXXXXXXXXXXXXXX
{ "mediaTypeId": 5, "description": "ccfdc", "name": "dddpodfst", "maxWaitTime": 30, "maxWaitNum": 100, "maxAgentWrapupTime": 5, "skillParam": { "noAgents": { "deviceType": "1", "transferType": "Transfer", "value": 2 }, "busy": { "deviceType": "1", "transferType": "Transfer", "value": 1 }, "answerFunction": "0", "timeOut": { "deviceType": "1", "transferType": "Transfer", "value": 1 }, "waitVoice": { "parameterType": "Voice" } } }
响应参数:
{ "returnCode": "0", "skillId": "5", "description": "Create Skill successfully" }