七鱼开发文档中心
总览服务端 APIWebiOSAndroid鸿蒙Uniapp微信小程序插件三方接入
呼叫中心数据接口

呼叫团队历史总览数据

按时间范围和客服组筛选团队历史总览数据;数据为 T+1,最大查询跨度 90 天,同一天内按小时补足,跨天按整天补足,不传时间时默认查询近一个月,连续请求间隔不小于 5 分钟。旧协议中业务数据以 JSON 字符串形式放在 message 中。

请求参数

名称类型必填描述示例值
appKeystring是应用 AppKey
timeint64是请求时间戳,单位秒
checksumstring是请求签名校验和
checksumAlgorithmint32否签名算法:0=SHA1,1=SHA256

请求体

名称类型必填描述示例值
staffGroupListint64[]否客服组 ID 列表
startTimeint64否查询开始时间,毫秒时间戳;不传 startTime/endTime 时默认最近 30 天1719763200000
endTimeint64否查询结束时间,毫秒时间戳;最大跨度 90 天1719849599000

返回参数

名称类型描述示例值
codeint32业务状态码,200 表示业务成功200
messageobject
└unConnectCountint64无法接通量
└queueCountint64排队量
└inviteEvaluateRatiodouble邀评率
└connectSecondRatiodouble指定秒数内接通率
└satisfactionDetailCallOutobject
└level3GoodCountint64三级评价非常满意数
└level5BadCountint64五级评价不满意数
└level4VeryBadCountint64四级评价非常不满意数
└level4VeryGoodCountint64四级评价非常满意数
└level5VeryBadCountint64五级评价非常不满意数
└level3BadCountint64三级评价非常不满意数
└level5VeryGoodCountint64五级评价非常满意数
└level4BadCountint64四级评价不满意数
└level4GoodCountint64四级评价满意数
└level5SosoCountint64五级评价一般数
└level2BadCountint64二级评价不满意数
└level5GoodCountint64五级评价满意数
└level2GoodCountint64二级评价满意数
└level3SosoCountint64三级评价一般数
└callInSatisfactionRatiodouble呼入满意度
└pickupSecondRatiodouble指定秒数内振铃摘机率
└queueGiveUpCountint64队列中放弃量
└markerConnectedRatiodouble智能识别接通率
└evaluateCountint64参评数
└callLossCountint64呼损量
└callLossRadiodouble呼损率;字段名 radio 为历史协议拼写
└unAnswerCountint64客服未接听量
└avgCallInTimeint64呼入平均通话时长
└markerConnectedCountint64智能识别接通量
└callOutCountint64呼出量
└satisfactionRatiodouble相对满意度
└staffPickupSecondRatiodouble人工呼入指定秒数内振铃摘机率
└callInLengthint64呼入总时长
└inServiceCallInAnswerRatiodouble服务时间内呼入接通率
└quickHangupCountint64客户快速挂机量
└queueCallInCountint64队列呼入量
└callInStaffCountint64人工呼入量
└connectSecondint64指定接通秒数标准
└inServiceCallLossCountint64服务时间内呼损量
└outcallDiffCalleeAnswerRatiodouble呼出用户接通率,按被叫号码去重
└inServiceCallInCountint64服务时间内呼入量
└notInServiceCountint64非服务时间呼入量
└queueOverflowCountint64队列中溢出量
└criticalHangupCountint64临界挂机量
└callOutAnswerCountint64呼出接通量
└avgQueueTimeint64平均排队时长
└ringUpAnsweredSecondint64振铃摘机率统计秒数设置
└queueConnectedRatiodouble队列接通率
└callInCountint64呼入量
└oneOffRatiodouble一次性解决率
└callOutLengthint64呼出总时长
└outcallAnswerDiffCalleeCountint64呼出接通用户数,按被叫号码去重
└callSessionTotalCountint64通话总量
└callInAnswerCountint64呼入接通量
└evaluateRatiodouble参评率
└ivrGiveUpCountint64IVR 队列中放弃量
└noKefuCountint64无客服在线量
└ivrCheckFailedCountint64IVR 信息校验失败量
└callOutSatisfactionRatiodouble呼出满意度
└callInMaxAmountMinuteint64每分钟峰值呼入量
└satisfactionDetailCallInobject
└level3GoodCountint64三级评价非常满意数
└level5BadCountint64五级评价不满意数
└level4VeryBadCountint64四级评价非常不满意数
└level4VeryGoodCountint64四级评价非常满意数
└level5VeryBadCountint64五级评价非常不满意数
└level3BadCountint64三级评价非常不满意数
└level5VeryGoodCountint64五级评价非常满意数
└level4BadCountint64四级评价不满意数
└level4GoodCountint64四级评价满意数
└level5SosoCountint64五级评价一般数
└level2BadCountint64二级评价不满意数
└level5GoodCountint64五级评价满意数
└level2GoodCountint64二级评价满意数
└level3SosoCountint64三级评价一般数
└callInIc2HumanCountint64外呼机器人转人工量
└inServiceCallLossRatiodouble服务时间内呼损率
└callOutAnswerRatiodouble呼出接通率
└seatUseRatiodouble坐席利用率
└satisfactionDetailTotalobject
└level3GoodCountint64三级评价非常满意数
└level5BadCountint64五级评价不满意数
└level4VeryBadCountint64四级评价非常不满意数
└level4VeryGoodCountint64四级评价非常满意数
└level5VeryBadCountint64五级评价非常不满意数
└level3BadCountint64三级评价非常不满意数
└level5VeryGoodCountint64五级评价非常满意数
└level4BadCountint64四级评价不满意数
└level4GoodCountint64四级评价满意数
└level5SosoCountint64五级评价一般数
└level2BadCountint64二级评价不满意数
└level5GoodCountint64五级评价满意数
└level2GoodCountint64二级评价满意数
└level3SosoCountint64三级评价一般数
└inviteEvaluateCountint64邀评数
└avgCallOutTimeint64呼出平均通话时长
└callInAnswerStaffRatiodouble人工呼入接通率

错误码

状态码描述
14001AppKey 不存在
14002checksum 校验失败
14003请求时间戳与服务器时间误差超过 10 分钟
14004请求参数或内容不合法
14402查询频率超过限制
14500系统异常或处理超时
postEndpoint
/openapi/ipcc/history/team
POST
/openapi/ipcc/history/team
curl -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": "系统异常或处理超时"
}

这篇文档有帮助吗?