能力路线图

这一页把 Whaleal SMS 的能力分成两块：现在已经能用的，和规划中、正在实现的。

说明：路线图可能随实际情况调整，以控制台里实际可用的功能为准。本页标注为「规划中」的能力，控制台对应入口会显示「规划中」徽标且不可点击 —— 也就是说，看到徽标就说明还没开放，不要按已上线做方案。

已上线：核心闭环

下面这些是当前直接可用的能力（细节见对应章节）：

能力	说明	详见
BYOL 渠道管理	录入多家 CPaaS 凭据、绑定 Sender、设 priority / weight	接入方式
API 密钥与路由链	签发 `sk_` 密钥、按密钥绑定渠道子集、路由链可视化	接入方式
聚合路由与容灾	权重相等 → 顺序主备；权重不等 → 平滑加权轮询，失败自动切换	平台总览
开放 API 发信	`POST /open/v1/sms/send`，含编码口径与计费条数回传	开放 API
回执归集与状态回调	供应商回执归一，终态推送到你的系统	状态回调
控制台发送	单发 / 批量群发 / 定时发送，发送前预估计费条数	控制台指南
消息日志与报表	全渠道日志检索、导出、渠道表现对比	控制台指南
套餐与计费	四档订阅、租户级 QPS、用量自查	套餐与配额

是什么：用户回复的短信（MO / Inbound）进入平台，形成双向会话。控制台的收件箱页对应这个能力。

解决什么问题：验证码场景用不到，但客服、退订关键词（STOP）、互动营销必须要。现在的通行做法是各厂商各自推一条 webhook，字段格式还都不一样，统一起来很烦。

预期形态：各厂商的上行消息由平台归一成统一结构，在收件箱里集中查看，并可由平台转发到你的系统。

现在就需要入站能力怎么办？ SDK 里这已经是一等能力了 —— 用 SmsWebhookHandler.parseInbound 解析各厂商的上行载荷，回调地址接你自己的服务即可，见入站（Inbound）。等平台的收件箱开放后可以平滑切过来。

是什么：把「触发条件 → 动作」的短信流程做成可配置的规则，而不是每次写代码。

解决什么问题：典型的如「用户下单后 30 分钟未支付 → 发提醒」「连续两次发送失败 → 换渠道重发并通知值班」。这类逻辑写在业务代码里，改一次要发一次版。

预期形态：控制台的自动化页，用规则配置替代这部分代码。

是什么：在现有的权重与 priority 之外，增加按号码归属地或用途的确定性路由。

解决什么问题：现在「哪条渠道走哪个地区」需要靠签发不同 API Key 来表达。有了静态路由规则后，可以按国家码直接分流，比如「+86 走国内通道，其余走国际通道」。

是什么：把一个租户拆成多个子账号，各自只能看到自己范围内的渠道、密钥与日志。

解决什么问题：多业务线共用平台时，现在是靠「按业务签发不同 API Key」做到调用侧隔离；子账号把控制台侧的可见范围也隔离开，适合集团 / 多团队场景。

有些改动客户看不见，但直接决定「敢不敢把主链路放上来」，所以也列在这里：