消息网关与通道接入 — 总览
本目录沉淀消息网关和后续触达通道接入需求。目标是让 BNS、FCS、CRS、运营后台等上游系统不直接感知短信、语音外呼、WhatsApp、Push 等通道和供应商差异，由消息网关统一完成通道路由、发送、回执、失败降级和基础追踪。
文档定位
| 文档 | 作用 |
|---|
| 01-消息网关一期需求 | 主文档，覆盖一期 PRD、系统框架、标准通道能力、统一调用模型、短信通道迁移、同类型通道路由、AI 语音外呼接入、Push 框架预留、供应商接入规范、回执和查询 |
| 02-短信通道迁移与接入需求 | 一期短信网关接入需求，覆盖原 CRS 短信能力迁移、首家短信通道接入、模板、回执、路由和验收 |
| 03-AI语音外呼供应商接入需求 | 首家语音外呼供应商接入需求，覆盖鉴权、名单导入、取消外呼、实时回调、结果映射和联调验收 |
| 04-Firebase Push通道接入需求 | Push 通道接入需求，参考 AF/Firebase 文档中的 FCM token、通知权限、payload、点击跳转和验收要求，补齐消息网关侧服务端发送与状态管理 |
| 05-后台管理页面原型说明 | 后台管理原型说明，覆盖消息网关菜单、模板配置、短信路由、语音模板、发送记录和手动发送 mock；生产一期以配置、查询、追踪和重试为准 |
建设原则
- 上游系统只表达业务意图和消息内容，不直接选择供应商接口、签名、认证方式和回执解析规则。
- 消息网关统一屏蔽通道差异，对外提供稳定的发送单、状态、回执和失败原因。
- 一期先支撑高频刚需场景：登录 / 交易短信、还款提醒、接入一家短信通道和一家 AI 语音外呼供应商。
- 通道能力按插件化接入，后续新增供应商不要求 BNS、FCS 等上游系统改造业务流程。
- 所有供应商都按“通道类型 + 供应商适配器 + 场景路由配置 + 标准状态映射”的方式接入，供应商差异只留在消息网关内部。
- Push 是 App 设备通道，不是单纯按手机号触达；当前 App 的服务端就是 BNS，用户 / 设备主关系由 BNS 维护，不单独建设 App 后端或设备中心。消息网关维护 Push token 发送镜像，并基于 FCM token、通知权限、App 安装状态和用户设备关系判断可达性。客户端 FCM SDK 接入仍以 AF/Firebase 接入文档为准。
- 路由分期：一期只启用同类型通道路由，例如短信供应商之间、语音供应商之间的主备选择；不同类型通道的自动路由和降级，例如语音失败后自动短信 / WhatsApp，作为二期能力。底层框架和配置模型一期先预留。
- 不在一期建设完整营销自动化平台，不做复杂人群圈选、拖拽式旅程编排、A/B 实验和多层智能策略。
一期能力边界
| 能力 | 一期 | 后续 |
|---|
| 统一发送接口 | 支持 | 扩展批量、定时、优先级队列 |
| 短信通道 | 接入 1 家短信通道，承接原 CRS 短信能力迁移 | 多短信供应商主备、权重和动态路由 |
| 语音外呼 | 接入 1 家 AI 外呼供应商，支持还款提醒场景 | 扩展多供应商、催收、营销、OTP 语音 |
| 同类型通道路由 | 支持短信同类型路由框架，语音同类型路由框架预留 | 按成本、成功率、号段、线路质量动态权重 |
| 跨类型通道路由 | 一期只做框架、配置和状态预留，不启用生产自动降级 | 语音未接通后自动短信 / WhatsApp、多步骤触达策略 |
| WhatsApp | 预留通道类型和模板能力 | 正式供应商接入、富媒体、会话消息、模板审批 |
| Push | 纳入通道框架，先对齐 FCM token、权限状态、payload 和服务端发送需求；是否一期上线发送按 App 侧 FCM 完成度决定 | 参与跨类型路由、召回触达、低成本运营通知和多设备触达 |
| 回执追踪 | 支持发送单和通道回执 | 扩展转化归因和内容效果分析 |
| 模板管理 | 支持配置化模板编码和变量 | 扩展多语言、多版本、审核流 |
| 运营后台 | 支持最小配置和查询 | 扩展完整通道看板和策略配置 |