3.2 客服组管理
客服分组支持层级结构（父子分组）和组织架构归属。
客服分组管理 (supportgroups)
数据结构
| 字段 | 类型 | 说明 |
|---|---|---|
| sgId | int | 分组 ID |
| sgName | string | 分组名称（同企业内唯一） |
| parentId | int | 父级分组 ID，0 表示顶级分组 |
| orgId | int | 组织架构 ID，0 表示未归属组织 |
| tags | array | 标签列表 |
| managers | array | 主管列表，元素为 {sId, name}；已进回收站的客服不输出 |
获取分组列表
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| page | int | 否 | 页码，默认 1 |
| per_page | int | 否 | 每页数量，默认 100，最大 100 |
| orgId | int | 否 | 按组织过滤，大于 0 时生效 |
{
"supportgroups": [
{
"sgId": "1",
"sgName": "根组织",
"parentId": "0",
"orgId": "30001",
"tags": [],
"managers": [
{"sId": "123", "name": "张三"}
]
}
],
"count": "4",
"previous_page": null,
"next_page": null
}parentId 自行组装树形结构。获取单个分组
{
"supportgroup": {
"sgId": "4",
"sgName": "上海组",
"parentId": "0",
"orgId": "30001",
"tags": [],
"managers": [
{"sId": "123", "name": "张三"}
]
}
}创建分组
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| sgName | string | 是 | 分组名称，最长 120 字符，同企业内唯一 |
| parentId | int | 否 | 父级分组 ID，默认 0；须为同企业存在的分组 |
| orgId | int | 否 | 组织架构 ID，默认 0；只读组织下不允许创建 |
| tags | array | 否 | 标签列表 |
| manager | array | 否 | 主管客服 sId 数组；须为本企业在职客服（回收站中的客服校验不通过） |
{
"supportgroup": {
"sgName": "上海组-浦东分部",
"parentId": 4,
"orgId": 30001,
"manager": [123, 456]
}
}{
"supportgroup": {
"sgId": "120007",
"sgName": "上海组-浦东分部",
"parentId": "0",
"orgId": "30001",
"tags": [],
"managers": [
{"sId": "123", "name": "张三"},
{"sId": "456", "name": "李四"}
]
}
}修改分组
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| sgName | string | 否 | 分组名称 |
| parentId | int | 否 | 父级分组 ID，不能是分组自身 |
| orgId | int | 否 | 组织架构 ID，只读组织下不允许修改 |
| tags | array | 否 | 标签列表 |
| manager | array | 否 | 主管客服 sId 数组，校验规则同创建 |
110042 There is no valid update value。删除分组
{
"supports": {
"sgId": "120006",
"sgName": "apitest-noorg",
"url": "http://xxx/api/v1/supportgroups/120006.json"
}
}错误码（分组相关）
| 错误码 | 说明 |
|---|---|
| 110059 | sgName 必填 |
| 110061 | parentId 必须为非负整数 |
| 110062 | parentId 对应的分组不存在 |
| 110063 | orgId 必须为非负整数 |
| 110064 | 只读组织下不允许创建/修改分组 |
| 110065 | parentId 不能是分组自身 |
| 110066 | orgId 查询参数必须为非负整数 |
| 110067 | manager 含不合法的客服 ID（不存在或已进回收站） |
修改于 2026-10-18 12:38:09