客服质量统计

查询客服质量统计数据，支持按客服组或客服筛选。时间范围不超过 31 天（可配置），默认查询近 30 天。model 参数：1-全部、2-按客服组、3-按客服。pageSize 上限 1000（可配置）。

请求参数

名称	类型	必填	描述
appKey	string	是	应用 AppKey
time	int64	是	请求时间戳（秒）
checksum	string	是	请求签名校验和

请求体

名称	类型	必填	描述	示例值
model	int64	否	查询模式：1-全部、2-按客服组、3-按客服	1
startTime	int64	否	开始时间（毫秒时间戳），不传默认 30 天前	1685548800000
endTime	int64	否	结束时间（毫秒时间戳），不传默认昨天 23:59:59	1688140799000
staffGroupList	int64[]	否	客服组 ID 列表（model=2 时有效）
staffIdList	int64[]	否	客服 ID 列表（model=3 时有效）
page	int32	否	页码，从 1 开始	1
pageSize	int32	否	每页条数，上限 1000（可配置）	100

返回参数

名称	类型	描述	示例值
code	int32	状态码，200 表示成功	200
message	object	客服质量统计分页数据
└total	int32	符合条件的记录总数	150
└result	object[]	客服质量统计记录列表
└id	int64	客服 ID	10001
└name	string	客服姓名	张三
└namePinyin	string	客服姓名拼音	张三
└avgFirstRespTime	int64	平均首次响应时长，单位毫秒	12000
└avgRespTime	int64	平均响应时长，单位毫秒	8000
└avgRgTime	int64	平均人工接待时长，单位毫秒	300000
└avgRobotHostingDuration	int64	平均机器人托管时长	60000
└replyRatio	double	30 秒内应答率	0.95
└avgTime	int64	平均会话时长，单位毫秒	360000
└evaRatio	double	参评率	0.8
└evaCount	int64	参评数	80
└satisfactionRatio	double	满意度	0.96
└role	int32	客服角色标识	1
└timestamp	int64	统计时间戳	1685548800000
└evaluationDetail	string	满意度详情	示例
└dynamicTitle	object	新版满意度明细，key 为评价项，value 为数量	{"示例":1}
└rest	string	小休明细	示例
└rest1	int64	小休类型 1 时长	10
└rest2	int64	小休类型 2 时长	10
└rest3	int64	小休类型 3 时长	10
└rest5	int64	小休类型 5 时长	10
└rest4	int64	小休类型 4 时长	10
└rest90	int64	自定义小休时长	10
└evaFromCount	int64	邀评数	100
└evaFromAll	int64	邀评总数	120
└evaFromRatio	double	邀评率	0.83
└goodEvaCount	int64	好评数	75
└badEvaCount	int64	差评数	5
└answerReplyRatio	double	答问比	1.2
└oneOffRatio	double	一次解决率	0.85
└withdrawCnt	int64	撤回消息数	2
└userResolvedRatio	double	用户问题解决率	0.9
└startTime	int64	统计开始时间，毫秒时间戳	1685548800000
└endTime	int64	统计结束时间，毫秒时间戳	1688140799000
└sum	object	客服质量统计记录
└id	int64	客服 ID	10001
└name	string	客服姓名	张三
└namePinyin	string	客服姓名拼音	张三
└avgFirstRespTime	int64	平均首次响应时长，单位毫秒	12000
└avgRespTime	int64	平均响应时长，单位毫秒	8000
└avgRgTime	int64	平均人工接待时长，单位毫秒	300000
└avgRobotHostingDuration	int64	平均机器人托管时长	60000
└replyRatio	double	30 秒内应答率	0.95
└avgTime	int64	平均会话时长，单位毫秒	360000
└evaRatio	double	参评率	0.8
└evaCount	int64	参评数	80
└satisfactionRatio	double	满意度	0.96
└role	int32	客服角色标识	1
└timestamp	int64	统计时间戳	1685548800000
└evaluationDetail	string	满意度详情	示例
└dynamicTitle	object	新版满意度明细，key 为评价项，value 为数量	{"示例":1}
└rest	string	小休明细	示例
└rest1	int64	小休类型 1 时长	10
└rest2	int64	小休类型 2 时长	10
└rest3	int64	小休类型 3 时长	10
└rest5	int64	小休类型 5 时长	10
└rest4	int64	小休类型 4 时长	10
└rest90	int64	自定义小休时长	10
└evaFromCount	int64	邀评数	100
└evaFromAll	int64	邀评总数	120
└evaFromRatio	double	邀评率	0.83
└goodEvaCount	int64	好评数	75
└badEvaCount	int64	差评数	5
└answerReplyRatio	double	答问比	1.2
└oneOffRatio	double	一次解决率	0.85
└withdrawCnt	int64	撤回消息数	2
└userResolvedRatio	double	用户问题解决率	0.9
└startTime	int64	统计开始时间，毫秒时间戳	1685548800000
└endTime	int64	统计结束时间，毫秒时间戳	1688140799000

错误码

状态码	描述
14001	AppKey 不存在
14002	checksum 校验失败
14003	请求时间戳与服务器时间误差超过 10 分钟
14004	请求体 JSON 格式错误或参数缺失
14500	服务内部异常
14501	时间范围超过限制（>31 天）；结束时间不合法

postEndpoint

/openapi/statistic/staffquality

curl -X POST "https://qiyukf.com/openapi/statistic/staffquality?appKey=string&time=1739347200&checksum=a1b2c3d4e5f607182930abcdefabcdef" \  -H "Content-Type: application/json" \  -d '{}'

{
  "code": 200,
  "message": {
    "total": 150,
    "result": [
      {
        "id": 10001,
        "name": "张三",
        "namePinyin": "张三",
        "avgFirstRespTime": 12000,
        "avgRespTime": 8000,
        "avgRgTime": 300000,
        "avgRobotHostingDuration": 60000,
        "replyRatio": 0.95,
        "avgTime": 360000,
        "evaRatio": 0.8,
        "evaCount": 80,
        "satisfactionRatio": 0.96,
        "role": 1,
        "timestamp": 1685548800000,
        "evaluationDetail": "示例",
        "dynamicTitle": {
          "示例": 1
        },
        "rest": "示例",
        "rest1": 10,
        "rest2": 10,
        "rest3": 10,
        "rest5": 10,
        "rest4": 10,
        "rest90": 10,
        "evaFromCount": 100,
        "evaFromAll": 120,
        "evaFromRatio": 0.83,
        "goodEvaCount": 75,
        "badEvaCount": 5,
        "answerReplyRatio": 1.2,
        "oneOffRatio": 0.85,
        "withdrawCnt": 2,
        "userResolvedRatio": 0.9,
        "startTime": 1685548800000,
        "endTime": 1688140799000
      }
    ],
    "sum": {
      "id": 10001,
      "name": "张三",
      "namePinyin": "张三",
      "avgFirstRespTime": 12000,
      "avgRespTime": 8000,
      "avgRgTime": 300000,
      "avgRobotHostingDuration": 60000,
      "replyRatio": 0.95,
      "avgTime": 360000,
      "evaRatio": 0.8,
      "evaCount": 80,
      "satisfactionRatio": 0.96,
      "role": 1,
      "timestamp": 1685548800000,
      "evaluationDetail": "示例",
      "dynamicTitle": {
        "示例": 1
      },
      "rest": "示例",
      "rest1": 10,
      "rest2": 10,
      "rest3": 10,
      "rest5": 10,
      "rest4": 10,
      "rest90": 10,
      "evaFromCount": 100,
      "evaFromAll": 120,
      "evaFromRatio": 0.83,
      "goodEvaCount": 75,
      "badEvaCount": 5,
      "answerReplyRatio": 1.2,
      "oneOffRatio": 0.85,
      "withdrawCnt": 2,
      "userResolvedRatio": 0.9,
      "startTime": 1685548800000,
      "endTime": 1688140799000
    }
  }
}

{
  "code": 14001,
  "message": "AppKey 不存在"
}

{
  "code": 14002,
  "message": "checksum 校验失败"
}

{
  "code": 14003,
  "message": "请求时间戳与服务器时间误差超过 10 分钟"
}

{
  "code": 14004,
  "message": "请求体 JSON 格式错误或参数缺失"
}

{
  "code": 14500,
  "message": "服务内部异常"
}

{
  "code": 14501,
  "message": "时间范围超过限制（>31 天）；结束时间不合法"
}