文档首页/ 云客服/ API参考/ 质检/监控/统计类/ 监控/统计/ 质检关系维护接口/ 新增用户组
更新时间：2025-03-07 GMT+08:00
查看PDF
分享

新增用户组

场景描述

新增用户组

接口方法

设置成“POST”。该接口仅支持POST方法，不支持PUT、GET和DELTE等方法。

请求URL

https://ip:port/rest/cmsapp/v1/openapi/qcrelationconf/createusergroup

其中，公有云环境请联系管理员获取，ip为CC-CMS服务器地址，port为CC-CMS服务器的HTTPS端口号。

非公有云环境如果配置了NSLB服务，ip请填写NSLB的服务器地址，port为CC-CMS服务在NSLB映射的HTTPS端口号。

请求说明

表1 请求头参数

序号

名称

参数类型

是否必选

说明

1

Content-Type

String

True

固定填 application/json; charset=UTF-8。

2

Authorization

String

True

生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。
表2 消息体参数说明

参数名

数据类型

是否必选

说明

ccId

int

False

呼叫中心编号，取值范围为1~65535

  • 独立部署环境，默认值为系统管理员登录AICC系统后，通过“配置中心 > 系统管理 > 参数配置”查看“默认呼叫中心标识”的值。

vdn

int

True

虚拟呼叫中心id

groupName

String

True

用户组名称

groupType

int

True

用户组类型，可选值为2和3，其中2代表话务组，3代表质检组

remark

String

False

用户组描述信息

workNos

Array

False

座席工号集合，若填写，则新增用户组的时候同时添加组成员

座席工号，取值范围为0~99999

响应消息

表3 消息体参数说明

参数名

数据类型

说明

returnCode

String

查询结果。取值如下：

  • 0：成功
  • 其他：失败

失败的原因说明请参见错误码参考。

说明：

当前字段为兼容8.13及其之前版本接口响应参数使用。

resultCode

String

执行结果。取值如下：

  • "0100000"：成功
  • 其他：失败
  • 失败的原因说明请参见错误码参考。

description

String

结果描述

说明：

当前字段为兼容8.13及其之前版本接口响应参数使用。

resultDesc

String

结果描述

样例报文

  • 请求头： 
    Content-Type: application/json;charset=UTF-8
Authorization: ******************
  • 请求参数： 
    {
        "ccId":1,
        "vdn":113,
        "groupName":"ceshipostman",
        "groupType":3,
        "remark":"此为质检组",
        "workNos":[50041,50042]
}
  • 响应参数： 
    {
    "returnCode": "0",
    "resultCode": "0100000",
    "description": "新增成功",
    "resultDesc": "新增成功"
}