呼叫总览数据(客服组维度)

按客服组维度批量获取实时呼叫总览数据，返回每个客服组的排队量、呼入呼出量、通话时长和坐席状态等统计；频率限制为 3 秒一次。

请求参数

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

请求体

名称	类型	必填	描述
kefuGroupList	int64[]	否	客服组 ID 列表
ivrList	string[]	否	IVR ID 列表
didList	string[]	否	DID 号码列表

返回参数

名称	类型	描述	示例值
code	int32	业务状态码，200 表示业务成功	200
data	object[]	各客服组的呼叫总览统计数据
└callOutRadio	double	呼出接起率	0.68
└avgQueueTime	int64	平均排队时长	18
└hangupStaffCount	int64	挂起坐席数	1
└callOutCallDuraAVG	int64	呼出平均通话时长	150
└callOutDiffCalleeAnswerRatio	double	呼出用户接通率，按被叫号码去重	0.56
└callInCallDuraAVG	int64	呼入平均通话时长	180
└resoveStaffCount	int64	处理中的客服数量；resove 为历史协议字段名	2
└callOutTotalTime	int64	呼出总时长	14000
└callInRingAnswerDuraAVG	int64	呼入平均振铃接听时长	8
└callOutDiffCalleeAnswerCount	int64	呼出接通用户数，按被叫号码去重	45
└sipOnlineStaffCount	int64	SIP 在线坐席数	3
└callSessionTotalCount	int64	电话总量	200
└mobileOnlineStaffCount	int64	手机在线坐席数	2
└queueSize	int64	排队量	3
└callInTotalTime	int64	呼入总时长	22000
└kefuGroupId	int64	客服组 ID	1001
└inTotal	int64	呼入量	120
└callSessionTotalTime	int64	通话总时长	36000
└queueTimeMax	int64	最长排队时长	120
└callOutDealDuraAVG	int64	呼出平均处理时长	25
└ringingPickRatio	double	振铃摘机率	0.88
└callInDealDuraAVG	int64	呼入平均处理时长	30
└evaluatedRadio	double	参评率	0.35
└evaluatedCount	int64	参评数	60
└callingStaffCount	int64	正在通话中的客服数量	8
└onlineStaffCount	int64	空闲坐席数	10
└forecastOnlineStaffCount	int64	自动外呼坐席数	4
└relativeSatisfactionRatio	double	相对满意度	0.95
└restStaffCount	int64	小休坐席数	1
└outTotal	int64	呼出量	80
└callInRadio	double	呼入接起率	0.92
└queueAnswerRadio	double	队列接通率	0.9
message	string	响应消息；业务失败时为失败原因	success

错误码

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

postEndpoint

/openapi/ipcc/realtime/overview/data/group

curl -X POST "https://qiyukf.com/openapi/ipcc/realtime/overview/data/group?appKey=string&time=0&checksum=string" \  -H "Content-Type: application/json" \  -d '{    "kefuGroupList": [      1001,      1002    ]  }'

{
  "code": 200,
  "data": [
    {
      "callOutRadio": 0.68,
      "avgQueueTime": 18,
      "hangupStaffCount": 1,
      "callOutCallDuraAVG": 150,
      "callOutDiffCalleeAnswerRatio": 0.56,
      "callInCallDuraAVG": 180,
      "resoveStaffCount": 2,
      "callOutTotalTime": 14000,
      "callInRingAnswerDuraAVG": 8,
      "callOutDiffCalleeAnswerCount": 45,
      "sipOnlineStaffCount": 3,
      "callSessionTotalCount": 200,
      "mobileOnlineStaffCount": 2,
      "queueSize": 3,
      "callInTotalTime": 22000,
      "kefuGroupId": 1001,
      "inTotal": 120,
      "callSessionTotalTime": 36000,
      "queueTimeMax": 120,
      "callOutDealDuraAVG": 25,
      "ringingPickRatio": 0.88,
      "callInDealDuraAVG": 30,
      "evaluatedRadio": 0.35,
      "evaluatedCount": 60,
      "callingStaffCount": 8,
      "onlineStaffCount": 10,
      "forecastOnlineStaffCount": 4,
      "relativeSatisfactionRatio": 0.95,
      "restStaffCount": 1,
      "outTotal": 80,
      "callInRadio": 0.92,
      "queueAnswerRadio": 0.9
    }
  ],
  "message": "success"
}

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

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

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

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

{
  "code": 14009,
  "message": "请求过于频繁"
}

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