更新客服组成员

根据 groupId 和 kefuIds 更新客服组成员列表。

请求参数

名称	类型	必填	描述	示例值
appKey	string	是	七鱼 OpenAPI appKey。	demoAppKey
time	int64	是	请求时间戳，秒级。	1710000000
checksum	string	是	按 appSecret、请求体 MD5 和 time 计算的校验值。	abcdef123456
checksumAlgorithm	int32	否	校验算法，未传时使用 0。	0

请求体

名称	类型	必填	描述	示例值
groupId	int64	是	客服组 ID。	10001
kefuIds	int64[]	是	客服组成员客服 ID 列表。

返回参数

名称	类型	描述	示例值
code	int32	业务状态码，200 表示成功。	200
message	string	响应消息。	success

错误码

状态码	描述
400	请求参数格式错误或缺少必要字段。
500	服务端处理异常。
14001	业务错误码，HTTP 状态码仍为 200：appKey 不存在或无效，或无法通过 appKey 查询企业。
14002	业务错误码，HTTP 状态码仍为 200：checksum 签名校验失败，或内部调用 appKey 不匹配。
14003	业务错误码，HTTP 状态码仍为 200：time 与服务器时间相差超过 10 分钟，或时间参数为空。
14004	业务错误码，HTTP 状态码仍为 200：请求体 JSON 非法，缺少 groupId/kefuIds，或 kefuIds 不是合法数组。
14500	业务错误码，HTTP 状态码仍为 200：服务端处理异常，或更新客服组成员下游服务返回失败。
14702	业务错误码，HTTP 状态码仍为 200：客服组不存在。
147015	业务错误码，HTTP 状态码仍为 200：客服组包含子组或成员，不能更新成员。

postEndpoint

/openapi/kefuGroup/updateKefus

curl -X POST "https://qiyukf.com/openapi/kefuGroup/updateKefus?appKey=demoAppKey&time=1710000000&checksum=abcdef123456" \  -H "Content-Type: application/json" \  -d '{    "groupId": 10001,    "kefuIds": [      20001    ]  }'

{
  "code": 200,
  "message": "success"
}

空

{
  "code": 14001,
  "message": "appKey 不存在或无效，或无法通过 appKey 查询企业。"
}

{
  "code": 14002,
  "message": "checksum 签名校验失败，或内部调用 appKey 不匹配。"
}

{
  "code": 14003,
  "message": "time 与服务器时间相差超过 10 分钟，或时间参数为空。"
}

{
  "code": 14004,
  "message": "请求体 JSON 非法，缺少 groupId/kefuIds，或 kefuIds 不是合法数组。"
}

{
  "code": 14500,
  "message": "服务端处理异常，或更新客服组成员下游服务返回失败。"
}

{
  "code": 14702,
  "message": "客服组不存在。"
}

{
  "code": 147015,
  "message": "客服组包含子组或成员，不能更新成员。"
}

更新客服组成员

成功示例

业务错误示例