呼叫坐席历史数据

按时间范围、客服组或客服筛选坐席历史统计数据；数据为 T+1，最大查询跨度 90 天，时间会补足到整小时，不传时间时默认查询近一个月，连续请求间隔不小于 5 分钟。旧协议中业务数据以 JSON 字符串形式放在 message 中。

请求参数

名称	类型	必填	描述
appKey	string	是	应用 AppKey
time	int64	是	请求时间戳，单位秒
checksum	string	是	请求签名校验和
checksumAlgorithm	int32	否	签名算法：0=SHA1，1=SHA256

请求体

名称	类型	必填	描述	示例值
staffGroupList	int64[]	否	客服组 ID 列表；model=2 时必填
staffIdList	int64[]	否	客服 ID 列表；model=3 时必填
pageSize	int32	否	每页条数；分页接口不传或非法时按默认值处理	100
startTime	int64	否	查询开始时间，毫秒时间戳；不传 startTime/endTime 时默认最近 30 天	1719763200000
model	int32	否	查询模式：1=全部，2=按客服组，3=按客服	1
endTime	int64	否	查询结束时间，毫秒时间戳；最大跨度 90 天	1719849599000
page	int32	否	页码；分页接口不传或非法时按默认值处理	1

返回参数

名称	类型	描述	示例值
code	int32	业务状态码，200 表示业务成功	200
message	object[]	客服历史统计数组；实际响应中该数组序列化为 JSON 字符串放在 message 中	[{"callDuration":7200,"onlineDuration":28800,"staffName":"张三","startTime":1719763200000,"endTime":1719849599000,"totalCount":36,"staffId":1001,"callOutCount":16,"callInCount":20}]
└callOutAnsweredCount	int64	呼出接通量
└callDuration	int64	通话总时长
└inviteEvaluateRatio	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	三级评价一般数
└totalCount	int64	通话总量	36
└callInCount	int64	呼入量	20
└avgOutDealingDuration	int64	呼出平均处理时长
└markerConnectedRatio	double	智能识别接通率
└callInAnsweredCount	int64	呼入接通量
└evaluateCount	int64	参评数
└staffName	string	客服姓名	张三
└callInDuration	int64	呼入通话总时长
└startTime	int64	查询开始时间，毫秒时间戳	1719763200000
└outRingDuration	int64	呼出振铃总时长
└markerConnectedCount	int64	智能识别接通量
└avgInDealingDuration	int64	呼入平均处理时长
└callOutCount	int64	呼出量	16
└satisfactionRatio	double	满意度
└evaluateRatio	double	参评率
└forecastDuration	int64	自动外呼时长
└outDealingDuration	int64	呼出处理总时长
└callOutDuration	int64	呼出通话总时长
└avgCallOutDuration	int64	呼出平均通话时长
└onlineDuration	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	三级评价一般数
└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	三级评价一般数
└avgCallDuration	int64	平均通话时长
└callOutAnsweredRatio	double	呼出接通率
└inviteEvaluateCount	int64	邀评数
└inDealingDuration	int64	呼入处理总时长
└endTime	int64	查询结束时间，毫秒时间戳	1719849599000
└staffId	int64	客服 ID	1001
└avgCallInDuration	int64	呼入平均通话时长
└avgOutRingDuration	int64	呼出平均振铃时长

错误码

状态码	描述
14001	AppKey 不存在
14002	checksum 校验失败
14003	请求时间戳与服务器时间误差超过 10 分钟
14004	请求参数或内容不合法
14402	查询频率超过限制
14500	系统异常或处理超时

postEndpoint

/openapi/ipcc/history/seat

curl -X POST "https://qiyukf.com/openapi/ipcc/history/seat?appKey=string&time=0&checksum=string" \  -H "Content-Type: application/json" \  -d '{    "startTime": 1719763200000,    "model": 1,    "endTime": 1719849599000  }'

{
  "code": 200,
  "message": [
    {
      "callDuration": 7200,
      "onlineDuration": 28800,
      "staffName": "张三",
      "startTime": 1719763200000,
      "endTime": 1719849599000,
      "totalCount": 36,
      "staffId": 1001,
      "callOutCount": 16,
      "callInCount": 20
    }
  ]
}

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

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

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

{
  "code": 14004,
  "message": "请求参数或内容不合法"
}

{
  "code": 14402,
  "message": "查询频率超过限制"
}

{
  "code": 14500,
  "message": "系统异常或处理超时"
}