
# 单个修改座席业务账号信息（agentAccount/update）
#### 场景描述
单个修改座席业务账号信息，其中skills参数与技能队列相关，请通过查询技能队列的接口获取技能队列相关信息。
#### 接口方法
POST
#### 接口URI
https://域名/apiaccess/rest/cc-management/v1/agentAccount/update，例如域名是service.besclouds.com
#### 请求说明
表1请求头参数 
| 序号 | 名称            | 参数类型   | 是否必选  | 说明                                                            |
|:---|:---|:---|:---|:---|
| 1  | x-app-key     | string | False | appKey字段，用户标识，请联系运营人员获取appKey                                 |
| 2  | Authorization | string | True  | 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） |
   
表2请求体参数 
| 序号    | 名称           | 参数类型            | 是否必选  | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
|:---|:---|:---|:---|:---|
| 1     | requestParam | object          | False | 请求参数对象                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| 1.1   | userAccount  | string          | True  | 座席业务账号，用来查询座席，不可修改该信息                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| 1.2   | userName     | string          | False | 座席业务账号用户名，最大长度为20字节，不含"\[\]=;\<\>特殊字符。                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| 1.3   | email        | 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天内更新密码。                                                                                                                                                                                                                             |
   
#### 响应说明
- 响应状态码: 200
  表3响应体参数 
  | 序号  | 名称            | 参数类型   | 是否必选 | 说明      |
  |:---|:---|:---|:---|:---|
  | 1   | schema        | object | True | 请求成功    |
  | 1.1 | resultCode    | string | True | 0成功，1失败 |
  | 1.2 | resultMessage | string | True | 返回消息    |
     
  
- 响应状态码: 400 错误的请求：请检查请求路径及参数。
  
- 响应状态码: 401 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。
  
- 响应状态码: 404 请求的内容未找到：请检查请求的路径。
  
- 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。
  
 
#### 错误码
无。
#### 报文样例
请求头:
```
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"
}
```
