简化版 · OVERVIEW
WorkBuddy × 企业微信
外部群会话存档接入指南
基于企业微信官方「会话内容存档」能力，在企业自有服务器上建设合规的数据通道，让 WorkBuddy 能检索、整理、分析客户群（外部群）聊天记录。
01为什么需要
WorkBuddy 内置的企业微信通道只能访问内部单聊与内部群，无法读取有客户在的外部群。而客户群恰恰承载着需求、报价、反馈等最关键的业务沟通。本方案通过企业微信官方通道补齐这一数据缺口。
02基本原理
图 1 · 整体架构与数据流向：企业微信云端加密存档 → 企业服务器拉取、解密、落库 → WorkBuddy 按需查询
1官方授权管理员开通「会话内容存档」，员工与客户同意后，会话由企业微信云端留存。
2加密下发云端用企业上传的公钥加密消息，只允许白名单服务器拉取。
3本地解密存储企业服务器用自持的私钥解密，存入自有数据库，密钥与数据不出企业。
4按需查询通过 MCP 连接器把查询结果提供给 WorkBuddy，用于检索与报告。
03实施前准备
| 项目 | 要求 |
|---|
| 管理员权限 | 企业微信超级管理员，或有「会话内容存档」管理权限的管理员 |
| 企业认证 | 企业微信主体已完成认证 |
| 备案域名 | 一个已完成 ICP 备案的域名，备案主体须与企业微信认证主体一致 |
| 云服务器 | Linux，带固定公网 IP，2 核 2 GB 即可 |
| 存档费用 | 按存档人数按年计费，参考价：服务版 900 元/人/年（5 人起购），企业版 1800 元/人/年（含通话录音）。以企业微信官方报价为准，开通后有免费体验期 |
重要只记录开通生效之后的消息，历史消息无法回溯；云端只保留约 5 天，审核通过后应尽快部署并开始持续拉取。
04实施步骤
阶段一：企业微信后台配置 企业管理员
1
开通会话内容存档
在「管理工具 → 会话内容存档」开通，选择版本，把对接客户的员工（销售、客服等）加入开启范围，签署确认函。审核最长 3 个工作日。2
上传消息加密公钥
由服务器生成一对密钥，把其中的公钥粘贴到存档配置页面；私钥只留在服务器上。3
获取企业 ID 与存档 Secret
Secret 是存档专用的凭据，与普通应用的 Secret 不能混用。4
配置可信域名
填写已备案域名，并在服务器上放置企业微信提供的校验文件，完成域名归属验证。5
配置可信 IP（两处）
把服务器的固定公网 IP 分别填入「应用的企业可信 IP」和「存档配置的可信 IP 地址」，两处都要填。阶段二：数据服务部署 技术实施人员
6
部署拉取服务
在服务器上部署常驻服务：每 60 秒自动拉取新消息、解密、写入数据库，断点续拉、不重不漏，开机自启、异常自动恢复。7
启用媒体下载可选
图片、文件、语音、视频需通过企业微信官方 SDK 下载，放到服务器上即可使用。阶段三：接入 WorkBuddy 技术实施人员 / 业务使用者
8
配置 MCP 连接器
在 WorkBuddy「连接器 → 自定义连接器」中添加配置，并点击「信任」启用。之后即可用自然语言查询，例如「最近 12 小时各客户群都在聊什么」。9
按需设置定时报告可选
用 WorkBuddy 定时任务每天或每周自动生成客户群动态报告。上线标志在外部群发一条测试消息，2 分钟内能在 WorkBuddy 中查到。
05能获取哪些数据
| 场景 | 是否可获取 | 说明 |
|---|
| 客户群（含外部联系人的群） | ✅ 有条件 | 群内有开启范围内的员工，且客户已点击「同意存档」 |
| 内部群 / 内部单聊 | ✅ 可以 | 会话中有开启范围内的员工 |
| 开通之前的历史消息 | ❌ 不可以 | 只从生效时刻开始记录 |
| 语音 / 视频通话内容 | ❌ 服务版不含 | 需要企业版 |
06运维与合规要点
- 保持服务在线：云端只保留约 5 天，服务中断超过 5 天会永久丢失数据，需配置掉线告警。
- 固定出口 IP：更换服务器或 IP 时，同步更新后台两处可信 IP。
- 保管好私钥：私钥是解密数据的唯一凭据，严禁外传并离线备份。丢失后对应数据无法解密。
- 客户同意：客户在微信端同意存档后才能获取其消息，这是官方合规机制，不可绕过。
- 员工告知：开启范围内的员工会收到存档提示，建议提前做内部沟通并写入员工制度。
- 数据使用：仅用于企业内部客户服务与业务分析，按最小必要原则分配访问权限，并确定留存期限。