跟踪
短信状态和送达报告
| status | 含义 | 最终状态 | 已扣费 |
|---|---|---|---|
| scheduled | 等待 send_at 时间 | No | 是的，取消后退款 |
| queued | 已接收，等待下一次队列处理（每两秒一次） | No | Yes |
| sent | 已提交至运营商网络，等待送达报告 | No | Yes |
| delivered | 终端设备确认已送达 | Yes | Yes |
| failed | 无法送达，错误信息说明原因 | Yes | 否，已退款 |
| canceled | 其所属的定时批次已被取消 | Yes | 否，已退款 |
短信上的错误代码
| error.code | 含义 |
|---|---|
| network_error | 消息无法提交至运营商网络，费用已退回余额 |
| undeliverable | 运营商网络反馈无法联系到终端设备 |
| canceled | 定时批次在开始前已被取消 |
退款
当消息发送失败时，其全额费用会在同一处理流程中退回余额，并在账本中生成标注批次的退款记录。批次字段 refunded 显示累计退款金额
Webhook 或轮询
Webhook 是快速通道：每条消息达到最终状态时会立即调用您的接口。对于小规模发送或二次确认，可通过轮询 GET /v1/messages/{id} 或 GET /v1/batches/{id} 获取状态，速率限制已为两种方式预留空间