安装向导
按顺序完成以下步骤。每一步都会自动检测,完成后显示绿色对勾。
前提条件 开始前请先阅读
配置前请先了解方案原理和需要准备的条件,详见 《外部群会话存档接入指南》↗
开通会话内容存档 需管理员在企业微信后台操作
登录企业微信管理后台 work.weixin.qq.com → 管理工具 → 会话内容存档 → 开通,选择版本、设置开启范围(对接客户的员工)、签署开通确认函。审核最长 3 个工作日,期间可以继续完成下面的步骤。
上传消息加密公钥
后台路径:会话内容存档 → 基础存档配置 → 消息加密公钥 → 设置。复制下面的全部内容粘贴进去并保存。
加载中…
设置可信域名
后台路径:应用管理 → 会话内容存档 → 开发者接口 → 可信域名,填写域名:
-
后台会提示下载一个 WW_verify_xxxx.txt 校验文件,下载后在这里上传,然后回后台点击「验证」。
后台会提示下载一个 WW_verify_xxxx.txt 校验文件。本服务器的网站由现有建站程序提供,请把该文件原样放到上面域名对应网站的根目录(与首页 index 文件同一目录;宝塔面板可在「网站 → 根目录」中上传),确认浏览器能打开 - 后,回后台点击「验证」。
设置可信 IP(两处)
把下面这个服务器 IP 分别填到后台两个位置:
-
① 应用管理 → 会话内容存档 → 开发者接口 → 企业可信IP
② 管理工具 → 会话内容存档 → 基础存档配置 → 可信IP地址
填写企业 ID 与 Secret
连接测试
以上步骤完成且后台审核通过后,点击测试。测试通过后系统会自动开始持续拉取消息。
选择要保存的群,并接入 WorkBuddy
有消息进来后,到「群管理」选择需要保存的群;然后到「接入 WorkBuddy」复制配置。
群管理
企业微信会推送开启范围内员工参与的所有会话,这里决定哪些会话保存到数据库。群名可以设置备注,方便在 WorkBuddy 里用名字查询。
| 保存 | 群名称 | 备注名 | 最近一条 | 已保存 | 最近消息 | |
|---|---|---|---|---|---|---|
| 加载中… | ||||||
聊天记录
查看已保存的全部消息,可按条件筛选、导出 Excel。图片可直接预览,文件、语音、视频可下载(需先在「设置」上传 SDK;超过企业微信约 5 天保存期、且之前没下载过的文件无法再下载)。
| 时间 | 群 | 发送人 | 内容 |
|---|---|---|---|
| 点「查询」查看聊天记录 | |||
运行状态
每 60 秒自动从企业微信拉取一次新消息。
掉线告警(推荐)
在任一企业微信内部群添加「群机器人」,把 Webhook 地址填在这里。拉取服务停止超过 15 分钟,或超过 1 小时没有同步成功时,会向该群发送告警。
接入 WorkBuddy
每台需要使用的电脑都按下面三步操作一次。
第 1 步 打开 WorkBuddy → 连接器 → 自定义连接器 → 配置 MCP,把下面的配置合并到 mcpServers 中(已有其他服务时,只添加 "wecom-archive" 这一段):
第 2 步 保存后,在自定义连接器列表中找到 wecom-archive,点击 「信任」 并启用。
第 3 步 在 WorkBuddy 对话中试一试:
帮我看看最近 12 小时各个客户群都在聊什么 XX 客户群今天有没有人提到报价? 把上周 XX 群里客户提出的问题整理成表格
修改管理员密码
媒体文件下载(可选)
如果需要在 WorkBuddy 中获取聊天里的图片、文件、语音、视频,需要上传企业微信官方「会话内容存档 SDK」的 Linux 版本。可从企业微信开发者中心下载(文档标题「会话内容存档 / 获取会话内容」中的 SDK 下载链接),直接上传压缩包即可。
当前状态:-