文档首页/ 云客服/ API参考/ 呼叫中心配置类/ 座席管理/ 单个修改座席业务账号信息（agentAccount/update）
更新时间：2023-09-27 GMT+08:00
查看PDF
分享

单个修改座席业务账号信息（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"
}
父主题： 座席管理