查询机器人统计汇总

查询机器人统计汇总。

接口级参数规则：startTime、endTime 必填且 startTime 必须小于 endTime；统计范围不能超过服务端配置的最大天数。

请求字段限制：

robotId：选填，机器人 ID，不传时使用默认机器人
startTime：必填，开始时间，毫秒时间戳；必须小于 endTime
endTime：必填，结束时间，毫秒时间戳；统计范围不能超过服务端配置的最大天数

请求参数

名称	类型	必填	描述	示例值
appKey	string	是	应用 AppKey	1c088a89de51d0af457616605f28390f
time	int64	是	请求时间戳（秒）；与服务器时间误差超过 10 分钟会鉴权失败	1511832531
checksum	string	是	请求签名校验和	f570a5eb049eb803b086e45829b07e48
checksumAlgorithm	int32	否	签名算法：0-SHA-1，1-SHA-256；不传默认为 0（SHA-1）	0

请求体

名称	类型	必填	描述	示例值
robotId	int64	否	机器人 ID，不传时使用默认机器人	123456
startTime	int64	是	开始时间，毫秒时间戳；必须小于 endTime	1700000000000
endTime	int64	是	结束时间，毫秒时间戳；统计范围不能超过服务端配置的最大天数	1700100000000

返回参数

名称	类型	描述	示例值
code	int32	业务状态码，200 表示成功	200
message	string	响应消息	success
data	object	机器人统计汇总数据
└robotId	int64	机器人 ID	123456
└sumSessions	int64	总会话数	1000
└invalidSessions	int64	无效会话数	20
└validSessions	int64	有效会话数	980
└solvenums	int64	已解决会话数	800
└unSolvenums	int64	未解决会话数	180
└solveRadio	double	解决率	81.63
└transferKefu	int64	转人工数	120
└robotTransfer	int64	机器人主动转人工数	80
└leave	int64	访客离开数	60
└sumQuestions	int64	问题总数	1500
└matchQuestions	int64	匹配问题数	1300
└matchRadio	double	匹配率	86.67
└matcherFromRobot	int64	机器人答案匹配数	900
└completeMatcher	int64	完整匹配数	600
└completeMatchRatio	double	完整匹配率	40
└similarMatcher	int64	相似问匹配数	300
└similarMatchRatio	double	相似问匹配率	20
└chosenMatcher	int64	推荐问题选择数	100
└similarMatchAcceptRatio	double	相似问匹配采纳率	33.33
└evaluateBad	int64	非常不满意评价数	2
└evaluateUngood	int64	不满意评价数	3
└evaluateNormal	int64	一般评价数	10
└evaluateGood	int64	满意评价数	40
└evaluateVeryGood	int64	非常满意评价数	80
└evaluateJoinRatio	double	评价参与率	13.5
└evaluateGoodRatio	double	好评率	92.31
total	int32	分页总数，分页接口返回	100
requestId	string	链路请求 ID	0a1b2c3d4e5f
result	object	部分历史接口使用 result 字段承载业务数据

错误码

状态码	描述
14001	AppKey 缺失或不存在
14002	checksum 校验失败
14003	请求时间戳与服务器时间误差超过 10 分钟
14004	请求体不是合法 JSON 对象，或参数缺失、格式非法
14009	频控限制：接口调用超过限流阈值
14500	服务内部错误
14501	数据查询范围超出限制
14515	当前 AppKey 无接口或资源访问权限

postEndpoint

/openapi/robot/statistic/summary

curl -X POST "https://qiyukf.com/openapi/robot/statistic/summary?appKey=1c088a89de51d0af457616605f28390f&time=1511832531&checksum=f570a5eb049eb803b086e45829b07e48" \  -H "Content-Type: application/json" \  -d '{    "startTime": 1700000000000,    "endTime": 1700100000000,    "robotId": 123456  }'

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

{
  "code": 14001,
  "message": "AppKey not exists"
}

{
  "code": 14002,
  "message": "Bad checksum"
}

{
  "code": 14003,
  "message": "Bad time"
}

{
  "code": 14004,
  "message": "body内容json解析错误"
}

{
  "code": 14009,
  "message": "单位时间内请求过于频繁"
}

{
  "code": 14500,
  "message": "Internal error"
}

{
  "code": 14501,
  "message": "Data limit exceeded"
}

{
  "code": 14515,
  "message": "未开通机器人服务"
}