トラッキング
メッセージステータスと配信レポート
| status | 意味 | 最終 | 課金済み |
|---|---|---|---|
| scheduled | send_atを待機中 | No | はい、キャンセル時返金 |
| queued | 受理され、次のキュー通過（2秒ごと）を待機中です。 | 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}をポーリング可（レート制限に余裕あり）