单个创建座席业务账号(agentAccount/create)
场景描述
单个创建座席业务账号,其中skills参数与技能队列相关,请通过查询技能队列的接口获取技能队列相关信息。
接口方法
POST
接口URI
https://域名/apiaccess/rest/cc-management/v1/agentAccount/create,例如域名是service.besclouds.com
请求说明
序号 |
名称 |
参数类型 |
是否必选 |
说明 |
---|---|---|---|---|
1 |
x-app-key |
string |
False |
appKey字段,用户标识,请联系运营人员获取appKey |
2 |
Authorization |
string |
True |
鉴权字段,内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken(Bearer后有空格) |
序号 |
名称 |
参数类型 |
是否必选 |
说明 |
---|---|---|---|---|
1 |
requestParam |
object |
True |
请求参数对象 |
1.1 |
userAccount |
string |
True |
座席业务账号,长度6-50位,支持四种:大写字母、小写字母、数字和特殊字符。 特殊字符是指@.-_ |
1.2 |
userName |
string |
True |
座席业务账号用户名,最大长度为20字符,不含"[]'&()=;<>,特殊字符。 |
1.3 |
password |
string |
True |
座席业务账号密码,长度8位(默认密码规则组),默认需要提供四种:大写字母、小写字母、数字和特殊字符。 特殊字符是指~`!@#$%^*()-+_=\¦,./<>?;':"[]{}\&,密码有效时长90天,请在90天内更新密码。 |
1.4 |
|
string |
True |
邮箱地址,(符合RFC 2882) localPart最大长度不超过64,domainPart长度不超过255,其中domainPart dot前面部分最长为63位 |
1.5 |
agentType |
integer |
True |
座席类型: 4:音频座席; 11:视频座席 5:多媒体座席; 99:全能座席 |
1.6 |
ccRoleId |
integer |
True |
座席角色id: 2:话务员; 3:质检员; 4:外呼座席 |
1.7 |
skills |
array[object] |
False |
技能参数组,设置的技能队列类型需要与agenttype保持一致 |
1.7.1 |
skillId |
integer |
False |
技能队列Id,通过查询技能队列接口 querySkills获取 |
1.7.2 |
agentWeight |
integer |
False |
座席权重,权重越高,越优先分配该座席,最低1 |
1.7.3 |
skillWeight |
integer |
False |
技能队列权重,最低1 |
1.8 |
phone |
string |
False |
电话号码,选填,长度不超过25位 |
响应说明
- 响应状态码: 200
表3 响应体参数 序号
名称
参数类型
是否必选
说明
1
schema
object
True
请求成功
1.1
resultCode
string
True
字符串,0成功,1失败
1.2
resultMessage
string
True
相关消息
1.3
workNo
integer
False
座席工号。
- 响应状态码: 400
错误的请求:请检查请求路径及参数。
- 响应状态码: 401
未授权:1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。
- 响应状态码: 404
请求的内容未找到:请检查请求的路径。
- 响应状态码: 500
业务失败:请依次确认您请求中各参数的取值。
错误码
无。
报文样例
- 场景描述:创建座席业务账号
URL:见文档
x-app-key: XXXXXXXXXXXXXXXXXXXXXXX Content-Type: application/json Authorization: Bearer XXXXXXXXXXXXXXXXXXXXXXX
请求参数:
{ "userAccount":"test123456", "userName":"test111", "password":"Te****34", "email":"t**@****.com", "agentType":11, "ccRoleId":2, "skills":[{ "skillId":3, "agentWeight":1, "skillWeight":1 }, { "skillId":2, "agentWeight":1, "skillWeight":2 }] }
响应参数:
{ "resultCode": "0", "resultMessage": "create agent account success", "workNo": 108 }