NXCC API AgentEfficiencyStatistics

• 查询坐席状态信息

  • URL：https://api2.nxcloud.com/saas/cc/openapi/agent/efficiencyStatistical/page
  • Method：POST
  • Content-Type：application/json
  • Required：yes

鉴权机制

鉴权规则请参考地址：API 接口调用约定

请求参数

header：

参数名	类型	必选	示例值	说明
accessKey	String	Y	fme2na3kdi3ki	用户身份标识
ts	String	Y	1655710885431	当前请求的时间戳（单位是毫秒），牛信服务端允许用户端请求最大时间误差为 60 秒
bizType	String	Y	8	业务类型，取固定值“8”
action	String	Y	cc	业务操作，取固定值“cc”
sign	String	Y	6e9506557d1f289501d333ee2c365826	API 入参参数签名，签名算法

body ：

参数名	类型	必选	示例值	说明
userName	String	否	0	用户账号(邮箱或者NX开头的账号)
groupName	String	否		坐席组名称
tenantId	Long	否		团队id(可以在nxlink页面查询)
staticalType	enum	是	0	统计类型：0: 总计， 1:按天统计
startDateTime	String	是	2024-01-22 00:00:00	开始时间
endDateTime	String	是	2024-01-22 23:59:59	结束时间
size	Integer	是	100	每页大小（最大 100）
page	Integer	是	1	页数（从 1 开始）

请求示例

body（application/json）：

{
  "userName": "NXAgent0001",
  "groupName": "NXGroup0001"
  "tenantId": 144,
  "staticalType": 0,
  "size": 20,
  "page": 1,
  "startDateTime":"2024-01-08 00:00:00",
  "endDateTime":"2024-01-08 23:59:59"
}

响应参数

name	type	Description
code	Integer	结果编码
data	Object	请求结果
msg	String	请求结果说明
total	Integer	总数

请求成功

• data 参数：

名称	类型	说明
agentName	string	坐席账号
agentNickName	string	坐席昵称
answerCountInFive	integer(int32)	5秒内应答数
answerCountInTen	integer(int32)	10秒内应答数
answerCountInTwenty	integer(int32)	20秒内应答数
calcDay	string(date-time)	统计日期
evaluateCount	integer(int32)	客户评价数
groupName	string	坐席组名称
inAgentNoanswerCount	integer(int32)	呼入坐席未接听次数(坐席未接)
inAnswerCount	integer(int32)	呼入坐席接听数
inAnswerRatio	string	呼入坐席振铃次数接听率
inAnswerRingAvgTime	integer(int32)	平均应答速度s （通话应答时间之和÷通话次数）
inCallDuration	integer(int32)	呼入通话时长之和
inCallDurationAvgTime	integer(int32)	平均呼入通话时长s
inCount	integer(int32)	呼入坐席次数
inNoanswerCount	integer(int32)	呼入坐席未接听次数
inRingCount	integer(int32)	呼入坐席振铃次数
inRingDuration	integer(int32)	呼入振铃时长之和
inRingRate	string	呼入坐席振铃次数接听率 (呼入坐席接听数÷呼入坐席振铃次数)
inUserNoanswerCount	integer(int32)	呼入坐席未接听次数(用户放弃)
outAnswerCount	integer(int32)	坐席呼出接听数
outAnswerRatio	string	坐席呼出接听率(呼出接听数÷坐席呼出次数)
outCallDuration	integer(int32)	呼出通话时长之和
outCallDurationAvgTime	integer(int32)	平均呼出通话时长
outCount	integer(int32)	坐席呼出次数
outNoanswerCount	integer(int32)	坐席呼出未接听数
satisfiedAndVerySatisfiedCount	integer(int32)	非常满意、满意数
dissatisfiedCount	integer(int32)	不满意数
satisfiedAndVerySatisfiedRate	string	客户满意率(非常满意、满意数÷客户评价数)

响应示例

成功示例

{ "reqId": "a23738fb613d889026fa2c8f4e4378f1", "code": 0, "msg": "请求成功", "data": [ { "agentName": "string", "agentNickName": "string", "answerCountInFive": 0, "answerCountInTen": 0, "answerCountInTwenty": 0, "calcDay": "2019-08-24 14:15:22", "evaluateCount": 0, "groupName": "string", "inAgentNoanswerCount": 0, "inAnswerCount": 0, "inAnswerRatio": "string", "inAnswerRingAvgTime": 0, "inCallDuration": 0, "inCallDurationAvgTime": 0, "inCount": 0, "inNoanswerCount": 0, "inRingCount": 0, "inRingDuration": 0, "inRingRate": "string", "inUserNoanswerCount": 0, "outAnswerCount": 0, "outAnswerRatio": "string", "outCallDuration": 0, "outCallDurationAvgTime": 0, "outCount": 0, "outNoanswerCount": 0, "dissatisfiedCount": 0, "satisfiedAndVerySatisfiedCount": 0, "satisfiedAndVerySatisfiedRate": "string" } ] }

失败示例

{
  "reqId": "FFDD1791E22F4D9DBA967C245C58E544",
  "code": 1001,
  "msg": "Authorization Failed",
  "data": {},
  "total": 0   
}

响应码说明

code	message	Resolution
0	请求成功
88	请求失败	请联系技术人员排除问题
99	系统错误	请联系技术人员排除问题
1000~100X	鉴权失败	详情查看 API 鉴权部分