获取「客户数据统计」接待人员明细数据

通过此接口，可获取接入人工会话数、咨询会话数等与接待人员相关的统计信息

open_kfid和servicer_userid均为非必填参数:
\1. 不指定open_kfid，指定servicer_userid，返回单个接待人员的汇总数据；
\2. 指定open_kfid，不指定servicer_userid，返回客服帐号维度汇总数据；
\3. 不指定open_kfid，不指定servicer_userid，返回企业维度汇总数据；
\4. 指定open_kfid，指定servicer_userid，返回该接待人员在此客服账号下的数据。

查询时间区间[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如何获取？）

第三方应用需具有“微信客服权限->服务工具->获取客服数据统计”权限

代开发自建应用需具有“微信客服权限->服务工具->获取客服数据统计”权限

curl --location --request POST 'https://qyapi.weixin.qq.com/cgi-bin/kf/get_servicer_statistic' \ --header 'Content-Type: application/json' \ --data-raw '{ "open_kfid": "OPEN_KFID", "servicer_userid":"zhangsan", "start_time": 1645545600, "end_time": 1645632000 }'

{ "errcode": 0, "errmsg": "ok", "statistic_list": [ { "stat_time": 1645545600, "statistic": { "session_cnt": 1, "customer_cnt": 1, "customer_msg_cnt": 1, "reply_rate": 1, "first_reply_average_sec": 17, "satisfaction_investgate_cnt": 1, "satisfaction_participation_rate": 1, "satisfied_rate": 1, "middling_rate": 0, "dissatisfied_rate": 0, "upgrade_service_customer_cnt": 0, "upgrade_service_member_invite_cnt": 0, "upgrade_service_member_customer_cnt": 0, "upgrade_service_groupchat_invite_cnt": 0, "upgrade_service_groupchat_customer_cnt": 0 } }, { "stat_date": 1645632000, "statistic": {} } ] }

请求参数

Query 参数

access_token

string

调用接口凭证

可选

示例值:

ACCESS_TOKEN

Body 参数application/json

open_kfid

string

客服帐号ID

必需

servicer_userid

string

必需

接待人员的userid。第三方应用为密文userid，即open_userid

start_time

integer

必需

起始日期的时间戳，填当天的0时0分0秒（否则系统自动处理为当天的0分0秒）。取值范围：昨天至前180天

end_time

integer

必需

结束日期的时间戳，填当天的0时0分0秒（否则系统自动处理为当天的0分0秒）。取值范围：昨天至前180天

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

错误码描述

必需

statistic_list

array [object {3}]

统计数据列表

必需

stat_time

integer

可选

数据统计日期，为当日0点的时间戳

statistic

object

必需

一天的统计数据。若当天未产生任何下列统计数据或统计数据还未计算完成则不会返回此项

stat_date

integer

可选