系统概览

架构说明、配置信息、部署指南与运行状态

网关心跳监测

加载中...

系统架构图

企业微信
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 调用。