呼叫总览数据

按客服组、IVR 或 DID 筛选实时呼叫总览数据，包含排队量、呼入呼出量、通话时长和坐席状态等统计；频率限制为 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
└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

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

{
  "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,
    "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": "系统异常或处理超时"
}