系统概览
架构说明、配置信息、部署指南与运行状态
网关心跳监测
加载中...
系统架构图
企业微信
1. 推送回调通知云端服务本系统
2. 存储回调
本地网关你的服务器
3. 轮询拉取回调4. SDK解密消息5. 获取群主
提交解密消息
含群主信息
云端处理业务
抽取/报价/PDF
返回回复内容
含sender
本地发送群消息
add_msg_template
云端服务职责
- 接收企微回调通知并存储
- 提供轮询接口供本地网关拉取
- 信息抽取(正则规则引擎)
- 保险系统报价计算
- PDF 报价单生成
- 报价记录存储与查询
- 管理后台 Dashboard
本地网关职责
- 接收企微会话存档回调
- 调用 C SDK 拉取会话消息
- RSA + AES 双层解密消息
- 获取群主信息(群主IP固定)
- 提交解密结果到云端
- 发送群消息(add_msg_template)
- 向云端注册 + 心跳保活
关键设计决策
为什么群主获取放在本地网关?
云端服务部署在弹性环境,IP 不固定。企微 API 需要 IP 白名单,本地网关部署在固定 IP 的服务器上, 只需将本地 IP 加入白名单即可。本地获取群主后随消息一起提交云端,云端无需调用企微 API。
为什么用轮询而不是回调?
企微会话存档 SDK 只能在本地调用(C 动态库),云端无法直接访问。本地网关轮询云端获取回调通知, 然后通过 SDK 拉取消息,实现了「云端调度 + 本地执行」的架构。
多员工支持
本地网关自动通过企微 API 获取每个群的群主(owner),无需手动配置群主映射。 一个网关可服务多个员工、多个群。群主信息有 5 分钟本地缓存,减少 API 调用。