删除客服组

根据 groupId 删除客服组，客服组不存在或正在使用时返回业务错误。

请求参数

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

请求体

名称	类型	必填	描述	示例值
groupId	int64	是	客服组 ID。	10001

返回参数

名称	类型	描述	示例值
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。
14500	业务错误码，HTTP 状态码仍为 200：服务端处理异常，或下游业务服务返回失败。
14702	业务错误码，HTTP 状态码仍为 200：客服组不存在。
147015	业务错误码，HTTP 状态码仍为 200：客服组包含子组或成员，不能删除。

postEndpoint

/openapi/kefuGroup/delete

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

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

空

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

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

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

{
  "code": 14004,
  "message": "请求体 JSON 非法，或缺少 groupId。"
}

{
  "code": 14500,
  "message": "服务端处理异常，或下游业务服务返回失败。"
}

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

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

{
  "code": 200001,
  "message": "删除客服组时发生未分类业务异常。"
}

删除客服组

成功示例

业务错误示例