企业内部开发 服务端API 微信客服 统计管理 获取「客户数据统计」企业汇总数据
获取「客户数据统计」企业汇总数据

通过此接口,可以获取咨询会话数、咨询客户数等企业汇总统计数据

 

请求方式: POST(HTTPS)

请求地址: https://qyapi.weixin.qq.com/cgi-bin/kf/get_corp_statistic?access_token=ACCESS_TOKEN

请求示例

{
    "open_kfid": "OPEN_KFID",
    "start_time": 1645545600,
	"end_time": 1645632000
}

参数说明:

参数必须类型说明
access_tokenstring调用接口凭证
open_kfidstring客服帐号ID。不传入时返回的数据为企业维度汇总的数据
start_timeuint32起始日期的时间戳,填这一天的0时0分0秒(否则系统自动处理为当天的0分0秒)。取值范围:昨天至前180天
end_timeuint32结束日期的时间戳,填这一天的0时0分0秒(否则系统自动处理为当天的0分0秒)。取值范围:昨天至前180天
查询时间区间[start_time, end_time]为闭区间,最大查询跨度为31天,用户最多可获取最近180天内的数据。当天的数据需要等到第二天才能获取,建议在第二天早上六点以后再调用此接口获取前一天的数据
当传入的时间不为0点时,会向下取整,如传入1554296400(Wed Apr 3 21:00:00 CST 2019)会被自动转换为1554220800(Wed Apr 3 00:00:00 CST 2019);
开启API或授权第三方应用管理会话,没有2022年3月11日以前的统计数据

 

权限说明:

  • 企业需要使用“微信客服”secret所获取的accesstoken来调用(accesstoken如何获取?
  • 第三方应用需具有“微信客服权限->服务工具->获取客服数据统计”权限
  • 代开发自建应用需具有“微信客服权限->服务工具->获取客服数据统计”权限

 

返回结果:

{
    "errcode": 0,
    "errmsg": "ok",
	"statistic_list" : [
            {
                "stat_time" : 1645545600,
                "statistic" : {
                    "session_cnt" : 2,
                    "customer_cnt" : 1,
                    "customer_msg_cnt" : 6,
                    "upgrade_service_customer_cnt" : 0,
                    "ai_session_reply_cnt" : 1,
                    "ai_transfer_rate" : 1,
                    "ai_knowledge_hit_rate" : 0,
                },
            },
			 {
                 "stat_time" : 1645632000,
                 "statistic" : {
                     ...
                 }
            }
        ]
}

参数说明:

参数类型说明
errcodeint32返回码
errmsgstring错误码描述
statistic_listobj统计数据列表
statistic_list.stat_timeuint32数据统计日期,为当日0点的时间戳
statistic_list.statisticobj一天的统计数据。若当天未产生任何下列统计数据或统计数据还未计算完成则不会返回此项
statistic_list.statistic.session_cntuint64咨询会话数。客户发过消息并分配给接待人员或智能助手的客服会话数,转接不会产生新的会话
statistic_list.statistic.customer_cntuint64咨询客户数。在会话中发送过消息的客户数量,若客户多次咨询只计算一个客户
statistic_list.statistic.customer_msg_cntuint64咨询消息总数。客户在会话中发送的消息的数量
statistic_list.statistic.upgrade_service_customer_cntuint64升级服务客户数。通过「升级服务」功能成功添加专员或加入客户群的客户数,若同一个客户添加多个专员或客户群,只计算一个客户。在2022年3月10日以后才会有对应统计数据
statistic_list.statistic.ai_session_reply_cntuint64智能回复会话数。客户发过消息并分配给智能助手的咨询会话数。通过API发消息或者开启智能回复功能会将客户分配给智能助手
statistic_list.statistic.ai_transfer_ratefloat转人工率。一个自然日内,客户给智能助手发消息的会话中,转人工的会话的占比。
statistic_list.statistic.ai_knowledge_hit_ratefloat知识命中率。一个自然日内,客户给智能助手发送的消息中,命中知识库的占比。只有在开启了智能回复原生功能并配置了知识库的情况下,才会产生该项统计数据。当api托管了会话分配,智能回复原生功能失效。若不返回,代表没有向配置知识库的智能接待助手发送消息,该项无法计算
上一篇
获取客户基础信息
下一篇
获取「客户数据统计」接待人员明细数据