坐席模块授权

3. 坐席模块授权（增量开通）

为指定客服增量开通一个或多个服务模块。不影响该客服其他模块的既有授权（非全量覆盖，覆盖式设置请用更新坐席接口的 module 字段）。

POST /api/v1/supports/module_grant.json
Authorization: Basic <encoded-value>
Content-Type: application/json

请求体

{
  "support": {
    "sId": 5,
    "module": [5, 6]
  }
}

字段	类型	必填	说明
sId	int	是	坐席 ID（须属于当前服务商）
module	int[]	是	模块 mId 数组（1/4/5/6/7/8），见模块映射表

逐模块处理规则（接口内建）

场景	结果
模块不存在 / 服务商未购买 / 已过期	`errors`：`XX 功能已过期或未购买` / `功能不存在`
坐席已授权该模块	`already_granted`（幂等，不重复写入）
已授权数量达上限（number）	`errors`：`XX 客服授权数量已达上限(N)`
授权成功	`granted`：写入 servicers_set（type = mId+1）；在线客服 (mId=5) 连带开通即时聊天 (type=4)；刷新坐席模块 / IM 客服列表缓存；微信网页授权租户同步 add 坐席；写 operateLog (type=8) + 审计日志 ServicerModuleGrant

响应示例（部分成功语义：granted_modules 与 errors 并存）

{
  "support": {
    "sId": "5",
    "granted_modules": [
      {"mId": "5", "module": "在线客服", "result": "granted"},
      {"mId": "6", "module": "工单客服", "result": "already_granted"}
    ],
    "errors": [
      {"mId": "9", "module": "不存在的模块", "error": "功能不存在"}
    ]
  }
}

在 Header 添加参数

Authorization

，其值为在 Basic 之后拼接空格，以及经过 Base64 编码的 username:password

示例：

Authorization: Basic *****************

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
  "support": {
    "sId": "5",
    "granted_modules": [
      {"mId": "5", "module": "在线客服", "result": "granted"},
      {"mId": "6", "module": "工单客服", "result": "already_granted"}
    ],
    "errors": [
      {"mId": "9", "module": "不存在的模块", "error": "功能不存在"}
    ]
  }
}

3. 坐席模块授权（增量开通）

请求参数

请求示例代码

返回响应

坐席模块授权

3. 坐席模块授权（增量开通）#

请求参数

请求示例代码

返回响应

3. 坐席模块授权（增量开通）