# wecom.html · 企微消息预览

## 用途与角色

给客户展示「员工手机上实际收到什么」：企微应用消息卡片样式、推送分级、频控与深链。评审用页面，正式系统中不是独立功能页（消息本身在企微客户端里）。**M2 上线推送**。

## 区块

| 区块 | 内容 |
|---|---|
| 手机样机 | 六类消息卡片示意：P0 立即 / 哨兵催办 / 物料缺口立即 / 晨报 / 待签（按岗位定向）/ 当日汇总 |
| 通道架构卡 | 规则引擎＋哨兵 → 工作台消息网关（唯一持凭据）→ 企微 API → 员工手机 → 深链回 HUB |
| 推送分级表 | 立即 / 当日汇总 / 周报（映射规格书第 8 节通知矩阵） |
| 频控卡 | 24h 限 1、合并、夜间免打扰、必带动作深链 |

## 行为契约

1. **唯一出口**：所有业务消息经工作台消息网关发送（`POST /internal/messages/send`，HMAC）；业务后台与其他系统不持企微凭据。
2. **深链**：卡片点击 → 企微内打开工作台（OAuth 免登录）→ 定位到 HUB 对应任务/单据（`/hub?task=` / `/issue/{sf}`）。
3. **分级**：立即级单发红卡 @责任人；当日级 18:00 合并汇总；周报级不单独推送。
4. **频控**：同人同单催办 24h 限 1 次（哨兵记忆）；P2 夜间 22:00–7:00 不出推送。
5. **M2 后期（回调）**：员工回复消息给应用 → 工作台回调接收 → 智能体应答（查单据/查知识）→ 回复即响应。

## 接口草案（tigo-workbench 侧）

- `POST /internal/messages/send {to_userid, level, card_type, deep_link, body}`
- `GET /channels/wecom/callback`（M2 后期，URL 验证＋消息接收）

## 权限

- 推送对象由通知矩阵按岗位路由；「待降级签字」类消息仅经理收得到。

## 验收要点

- 造一条逾期数据：15 分钟内规则触发、企微收到红卡、点击直达 HUB 任务（全链路演示）。
- 同一单 24h 内第二次催办被频控拦截（日志可见）。
- 夜间 P2 提醒不推送、次日并入汇总。