企业微信实时推送与事件监控

实时推送可在企业微信页面直接显示传入的 Webhook 事件，无需手动刷新。

打开实时推送

1. 在侧边栏打开 企业微信。
2. 页面顶部出现 实时推送 面板。
3. 连接状态以标签显示：
   • 🟢 已连接 — 正在接收事件
   • 🔴 已断开 — 无连接，自动重连中

筛选事件

实时推送面板提供事件类型下拉菜单。选择：

• 全部 — 显示所有传入事件
• 特定类型（如 text_message、event）— 仅显示匹配事件

选项根据已接收的事件自动填充。

自动重连

若连接中断（如网络问题），推送将在 5 秒后自动重连，标签实时反映当前状态。

事件表格（历史记录）

实时推送下方的表格显示数据库中最近 30 条事件。点击行或 XML 按钮，可在侧面板查看完整 XML。

测试连接

从企业微信控制台发送测试事件：

1. 打开您的企业微信应用配置。
2. 使用"验证"功能或发送测试消息。
3. 观察实时推送面板——事件应在数秒内出现。

若无事件出现：

• 检查连接标签（必须为绿色）。
• 确认回调 URL 配置正确（参见 设置企业微信回调）。
• 检查 IP 白名单（参见 企业微信 IP 白名单设置）。

技术说明

实时推送使用 服务器发送事件（SSE），通过 GET /api/wecom/events/stream 实现。服务器在连接建立时推送最近 10 条历史事件，之后每 5 秒检查新事件，浏览器保持连接——无需轮询。