查询客服组列表（基础信息）

查询企业下全部客服组，成功结果放在 data 字段。

请求参数

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

返回参数

名称	类型	描述	示例值
code	int32	业务状态码，200 表示成功。	200
message	string	响应消息。	success
data	object[]	业务数据。
└id	int64	客服组 ID。
└name	string	客服组名称。
└parent	int64	父客服组 ID。
└pinyin	string	客服组名称拼音。
└rank	int32	排序值。
└serviceCnt	int32	当前服务人数。
└maxServiceCnt	int32	最大服务人数。
└pinyin2	string	下拉搜索使用的拼音。
└staffCount	int32	客服数量。
└updateStaffName	string	最后更新的客服名称。
└updateTime	int64	最后更新时间。
└staffNames	string	客服名称摘要。
└number	int32	电话转接号码。
└status	int32	客服组状态。
└path	string	客服组路径。
└groupLevel	string	客服组层级。
└children	object[]	子客服组列表。
└id	int64	客服组 ID。
└name	string	客服组名称。
└parent	int64	父客服组 ID。
└pinyin	string	客服组名称拼音。
└rank	int32	排序值。
└serviceCnt	int32	当前服务人数。
└maxServiceCnt	int32	最大服务人数。
└pinyin2	string	下拉搜索使用的拼音。
└staffCount	int32	客服数量。
└updateStaffName	string	最后更新的客服名称。
└updateTime	int64	最后更新时间。
└staffNames	string	客服名称摘要。
└number	int32	电话转接号码。
└status	int32	客服组状态。
└path	string	客服组路径。
└groupLevel	string	客服组层级。
└children	object[]	子客服组列表。

错误码

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

postEndpoint

/openapi/kefuGroup/v2/list

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

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

空

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

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

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

{
  "code": 14004,
  "message": "请求体 JSON 非法。"
}

{
  "code": 14500,
  "message": "服务端处理异常，或查询客服组列表下游服务返回失败。"
}

{
  "code": 14702,
  "message": "企业下无可用客服组，或客服组配置不存在。"
}

查询客服组列表（基础信息）

成功示例

业务错误示例