指南

实际到底怎么运作

消息系统里那些容易在细节上搞错的部分:什么是段、速率限制究竟落在哪、为什么「已接受」不等于「已送达」。内容取自平台的真实行为,而不是听起来漂亮的说法。

4 分钟

自带服务商账号

平台自己没有服务商账号。就是这一个设计决定,改变了号码归谁、配额在谁手里、账单上写谁的名字。

阅读指南 →
5 分钟

短信分段,以及你实际付的是什么钱

短信按分段计费,而不是按条。文字能否装进一段,取决于所需字符集,也取决于你在连接上设置的编码。

阅读指南 →
7 分钟

退订处理

退订由两半组成:抑制记录,以及营销消息交给服务商之前的检查。两者都经过同一套归一化,而这恰恰是最常出问题的地方。

阅读指南 →
5 分钟

解读送达回执

回执是一串状态,不是最终判决。把中间态当成终态,是发送看板最常见的「说谎」方式。

阅读指南 →
5 分钟

限速、配额,以及我们为什么要排队

每个连接都有发送速率。平台按该速率排队,而不是以服务商能接受的最快速度猛发,因为触发限流的最快方式就是按触发限流的速度发送。

阅读指南 →
4 分钟

路由与故障转移

路由按优先级排序,并在连接内按权重分配。这样设计的目的,是让服务商拒收降级为「发得慢一点」,而不是彻底没声音。

阅读指南 →
4 分钟

由谁判定一条消息是否属于营销

平台要求你声明消息类型,而不是从文本里推断。正是这个字段决定退订闸门是否生效,而声明是否如实由你负责。

阅读指南 →
4 分钟

超时不等于失败

发送是异步受理,且没有去重键。对不确定的请求发起重试,就会再发一条消息并再计一次费。

阅读指南 →
4 分钟

两个看起来一样、其实不同的端点

投递回执与上行回复是两个不同端点,在服务商控制台的不同位置配置。只配了回执 URL,退订处理就会悄悄失效,而且任何地方都不报错。

阅读指南 →
3 分钟

取回号码

已退订的收件人可以重新订阅。平台停用抑制记录而不是删除,因此同意记录得以保留。

阅读指南 →
4 分钟

回调地址不可用时会发生什么

终态会推送到你配置的 URL,并带有次数有限的少量重试。你的处理程序必须容忍重复,也不要指望每条消息都会回调一次。

阅读指南 →
3 分钟

你刚撞上的是哪道限流

一次发送前面有两道限流:套餐设定的那道,以及网络边缘高得多的一道。两者返回相同的状态码,只能靠消息正文区分。

阅读指南 →
3 分钟

收件人实际看到的是谁

不指定发送方时,平台会从承载该消息的连接里选一个;显式指定则始终优先。

阅读指南 →
3 分钟

平台不保留什么

消息正文不做归档,保留的是元数据;其中两个字段是承重字段,缺了它们账单就无法对账。

阅读指南 →
范围。 这些指南把短信渠道从第一次连接一路讲到生产上线。邮件与 WhatsApp 采用同样的连接模型 —— 选服务商、关联自己的账户、从控制台发送。