• 覆盖 228 个目的地
  • 始终无需 KYC
  • 支持 Bitcoin、Monero、USDT 等 7 种币种

送达与报告

消息状态生命周期

消息状态生命周期是 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 参考对每种状态都有定义。

深入了解

在实践中了解这个术语。一个电子邮箱地址即可开户,费率公开,支持加密货币付款,测试密钥免费。
开始发送