新增客服组

新增客服组，name 必填且长度不能超过 60，parent 可指定父客服组。

请求参数

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

请求体

名称	类型	必填	描述	示例值
name	string	是	客服组名称，长度不能超过 60。	售前客服组
parent	int64	否	父客服组 ID，不传表示创建根客服组。	0

返回参数

名称	类型	描述	示例值
code	int32	业务状态码，200 表示成功。	200
message	string	响应消息。	success
id	int64	新增成功的客服组 ID。	10001

错误码

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

postEndpoint

/openapi/kefuGroup/add

curl -X POST "https://qiyukf.com/openapi/kefuGroup/add?appKey=demoAppKey&time=1710000000&checksum=abcdef123456" \  -H "Content-Type: application/json" \  -d '{    "name": "售前客服组"  }'

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

空

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

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

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

{
  "code": 14004,
  "message": "请求体 JSON 非法，缺少 name，name 为空或长度超过 60。"
}

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

{
  "code": 14700,
  "message": "同级客服组名称已存在。"
}

{
  "code": 14701,
  "message": "父客服组不存在或父子关系不合法。"
}

新增客服组

成功示例

业务错误示例