追蹤
訊息狀態和送達報告
| 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 顯示累計退款金額
Webhooks 或輪詢
Webhooks 是快速途徑：每個最終狀態都會在設定後呼叫你的端點。對於少量訊息或雙重檢查，可輪詢 GET /v1/messages/{id} 或 GET /v1/batches/{id}；速率限制已預留空間