单个修改座席业务账号信息（agentAccount/update）
场景描述
单个修改座席业务账号信息，其中skills参数与技能队列相关，请通过查询技能队列的接口获取技能队列相关信息。
接口方法
POST
接口URI
https://域名/apiaccess/rest/cc-management/v1/agentAccount/update，例如域名是service.besclouds.com
请求说明
序号 |
名称 |
参数类型 |
是否必选 |
说明 |
|---|---|---|---|---|
1 |
x-app-key |
string |
False |
appKey字段，用户标识，请联系运营人员获取appKey |
2 |
Authorization |
string |
True |
鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） |
序号 |
名称 |
参数类型 |
是否必选 |
说明 |
|---|---|---|---|---|
1 |
requestParam |
object |
False |
请求参数对象 |
1.1 |
userAccount |
string |
True |
座席业务账号，用来查询座席，不可修改该信息 |
1.2 |
userName |
string |
False |
座席业务账号用户名，最大长度为20字节，不含"[]=;<>特殊字符。 |
1.3 |
string |
False |
邮箱地址，(符合RFC 2882) localPart最大长度不超过64，domainPart长度不超过255，其中domainPart dot前面部分最长为63位 |
|
1.4 |
phone |
string |
False |
电话号码，选填，长度不超过25位 |
1.5 |
agentType |
integer |
False |
座席类型： 4：音频座席； 11：视频座席 5：多媒体座席； 99：全能座席 |
1.6 |
ccRoleId |
integer |
False |
座席角色id: 2：话务员； 3：质检员； 4：外呼座席 |
1.7 |
skills |
array[object] |
False |
当有该参数时，内部三个参数skillId，agentWeight，skillWeight都需要填写，设置的技能队列类型需要与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 |
oldPassWord |
string |
False |
座席业务账号当前密码，修改座席业务账号密码时需要填写，用于验证；当前密码如果验证出错3次，会锁住账号30分钟，需要使用租户管理员登入系统解锁。24小时内仅能修改一次密码 |
1.9 |
newPassWord |
string |
False |
座席业务账号新密码，长度8位（默认密码规则组），默认需要提供四种：大写字母、小写字母、数字和特殊字符。 特殊字符是指~`!@#$%^*()-+_=\¦，./<>?;':"[]{}\&，密码有效时长90天，请在90天内更新密码。 |
响应说明
错误码
无。
报文样例
请求头:
x-app-key: XXXXXXXXXXXXXXXXXXXXXXX Content-Type: application/json Authorization: Bearer XXXXXXXXXXXXXXXXXXXXXXX
请求参数:
{
"userAccount":"test123456",
"userName":"test123",
"email":"Test@****.com",
"phone":"184****5555",
"agentType":5,
"ccRoleId":2,
"skills":[{
"skillId":1,
"agentWeight":1,
"skillWeight":1
}],
"oldPassWord":"xxxxx",
"newPassWord":"xxxxxxx"
}
响应参数:
{
"resultCode": "0",
"resultMessage": "edit success"
}
