本页只说明当前系统如何统计、汇总和评分。企微后台管理总览与开放 API 的员工聚合口径不完全相同，采购或考核前请同时阅读“使用边界”。
员工数量
168
客户联系成员
168
参与评分
168
采集提示
1
1
统计范围与时间口径
先确定“谁的数据、哪一天的数据、哪些数据能取”。
采集对象
通讯录同步接口返回的全部员工；客户联系数据只采集已配置客户联系功能、且在客户联系 Secret 对应应用可见范围内的成员。
统计时间
页面统计日期是业务发生日。例如 2026-10-13 的数据于次日采集生成，页面不包含采集当天尚未结束的数据。
数据边界
只取聚合统计数字，不读取、不保存单条聊天原文；不开启、不调用会话存档。
接口保留期
企微官方行为统计接口通常只保留最近 180 天，历史补采不能无限向前追溯。
采集频率
默认每天定时运行，每次生成一份按业务日期归档的 CSV、Excel、HTML、JSON 和日报文本。
数据权限
应用可见范围决定客户联系成员、客户群主和客户关系的可拉取范围；范围外的数据不会因为重复运行而出现。
2
采集接口与数据来源
每一项指标都能追溯到企微官方接口，避免把后台总览页面和开放 API 混用。
| 指标域 | 官方接口 | 用途 |
|---|---|---|
| 部门与员工账号 | 通讯录同步接口 | 拉取部门、全员账号、主部门和账号状态。 |
| 客户联系成员范围 | externalcontact/get_follow_user_list | 确认哪些成员配置了客户联系功能，后续只采集这些成员。 |
| 客户单聊行为 | externalcontact/get_user_behavior_data | 单聊发送量、聊天数、新增客户、发起申请、回复率、平均回复时长、删除或拉黑客户。 |
| 客户群聚合统计 | externalcontact/groupchat/statistic | 群主维度的客户群总数、群消息总量、活跃群数、群成员数等聚合字段。 |
| 客户关系与类型 | externalcontact/batch/get_by_user | 按员工分页读取当前客户关系，只统计外部联系人类型，不保存客户资料。 |
3
指标口径明细
“可用”表示官方接口有对应字段；“近似”表示字段存在但与需求口径不完全一致；“不支持”表示企微官方当前没有对应统计字段。
| 指标 | 口径说明 | API 可用性 |
|---|---|---|
| 【口径与权限】统计口径 | 全部指标均为聚合统计数字，不读取、不保存任何单条聊天原文。 | 官方规则 |
| 【口径与权限】数据时效 | 页面统计日期为业务发生日，数据于次日采集生成；官方统计接口仅保留最近 180 天。 | 官方规则 |
| 【口径与权限】客户联系权限 | 客户联系 Secret 需配置到「客户联系 → 可调用应用」，成员需在应用可见范围内。 | 部署前置条件 |
| 【口径与权限】会话存档 | 本工具全程不调用会话存档接口，未开启、未使用。 | 未使用 |
| 负责外部客户群总数 | 截至统计日，员工作为群主的客户群总数量（官方字段 chat_total）。 | 可用｜groupchat/statistic |
| 名下客户总人数 | 员工添加的外部联系人总数，按员工分别统计后求和；同一客户被多名员工添加会重复计数。 | 可用｜batch/get_by_user |
| 微信外部联系人 | 员工添加的、external_contact.type=1（微信用户）的外部联系人数量。 | 可用｜batch/get_by_user |
| 企业微信外部联系人 | 员工添加的、external_contact.type=2（企业微信用户）的外部联系人数量。 | 可用｜batch/get_by_user |
| 员工当日在客户群发送消息条数 | 官方不提供“按发送人拆分到群”的消息数，只能拿到整个客户群的消息总量，此项无法获取。 | 企微不支持 |
| 员工当日客户单聊发送消息条数 | 员工在单聊中发送的消息总数（官方字段 message_cnt，不含群聊）。 | 可用｜get_user_behavior_data |
| 员工当日单聊聊天总数 | 员工有主动发送过消息的单聊会话总数（官方字段 chat_cnt，不含群聊）。 | 可用｜get_user_behavior_data |
| 员工当日发起好友申请数 | 员工主动向客户发起好友申请的数量（官方字段 new_apply_cnt）。 | 可用｜get_user_behavior_data |
| 员工当日新增客户数 | 员工当日新添加的外部联系人数量（官方字段 new_contact_cnt）。 | 可用｜get_user_behavior_data |
| 名下所有客户群当日总消息量 | 员工名下客户群当日的消息总数（官方字段 msg_total），无法区分发送人。 | 可用｜groupchat/statistic |
| 名下群当日新增群数 | 员工名下客户群当日新增的客户群数量（官方字段 new_chat_cnt）。 | 可用｜groupchat/statistic |
| 名下群当日新增客户 | 官方字段 new_member_cnt，口径为“客户群新增群人数”，未区分外部客户与内部成员。 | 可用，口径有近似 |
| 名下群当日流失客户（退群） | 官方群统计接口不提供退群/流失名单；如需精确退群明细只能订阅“客户群变更回调事件”，本工具未启用。 | 企微不支持（统计接口） |
| 删除/拉黑员工的客户数 | 将员工删除或加入黑名单的客户数（官方字段 negative_feedback_cnt，属单聊层面，非群退群）。 | 可用｜get_user_behavior_data |
| 客户消息回复率 | 客户主动发起单聊后，员工在一个自然日内回复过的聊天数 ÷ 客户主动发起的聊天数，不含群聊（官方字段 reply_percentage；仅确有聊天时返回，无数据不计分）。 | 可用｜get_user_behavior_data |
| 客户消息平均回复时长（分钟） | 所有聊天的首次回复总时长 ÷ 已回复的聊天总数，单位为分钟，不含群聊（官方字段 avg_reply_time；仅确有聊天时返回，无数据不计分）。 | 可用｜get_user_behavior_data |
| 群活跃数量 | 截至当日有发过消息的客户群数量（官方字段 chat_has_msg）。 | 可用｜groupchat/statistic |
| 群活跃率 | 有消息的客户群数量 ÷ 客户群总数，用官方字段计算；因无法限定“外部客户发言”，视为近似口径。 | 可用，口径有近似 |
| 群成员总数 | 截至当日客户群总人数（官方字段 member_total），含内部成员，不只外部客户。 | 可用，口径有近似 |
| 活跃群成员数 | 当日有发过消息的群成员数（官方字段 member_has_msg），无法区分内部成员与外部客户。 | 可用，口径有近似 |
| 群活跃客户数（独立外部客户发言人数） | 官方统计接口不返回该字段；member_has_msg 是成员数且未限定外部客户，不能替代。 | 企微不支持 |
| 综合活跃度评分 | 同一主部门内组内归一化后加权（满分 100）：客户群活跃 34 分（群活跃率 14、活跃群成员数 10、群消息总量 10）、主动触达 24 分（单聊发送量 14、单聊聊天总数 10）、客户服务 24 分（回复率 14、平均回复时长 10）、客户拓展 14 分（新增客户 8、发起好友申请 6），客户流失最多扣 4 分。得分 =（奖励得分 − 扣分）÷ 可用奖励权重 × 100。计数类先做 log(1+x) 压缩再 min-max，比率类线性 min-max；规模类指标不计分。 | 由本工具计算 |
4
汇总维度
汇总规则决定明细行、部门行和顶部 KPI 分别怎么算。
| 维度 | 汇总规则 | 注意事项 |
|---|---|---|
| 员工维度 | 所有行为、客户和客户群数据都先落到员工 userid，再生成员工明细行。 | 同一个员工归属多个部门时，明细中展示全部部门；评分使用主部门。 |
| 部门维度 | 评分以主部门作为横向比较范围；主部门人数不足 2 人时，使用全部可评分员工作为比较范围。 | 部门筛选只改变页面显示范围，不会重新计算评分。 |
| 评分口径 | 综合评分拆成 10 个细分指标，覆盖客户群活跃、主动触达、客户服务、客户拓展四类动作。 | 计数类指标先做 log(1+x) 压缩再组内 min-max，比率类线性归一化，避免头部大值把多数员工压到同一档。 |
| 规模不计分 | 客户总数、微信/企业微信客户数、客户群总数、群成员总数只展示不评分。 | 规模指标反映客户基数而非当日动作，参与评分会让客户多的员工天然占优，因此只保留在明细表中。 |
| 分部维度 | 优先识别员工姓名前缀，其次识别部门名称，目前包含上海、无锡、常州、盐城、淮安、连云港。 | 无法识别的员工归入“总部/其他”。 |
| 岗位大类 | 企业微信没有“客发/运营”这类岗位字段，只能按部门名称映射：规则维护在 config/role_rules.csv，未命中的部门归入“其他”。 | 看板默认只展示“客发 + 运营”，可在岗位筛选里切换到全部或单一岗位。 |
| 客户群汇总 | 客户群总数为各员工 chat_total 求和；一个群只归属一个群主，不在员工之间重复计数。 | 仅覆盖客户联系 Secret 对应应用可见范围内的群主。 |
| 客户总量汇总 | 客户总量为各员工当前客户关系数求和，按 external_contact.type 拆分微信和企业微信客户。 | 同一客户被多名员工添加会重复计数，因此不是企业级客户去重数。 |
| 群成员汇总 | 群成员总数直接汇总官方 member_total，活跃群成员数汇总 member_has_msg。 | 包含企业内部成员；同一成员加入多个群会重复计数。 |
| 顶部汇总 | 顶部 KPI 始终按整份报表汇总。 | 岗位、分部、部门、员工、备注筛选只影响下方明细表，不改变顶部 KPI。 |
5
评分维度
评分用于同层级员工的动作横向比较，不代表业绩结果。
14
群活跃率
10
活跃群成员数
10
群消息总量
14
单聊发送量
10
单聊聊天总数
14
客户消息回复率
10
平均回复时长
8
新增客户数
6
发起好友申请
4
客户流失（负向）
评分逻辑：先在同一主部门内做组内归一化。奖励类计数指标（群消息总量、活跃群成员数、单聊发送量、单聊聊天总数、新增客户、发起好友申请）先做 log(1+x) 压缩再 min-max；奖励类比率指标（群活跃率、客户消息回复率）直接线性 min-max；平均回复时长做反向归一化；客户流失为扣分项，按组内最大流失等比扣分。最终得分 =（奖励得分合计 − 扣分）÷ 可用奖励权重合计 × 100，最低 0 分、上限 100 分。无回复数据的员工只跳过缺失指标，不把缺失值直接当 0 分。
| 评分指标 | 评分维度 | 权重 | 方向 | 计算依据 |
|---|---|---|---|---|
| 群活跃率 | 客户群活跃 | 14 分 | 越高越好 | group_active_rate（群活跃数量 ÷ 客户群总数） 名下客户群中当日有消息的群占比，衡量群的整体活跃面，官方聚合值，不含聊天内容。 |
| 活跃群成员数 | 客户群活跃 | 10 分 | 越高越好 | group_member_active_total 名下客户群当日有发言的群成员数（官方 member_has_msg），含企业内部成员。 |
| 群消息总量 | 客户群活跃 | 10 分 | 越高越好 | group_message_total 员工名下客户群当日消息总量，官方不拆分发送成员，作为群内互动强度代理。 |
| 单聊发送量 | 主动触达 | 14 分 | 越高越好 | employee_single_message_cnt 员工在客户单聊中发送的消息总数，反映主动触达强度。 |
| 单聊聊天总数 | 主动触达 | 10 分 | 越高越好 | employee_single_chat_cnt 员工与客户发生单聊的会话数，反映主动触达频次。 |
| 客户消息回复率 | 客户服务 | 14 分 | 越高越好 | reply_percentage 员工收到客户消息后当日作出回复的会话占比；无有效聊天数据时该指标不计分。 |
| 平均回复时长 | 客户服务 | 10 分 | 越低越好 | avg_reply_time_minutes 客户发消息到员工回复的平均间隔，越短越好；无有效聊天数据时不计分。 |
| 新增客户数 | 客户拓展 | 8 分 | 越高越好 | new_contact_cnt 当日成功添加的外部客户数。 |
| 发起好友申请 | 客户拓展 | 6 分 | 越高越好 | new_apply_cnt 员工当日主动发起的好友申请数，体现主动拓客动作。 |
| 客户流失（负向） | 客户拓展 | 4 分 | 越低越好（扣分项） | loss_contact_cnt 当日删除或拉黑员工的客户数，越多扣分越多；不含客户群退群。 |
参与评分
已配置客户联系功能、账号状态正常、且未被休假/排除规则命中的员工。
比较范围
默认按主部门比较；主部门人数不足 2 人时，使用全部可评分员工比较，避免单人部门被强行固定为满分或低分。
细分粒度
评分共 10 个细分指标、四大维度：客户群活跃 34 分、主动触达 24 分、客户服务 24 分、客户拓展 14 分，另设客户流失最多扣 4 分，奖励权重合计 96 分。组内指标完全一致时视为无差异，越低越好的指标记满分，计数指标全为 0 则不计分。
规模不计分
客户总数、微信/企业微信客户数、客户群总数、群成员总数只展示不评分，避免客户基数差异影响公平。
不计分情况
未配置客户联系功能、账号禁用/未激活/退出企业、或配置了排除备注的员工，评分留空。
6
企微官方当前不支持的指标
以下内容不会用推测值填充，页面中留空或明确标注为不支持。
| 需求指标 | 不支持原因 |
|---|---|
| 员工本人在客户群发送消息条数 | 官方群统计只提供整个客户群的消息总量，不按发送成员拆分。 |
| 名下客户群当日流失客户（退群） | 群统计接口没有退群或流失字段；精确退群明细需要客户群变更回调，本工具未启用。 |
| 群活跃客户数（独立外部客户发言人数） | 官方只提供 member_has_msg 活跃成员数，不区分内部成员与外部客户，也不能作为独立客户数。 |
| 聊天原文 | 本工具未开启会话存档，官方聚合统计接口也不返回任何聊天内容。 |
7
使用边界与对账说明
| 主题 | 说明 |
|---|---|
| 与企微后台总览的差异 | 后台的“已服务外部联系人”“企业全部客户数”“客户群管理总览”属于管理后台口径，本看板是开放 API 当前可拉取范围内的员工聚合口径，不应直接要求数字完全相等。 |
| 应用可见范围 | 客户联系 Secret 对应应用只能读取其可见范围内成员的数据。要覆盖全部客户联系成员和群主，需要先在企微后台扩大应用可见范围。 |
| T+1 时间口径 | 页面统计日期是业务发生日。例如 2026-10-12 的数据在 2026-10-13 采集生成，不包含采集当天尚未结束的数据。 |
| 活跃度不等于业绩 | 评分只反映客户维护动作数量和响应情况，不代表成交、收入或其他业绩结果。 |
| 休假与排除员工 | 被排除员工仍显示在明细中，但不参与评分，也不影响其他员工的归一化范围。 |