在线系统数据接口
订单绩效统计
查询订单绩效统计数据,支持按客服组、客服筛选和排序。时间范围不超过 365 天。需同时传 startTime 和 endTime 或都不传(默认近 30 天)。pageSize 上限 1000。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| appKey | string | 是 | 应用 AppKey | |
| time | int64 | 是 | 请求时间戳(秒) | |
| checksum | string | 是 | 请求签名校验和 |
请求体
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| startTime | int64 | 否 | 开始时间(毫秒时间戳),与 endTime 同时传或都不传 | 1685548800000 |
| endTime | int64 | 否 | 结束时间(毫秒时间戳),与 startTime 同时传或都不传 | 1688140799000 |
| page | int32 | 否 | 页码,从 1 开始 | 1 |
| pageSize | int32 | 否 | 每页条数,上限 1000(可配置) | 100 |
| staffIdList | int64[] | 否 | 客服 ID 列表(可选) | |
| staffGroupList | int64[] | 否 | 客服组 ID 列表(可选) | |
| order | string | 否 | 排序字段(可选) |
返回参数
| 名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| code | int32 | 状态码,200 表示成功 | 200 |
| message | object | 订单绩效统计数据 | |
| └orders | object[] | 客服订单绩效列表 | |
| └staffId | int64 | 客服 ID | |
| └userName | string | 客服登录名 | |
| └nameSpell | string | 客服姓名拼音,用于排序 | |
| └kefuName | string | 客服姓名 | |
| └serviceNums | int64 | 接待人数 | |
| └validServiceNums | int64 | 有效接待人数,不包含没有对话的会话 | |
| └totalServiceNums | int64 | 接待人数,包含匿名访客 | |
| └sellNums | int64 | 销售人数 | |
| └sell48Nums | int64 | 接待后 48 小时内支付的销售人数 | |
| └translationRadio | double | 询单转化成功率 | |
| └translation48Radio | double | 48 小时询单转化成功率 | |
| └sellMoney | double | 销售额 | |
| └sell48Money | double | 接待后 48 小时内支付的销售额 | |
| └sellMoneyRadio | double | 客服销售额占总销售额的比例 | |
| └orderNums | int64 | 订单数 | |
| └order48Nums | int64 | 接待后 48 小时内支付的订单数 | |
| └pieceNums | int64 | 商品件数 | |
| └piece48Nums | int64 | 接待后 48 小时内支付的商品件数 | |
| └kePieceNums | double | 平均每个订单的商品件数 | |
| └ke48PieceNums | double | 48 小时平均每个订单的商品件数 | |
| └keOrderPrice | double | 平均订单价格 | |
| └ke48OrderPrice | double | 48 小时平均订单价格 | |
| └unsoldServiceNums | int64 | 未下单的有效接待人数,仅单日查询且开关开启时返回 | |
| └unsoldTranslationRadio | double | 未下单访客的最终询单转化率 | |
| └sum | object | 客服订单绩效记录 | |
| └staffId | int64 | 客服 ID | |
| └userName | string | 客服登录名 | |
| └nameSpell | string | 客服姓名拼音,用于排序 | |
| └kefuName | string | 客服姓名 | |
| └serviceNums | int64 | 接待人数 | |
| └validServiceNums | int64 | 有效接待人数,不包含没有对话的会话 | |
| └totalServiceNums | int64 | 接待人数,包含匿名访客 | |
| └sellNums | int64 | 销售人数 | |
| └sell48Nums | int64 | 接待后 48 小时内支付的销售人数 | |
| └translationRadio | double | 询单转化成功率 | |
| └translation48Radio | double | 48 小时询单转化成功率 | |
| └sellMoney | double | 销售额 | |
| └sell48Money | double | 接待后 48 小时内支付的销售额 | |
| └sellMoneyRadio | double | 客服销售额占总销售额的比例 | |
| └orderNums | int64 | 订单数 | |
| └order48Nums | int64 | 接待后 48 小时内支付的订单数 | |
| └pieceNums | int64 | 商品件数 | |
| └piece48Nums | int64 | 接待后 48 小时内支付的商品件数 | |
| └kePieceNums | double | 平均每个订单的商品件数 | |
| └ke48PieceNums | double | 48 小时平均每个订单的商品件数 | |
| └keOrderPrice | double | 平均订单价格 | |
| └ke48OrderPrice | double | 48 小时平均订单价格 | |
| └unsoldServiceNums | int64 | 未下单的有效接待人数,仅单日查询且开关开启时返回 | |
| └unsoldTranslationRadio | double | 未下单访客的最终询单转化率 | |
| └total | int32 | 符合条件的客服总数 | 100 |
错误码
| 状态码 | 描述 |
|---|---|
| 14001 | AppKey 不存在 |
| 14002 | checksum 校验失败 |
| 14003 | 请求时间戳与服务器时间误差超过 10 分钟 |
| 14004 | 请求体 JSON 格式错误或参数缺失 |
| 14500 | 服务内部异常 |
| 14501 | 时间范围超过限制(>365 天);结束时间不合法 |
postEndpoint
/openapi/statistic/performancecurl -X POST "https://qiyukf.com/openapi/statistic/performance?appKey=string&time=1739347200&checksum=a1b2c3d4e5f607182930abcdefabcdef" \ -H "Content-Type: application/json" \ -d '{}'{
"code": 200,
"message": {
"orders": [
{
"staffId": 0,
"userName": "string",
"nameSpell": "string",
"kefuName": "string",
"serviceNums": 0,
"validServiceNums": 0,
"totalServiceNums": 0,
"sellNums": 0,
"sell48Nums": 0,
"translationRadio": 0.1,
"translation48Radio": 0.1,
"sellMoney": 0.1,
"sell48Money": 0.1,
"sellMoneyRadio": 0.1,
"orderNums": 0,
"order48Nums": 0,
"pieceNums": 0,
"piece48Nums": 0,
"kePieceNums": 0.1,
"ke48PieceNums": 0.1,
"keOrderPrice": 0.1,
"ke48OrderPrice": 0.1,
"unsoldServiceNums": 0,
"unsoldTranslationRadio": 0.1
}
],
"sum": {
"staffId": 0,
"userName": "string",
"nameSpell": "string",
"kefuName": "string",
"serviceNums": 0,
"validServiceNums": 0,
"totalServiceNums": 0,
"sellNums": 0,
"sell48Nums": 0,
"translationRadio": 0.1,
"translation48Radio": 0.1,
"sellMoney": 0.1,
"sell48Money": 0.1,
"sellMoneyRadio": 0.1,
"orderNums": 0,
"order48Nums": 0,
"pieceNums": 0,
"piece48Nums": 0,
"kePieceNums": 0.1,
"ke48PieceNums": 0.1,
"keOrderPrice": 0.1,
"ke48OrderPrice": 0.1,
"unsoldServiceNums": 0,
"unsoldTranslationRadio": 0.1
},
"total": 100
}
}{
"code": 14001,
"message": "AppKey 不存在"
}{
"code": 14002,
"message": "checksum 校验失败"
}{
"code": 14003,
"message": "请求时间戳与服务器时间误差超过 10 分钟"
}{
"code": 14004,
"message": "请求体 JSON 格式错误或参数缺失"
}{
"code": 14500,
"message": "服务内部异常"
}{
"code": 14501,
"message": "时间范围超过限制(>365 天);结束时间不合法"
}这篇文档有帮助吗?