消息状态生命周期是 SMS 在网关中只能向前移动的序列:排队中、已发送,随后为已送达、失败或已过期;发送前被拒绝则为已拒绝。
消息被接受并计价后即处于“排队中”,并可能在这一状态下等待发送时间、发送时段,或在限速的群发任务中等待轮到它。消息交给运营商时变为“已发送”,这就是计费点。之后,它会进入一个最终状态:收到手机回执时为“已送达”,运营商无法送达时为“失败”,有效期耗尽时为“已过期”。第六种状态是“已拒绝”,适用于在任何发送尝试之前就被拒绝的消息,这类消息绝不计费。
| 状态 | 含义 | 是否计费 |
|---|---|---|
| 排队中(queued) | 已接受并计价,正在等待发送时间、发送时段或轮到它发送 | 暂未计费 |
| 已发送(sent) | 已交给运营商 | 是,在此时计费 |
| 已送达(delivered) | 手机已确认收到 | 已在发送时计费 |
| 失败(failed) | 运营商无法送达;附有原因 | 是,因为已经发送 |
| 已过期(expired) | 在送达前有效期已结束 | 是,因为已经发送 |
| 已拒绝(rejected) | 发送前被拒绝 | 绝不计费 |
状态只能向前推进。由于 Webhook 事件可能迟到、被重试或被重放,较早的状态绝不能覆盖较晚的状态;因此,处理程序应按状态等级而不是到达时间来应用事件:最终状态高于“已发送”,“已发送”高于“排队中”。假设一条提醒在 08:59 创建,而发送时段 09:00 才开始,它会先处于“排队中”,09:00:01 变为“已发送”,09:00:05 变为“已送达”。如果“已送达”事件先到达你的端点,随后才到一个重试的“已发送”事件,记录必须保持为“已送达”。
常见的误读有两种:
- 把“已发送”当作最终结果。只有在只提供运营商确认、不返回手机回执的国家,它才是最终状态。
- 把“已拒绝”算作送达失败。消息根本没有发送,因此不会计费,问题要从输入数据上解决;请参阅失败与拒绝。
在 SMSMeteor:六种状态分别是排队中(queued)、已发送(sent)、已送达(delivered)、失败(failed)、已过期(expired)和已拒绝(rejected);测试密钥还会返回第七种状态,即测试(test),用于已经过验证和计价、但从未发送或计费的消息。每次状态变化后都会发送经过签名的 Webhook 事件:message.sent、message.delivered、message.failed、message.expired 和 message.rejected。API 参考对每种状态都有定义。
相关术语
深入了解
在实践中了解这个术语。一个电子邮箱地址即可开户,费率公开,支持加密货币付款,测试密钥免费。
开始发送
