IOSOR ガイド
本番運用前のタイムゾーン配信スケジューリングとウォレット保留の検証
IOSORコンソールで本番トラフィックを開始する前に、SMSスケジュール配信、E.164タイムゾーンオフセット、およびプリペイドウォレットの資金保留を検証します。
本番運用前のタイムゾーン配信スケジューリングとウォレット保留の検証。
タイムゾーンオフセットとスケジューリングキューの配信マッピング
スケジュールSMS配信を実行する前に、テナントプラットフォームは送信先の E.164 形式電話番号を現地タイムゾーンに正確にマッピングする必要があります。IOSORプラットフォームは、UTCを基準とした Unix エポックタイムスタンプに基づいてメッセージを配信します。OTPやプロモーション通知をスケジューリングする場合、クライアントシステムは実際の配信前にペイロードをキューに登録します。プラットフォームは国コードを確認し、タイムゾーンのオフセット調整を適用した上で、ネットワークスロットを確保する前にペイロード形式を検証します。
高トラフィック環境で正確な時間を維持するためには、標準時間だけでなく夏時間のシフトにも動的に対応できる設計が必要です。クライアントシステムがローカル時間をUTCに適切に変換せずに送信した場合、受信者にとって不適切な時間帯にメッセージが届くリスクが生じます。IOSORのインフラストラクチャは、すべてのスケジュールリクエストを統一されたUTCタイムスタンプに正規化し、ターゲットE.164の地域パラメータを自動検証します。
スケジュール配信のホールド機能と台帳ロックのテスト
スケジュールされたトラフィックは、ウォレットの残高予約アーキテクチャと直接連携します。配信タスクが将来の実行のためにキューに登録されると、IOSORはウォレット台帳上に一時的なプリペイドホールド(資金保留)を設定します。これにより、実際の送信試行が行われるまで資金を確定消費することなく確保できます。残高変動によるスケジュールキューの脱落を防ぐため、テナント口座全体で最低 USD 20 のプリペイド残高を維持することを推奨します。
マルチテナント運用において、この資金ホールドのライフサイクルを理解することは非常に重要です。スケジュールされたメッセージが実行前に手動でキャンセルされた場合や、配信準備段階で番号検証エラーが発生した場合、システムは即座にホールドを解除し、利用可能残高に返金します。利用可能残高が停止ラインを下回った場合、新規のスケジュール登録は拒否されますが、既に資金がホールドされている既存のキューは計画通り実行されます。
WebhookコールバックとDLRステータス検証
スケジュール配信の検証には、Webhookコールバックの厳密な監査が必要です。タスクがキューに登録されると、IOSORはWebhook経由で schedule-created イベントを発行します。設定された Unix タイムスタンプに達すると、メッセージはアクティブなルーティング状態に移行し、標準の配信レポート(DLR)イベントを生成します。アプリケーションがスケジュールタイムスタンプと最終配信ステータスを正しく関連付けて処理できるか確認してください。
| Webhookイベント | 発生トリガー | ウォレット台帳ステータス | 推奨されるシステム処理 |
|---|---|---|---|
| schedule-created | タスクのキュー登録完了 | 資金の一時ホールド設定 | スケジュールIDを内部注文に記録 |
| schedule-updated | 時間またはペイロード変更 | ホールド額の再計算と更新 | 内部タイマーの更新処理 |
| schedule-cancelled | ユーザーによるキャンセル | 即時ホールド解除・返金 | 内部ステータスをキャンセルに更新 |
| dispatch-executed | 配信時刻の到達 | ホールドから最終確定引き落としへ | 標準DLRイベントの監視開始 |
E.164送信ウィンドウにおけるエッジケースの処理
送信先の E.164 番号が日付変更線を跨ぐ場合や、夏時間の切り替えタイミングに重なる場合には、エッジケースが発生します。JIT(Just-in-Time)番号プロビジョニングとルート割り当て機能は、キューロック前に宛先レートを動的に計算します。配信前に E.164 番号が更新された場合、システムは実行前にルート権限を再検証します。また、メッセージがキューに留まっている間に STOP オプトアウトコマンドを受信した場合、コンプライアンス維持のため保留中の配信を即座にキャンセルする仕様を確認してください。
本番運用への移行準備とプラットフォーム相互接続
ステージングキューから本番トラフィックへ移行する前に、設定された運用手順書に従ってパイプライン全体を監査してください。立ち上げ時の必須チェック項目については Day-1ランウェイ:グリーンの条件 を確認し、ウォレットの制限については 本番トラフィック前のウォレット停止ライン を参照してください。また、時間制約のある通信ルールについては 確実な静穏時間を維持するアポイントメントリマインダー をご一読ください。
IOSORで始める
IOSORコンソールを開き、対象のタイムゾーンオフセット全体で段階的な予約送信テストを実行します。ペイロードの実行タイムスタンプがUTC変換テーブルと一致していること、および送信ウィンドウが開く前に一時的な前払い保留が台帳に正しく記録されていることを確認してください。本番ボリュームに拡大する前に、スケジュール作成されたウェブフックコールバックが確実にトリガーされることを確認します。
IOSORの要点
本ガイドでは、本番送信用にデプロイする前に、予約タイムゾーンキューと前払い台帳ロックを検証する方法を実証しました。ステージング環境で予約実行をテストすることで、対象のオフセットが正確に解決され、予期せぬ残高低下なしに資金が一時的に確保されるようになります。
対象のE.164番号をUTC Unixエポックタイムスタンプにマッピングし、キュー登録中にスケジュール作成イベントを監視してください。すべての対象配信ウィンドウにわたって台帳の保留アーキテクチャがキューイングされた量を問題なく処理できることを確認せずに、大規模な予約配信を試みないでください。
このガイドは役に立ちましたか?
関連ガイド
- 送信日時前の送信スケジュール保留の有効期限切れ処理
送信日時タイムスタンプより前にプリペイド残高の保留が期限切れになった場合、IOSORがサイレントドロップを発生させずにスケジュール済みSMS送信を処理する仕組みを解説します。
- 送信予約キュー管理はクワイエットアワーのポリシーエンジンではありません
IOSORの送信予約キューがスケジューリングされた配信を処理する一方で、コンプライアンスエンジンが配信違反を防ぐために独立してクワイエットアワーを適用する仕組みを解説します。