接口调用说明
业务可以通过该接口修改角色名称，角色包含的客服成员，角色的权限和可见的客服分组。
请求 URL 示例
https://console.tim.qq.com/v4/desk_http_svc/modify_role?sdkappid=88888888&identifier=admin&usersig=xxx&random=99999999&contenttype=json
请求参数说明
参数 | 说明 |
v4/desk_http_svc/modify_role | 请求接口。 |
sdkappid | 创建应用时即时通信 IM 控制台分配的 SDKAppID。 |
identifier | |
usersig | |
random | 请输入随机的32位无符号整数，取值范围0 - 4294967295。 |
contenttype | 请求格式固定值为 json。 |
请求包示例
修改角色名称、关联的权限、包含的客服成员以及角色拥有的客服分组权限范围。
{"RoleID": 626, // 角色ID"RoleName": "售后", // 角色名称"MemberList": [ // 角色对应的客服成员列表"767480289@qq.com","87673211@qq.com"],"PermissionList": [ // 角色的权限"CHAT_WORKBENCH"],"MemberGroupIDList": [ // 角色可见的分组范围4153,4240]}
仅修改客服成员和可见的客服分组。
{"RoleID": 626,"RoleName": "售后", // 角色名称"MemberList": [ // 角色对应的客服成员列表"767480289@qq.com""87673211@qq.com"],"MemberGroupIDList": [ // 角色可见的分组范围4153,4240]}
请求包字段说明
字段 | 类型 | 属性 | 说明 |
RoleID | Integer | 必填 | 需要修改的角色 ID。 |
RoleName | String | 选填 | 角色名称。 |
MemberList | Array | 选填 | 角色中包含的客服成员。 |
PermissionList | Array | 选填 | 角色对应的权限，目前只支持 CHAT_WORKBENCH 工作台权限。 |
MemberGroupIDList | Array | 选填 | 角色对应的客服分组权限范围。表示该角色在工作台模块内可见的客服分组，例如客服转接的时候可见的客服分组。 |
应答包体示例
{"ActionStatus": "OK","ErrorCode": 0,"ErrorInfo": ""}
应答包字段说明
字段 | 类型 | 说明 |
ErrorCode | Integer | 错误码： 0表示成功。 非0表示失败。 |
ErrorInfo | String | 错误信息。 |
ActionStatus | String | 请求处理的结果。 |
错误码说明
除非发生网络错误（例如502错误），否则该接口的 HTTP 返回码均为200。真正的错误码，错误信息是通过应答包体中的 ErrorCode、ErrorInfo 来表示的。
本 API 私有错误码如下：
错误码 | 描述 |
141002 | 内部错误，请重试。 |
141004 | 参数非法。 |
