座席加入用户组
场景描述
用于将座席加入CMS上的用户组。
接口方法
设置成“POST”。该接口仅支持POST方法，不支持PUT、GET和DELTE等方法。
请求URL
https://ip:port/rest/cmsapp/v1/openapi/qcrelationconf/joinusergroup
其中，公有云环境请联系管理员获取，ip为CC-CMS服务器地址，port为CC-CMS服务器的HTTPS端口号。
非公有云环境如果配置了NSLB服务，ip请填写NSLB的服务器地址，port为CC-CMS服务在NSLB映射的HTTPS端口号。
请求说明
序号 |
名称 |
参数类型 |
是否必选 |
说明 |
|---|---|---|---|---|
1 |
Content-Type |
String |
True |
固定填 application/json; charset=UTF-8。 |
2 |
Authorization |
String |
True |
生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。 |
参数名 |
数据类型 |
选取原则 |
说明 |
|---|---|---|---|
ccId |
int |
False |
呼叫中心编号，取值范围为1~65535
|
vdnId |
int |
True |
虚拟呼叫中心编号，取值范围为1~5000。 |
agentId |
int |
True |
加入用户组的座席工号，取值范围为0~99999。 |
groupId |
String |
False |
加入的用户组编号 不携带：先根据groupName参数指定的名称创建用户组，然后把座席加入新创建的组（如果座席此前已经在其它用户组，则会自动从其它组中移除） 携带：忽略groupName参数，将座席加入groupId对应的用户组（如果座席此前已经在其它用户组，则会自动从其它组中移除） |
groupName |
string |
False |
加入的用户组名称（不允许非法字符，长度不超过100） |
groupType |
int |
False |
用户组类型，默认为2，可选值为2和3，其中2代表话务组，3代表质检组，其他为非法入参 |
响应消息
样例报文
- 请求头：
Content-Type: application/json;charset=UTF-8 Authorization: ******************
- 请求参数：
{ "ccId":1, "vdnId":4, "agentId":667, "groupId":"159282396714302232563636876268", "groupName":"话务组", "groupType":"" }
- 响应参数：
{ "result": { "groupName": "话务组A", "groupId": "161960203515344228641565404173" }, "message": "success", "retcode": "0" }
