呼叫中心数据接口
呼叫团队历史总览数据
按时间范围和客服组筛选团队历史总览数据;数据为 T+1,最大查询跨度 90 天,同一天内按小时补足,跨天按整天补足,不传时间时默认查询近一个月,连续请求间隔不小于 5 分钟。旧协议中业务数据以 JSON 字符串形式放在 message 中。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| appKey | string | 是 | 应用 AppKey | |
| time | int64 | 是 | 请求时间戳,单位秒 | |
| checksum | string | 是 | 请求签名校验和 | |
| checksumAlgorithm | int32 | 否 | 签名算法:0=SHA1,1=SHA256 |
请求体
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| staffGroupList | int64[] | 否 | 客服组 ID 列表 | |
| startTime | int64 | 否 | 查询开始时间,毫秒时间戳;不传 startTime/endTime 时默认最近 30 天 | 1719763200000 |
| endTime | int64 | 否 | 查询结束时间,毫秒时间戳;最大跨度 90 天 | 1719849599000 |
返回参数
| 名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| code | int32 | 业务状态码,200 表示业务成功 | 200 |
| message | object | ||
| └unConnectCount | int64 | 无法接通量 | |
| └queueCount | int64 | 排队量 | |
| └inviteEvaluateRatio | double | 邀评率 | |
| └connectSecondRatio | double | 指定秒数内接通率 | |
| └satisfactionDetailCallOut | object | ||
| └level3GoodCount | int64 | 三级评价非常满意数 | |
| └level5BadCount | int64 | 五级评价不满意数 | |
| └level4VeryBadCount | int64 | 四级评价非常不满意数 | |
| └level4VeryGoodCount | int64 | 四级评价非常满意数 | |
| └level5VeryBadCount | int64 | 五级评价非常不满意数 | |
| └level3BadCount | int64 | 三级评价非常不满意数 | |
| └level5VeryGoodCount | int64 | 五级评价非常满意数 | |
| └level4BadCount | int64 | 四级评价不满意数 | |
| └level4GoodCount | int64 | 四级评价满意数 | |
| └level5SosoCount | int64 | 五级评价一般数 | |
| └level2BadCount | int64 | 二级评价不满意数 | |
| └level5GoodCount | int64 | 五级评价满意数 | |
| └level2GoodCount | int64 | 二级评价满意数 | |
| └level3SosoCount | int64 | 三级评价一般数 | |
| └callInSatisfactionRatio | double | 呼入满意度 | |
| └pickupSecondRatio | double | 指定秒数内振铃摘机率 | |
| └queueGiveUpCount | int64 | 队列中放弃量 | |
| └markerConnectedRatio | double | 智能识别接通率 | |
| └evaluateCount | int64 | 参评数 | |
| └callLossCount | int64 | 呼损量 | |
| └callLossRadio | double | 呼损率;字段名 radio 为历史协议拼写 | |
| └unAnswerCount | int64 | 客服未接听量 | |
| └avgCallInTime | int64 | 呼入平均通话时长 | |
| └markerConnectedCount | int64 | 智能识别接通量 | |
| └callOutCount | int64 | 呼出量 | |
| └satisfactionRatio | double | 相对满意度 | |
| └staffPickupSecondRatio | double | 人工呼入指定秒数内振铃摘机率 | |
| └callInLength | int64 | 呼入总时长 | |
| └inServiceCallInAnswerRatio | double | 服务时间内呼入接通率 | |
| └quickHangupCount | int64 | 客户快速挂机量 | |
| └queueCallInCount | int64 | 队列呼入量 | |
| └callInStaffCount | int64 | 人工呼入量 | |
| └connectSecond | int64 | 指定接通秒数标准 | |
| └inServiceCallLossCount | int64 | 服务时间内呼损量 | |
| └outcallDiffCalleeAnswerRatio | double | 呼出用户接通率,按被叫号码去重 | |
| └inServiceCallInCount | int64 | 服务时间内呼入量 | |
| └notInServiceCount | int64 | 非服务时间呼入量 | |
| └queueOverflowCount | int64 | 队列中溢出量 | |
| └criticalHangupCount | int64 | 临界挂机量 | |
| └callOutAnswerCount | int64 | 呼出接通量 | |
| └avgQueueTime | int64 | 平均排队时长 | |
| └ringUpAnsweredSecond | int64 | 振铃摘机率统计秒数设置 | |
| └queueConnectedRatio | double | 队列接通率 | |
| └callInCount | int64 | 呼入量 | |
| └oneOffRatio | double | 一次性解决率 | |
| └callOutLength | int64 | 呼出总时长 | |
| └outcallAnswerDiffCalleeCount | int64 | 呼出接通用户数,按被叫号码去重 | |
| └callSessionTotalCount | int64 | 通话总量 | |
| └callInAnswerCount | int64 | 呼入接通量 | |
| └evaluateRatio | double | 参评率 | |
| └ivrGiveUpCount | int64 | IVR 队列中放弃量 | |
| └noKefuCount | int64 | 无客服在线量 | |
| └ivrCheckFailedCount | int64 | IVR 信息校验失败量 | |
| └callOutSatisfactionRatio | double | 呼出满意度 | |
| └callInMaxAmountMinute | int64 | 每分钟峰值呼入量 | |
| └satisfactionDetailCallIn | object | ||
| └level3GoodCount | int64 | 三级评价非常满意数 | |
| └level5BadCount | int64 | 五级评价不满意数 | |
| └level4VeryBadCount | int64 | 四级评价非常不满意数 | |
| └level4VeryGoodCount | int64 | 四级评价非常满意数 | |
| └level5VeryBadCount | int64 | 五级评价非常不满意数 | |
| └level3BadCount | int64 | 三级评价非常不满意数 | |
| └level5VeryGoodCount | int64 | 五级评价非常满意数 | |
| └level4BadCount | int64 | 四级评价不满意数 | |
| └level4GoodCount | int64 | 四级评价满意数 | |
| └level5SosoCount | int64 | 五级评价一般数 | |
| └level2BadCount | int64 | 二级评价不满意数 | |
| └level5GoodCount | int64 | 五级评价满意数 | |
| └level2GoodCount | int64 | 二级评价满意数 | |
| └level3SosoCount | int64 | 三级评价一般数 | |
| └callInIc2HumanCount | int64 | 外呼机器人转人工量 | |
| └inServiceCallLossRatio | double | 服务时间内呼损率 | |
| └callOutAnswerRatio | double | 呼出接通率 | |
| └seatUseRatio | double | 坐席利用率 | |
| └satisfactionDetailTotal | object | ||
| └level3GoodCount | int64 | 三级评价非常满意数 | |
| └level5BadCount | int64 | 五级评价不满意数 | |
| └level4VeryBadCount | int64 | 四级评价非常不满意数 | |
| └level4VeryGoodCount | int64 | 四级评价非常满意数 | |
| └level5VeryBadCount | int64 | 五级评价非常不满意数 | |
| └level3BadCount | int64 | 三级评价非常不满意数 | |
| └level5VeryGoodCount | int64 | 五级评价非常满意数 | |
| └level4BadCount | int64 | 四级评价不满意数 | |
| └level4GoodCount | int64 | 四级评价满意数 | |
| └level5SosoCount | int64 | 五级评价一般数 | |
| └level2BadCount | int64 | 二级评价不满意数 | |
| └level5GoodCount | int64 | 五级评价满意数 | |
| └level2GoodCount | int64 | 二级评价满意数 | |
| └level3SosoCount | int64 | 三级评价一般数 | |
| └inviteEvaluateCount | int64 | 邀评数 | |
| └avgCallOutTime | int64 | 呼出平均通话时长 | |
| └callInAnswerStaffRatio | double | 人工呼入接通率 |
错误码
| 状态码 | 描述 |
|---|---|
| 14001 | AppKey 不存在 |
| 14002 | checksum 校验失败 |
| 14003 | 请求时间戳与服务器时间误差超过 10 分钟 |
| 14004 | 请求参数或内容不合法 |
| 14402 | 查询频率超过限制 |
| 14500 | 系统异常或处理超时 |
postEndpoint
/openapi/ipcc/history/teamcurl -X POST "https://qiyukf.com/openapi/ipcc/history/team?appKey=string&time=0&checksum=string" \ -H "Content-Type: application/json" \ -d '{ "staffGroupList": [ 1001 ], "startTime": 1719763200000, "endTime": 1719849599000 }'{
"code": 200,
"message": {
"callOutAnswerCount": 55,
"queueCount": 12,
"avgQueueTime": 18,
"callSessionTotalCount": 200,
"callInAnswerCount": 110,
"callOutCount": 80,
"satisfactionRatio": 0.95,
"callInCount": 120
}
}{
"code": 14001,
"message": "AppKey 不存在"
}{
"code": 14002,
"message": "checksum 校验失败"
}{
"code": 14003,
"message": "请求时间戳与服务器时间误差超过 10 分钟"
}{
"code": 14004,
"message": "请求参数或内容不合法"
}{
"code": 14402,
"message": "查询频率超过限制"
}{
"code": 14500,
"message": "系统异常或处理超时"
}这篇文档有帮助吗?