追蹤
訊息狀態與遞送報告
| 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}；速率限制為兩者都留有空間。