新建数据采集器
工作原理
后台的 数据采集器 页面(位于"平台管理"分组下)列出当前所有采集器。每个采集器有:
- 采集器类型:当前仅支持「企业微信会话存档」
- 状态:运行中 / 同步中 / 异常
- 上次同步:最后一次成功拉取的时间
点击进入详情页有四个 Tab:
| Tab | 内容 |
|---|---|
| 配置信息 | 采集器的基本参数(凭证已加密保存,显示为 ●●●●●●) |
| 运行记录 | 每次同步的时间、触发方式(手动/定时)、状态、拉取消息数、新增群、新增成员、耗时 |
| 群聊列表 | 已同步的全部群名称 + 群会话 ID + 最近更新时间 |
| 用户列表 | 已同步的全部成员姓名 + 用户 ID + 最近更新时间 |
新建一个企业微信会话存档采集器
需要分别拿到两套凭证——一个用于拉消息,一个用于拿群名/通讯录信息:

基本信息
取一个易识别的采集器名称(如"销售客户群存档")+ 可选描述。
会话存档凭证(拉消息用)
在企业微信管理后台 → 我的企业 → 企业信息 拿到「企业 ID(CorpID)」;
在 管理工具 → 会话内容存档 拿到「会话存档 Secret」、配置公钥后获得「公钥版本号」和你保管的「RSA 私钥」。
这套凭证只能解密拉到的会话内容,不能查群名和成员姓名。
群聊与用户信息凭证(自建应用 Secret,选填但强烈建议填)
在企业微信新建一个自建应用 → 应用详情页拿 Secret → 在「客户与上下游 → 客户联系 → API」中将该应用授权。
这个 Secret 用来获取「外部客户群的群名称、群主、成员列表」和「企业通讯录」。
若不填,解析消息时只能拿到群 ID 和用户 ID(一串数字),无法显示群名和姓名。
同步计划
企业微信会话存档为「全量拉取」——首次同步会自动落库全部外部客户群 ID + 群名称 + 通讯录成员。后续按系统默认计划增量同步。
i
为什么要两套凭证:企业微信把"会话内容"和"通讯录信息"放在不同的 API 上,权限模型分离。会话存档 Secret 是企业级专用密钥,独立于普通应用 Secret。少了任何一个都用不全。
