二重配信を防ぐ失敗したSMSキャンペーンアイテムの安全な再試行

プリペイド型CPaaSにおいて失敗したSMSの再試行を行う際、DLRの遅延により二重課金が発生する罠があります。この問題を解決するには、JIT配信パイプラインを再起動する前に、配信受領書と元帳の状態を厳密に照合する必要があります。重複排除キーを活用することで、安全なトランザクション管理が実現します。

失敗したSMSアイテムの構造

ホワイトレーベル事前支払い型CPaaSキャンペーンの運用中、ネットワークの切断やキャリアのタイムアウトにより一部のアイテムが失敗します。オペレーターは、再試行ロジックをトリガーする前に、配信状態を明確に把握する必要があります。失敗したアイテムは、上流のエラーを返すか、JIT配信パイプラインでキューに入っている間に完全にタイムアウトします。何らかの措置を講じる前に、システムは配信受領(DLR)を照合し、キャリアからの遅延フィードバックを永続的な失敗と混同していないことを確認する必要があります。

二重配信と二重課金の危険性

手動または自動のキャンペーン再試行における最大の危険性は、全く同じテキストを2回送信し、二重の料金発生を引き起こすことです。ウェブフックがタイムアウトを報告した場合でも、キャリアが数分後にメッセージを配信している可能性があります。バッチ全体を再キューイングスクリプトで盲目的にプッシュすると、同じコンテンツに対してクライアントに即座に二重請求が発生します。これを防ぐには、配信前に元帳の状態と重複排除キーを確認する必要があります。

DLR遅延と実際の配信状態の照合

ネットワークの混雑はステータスレポートの遅延につながることが多く、メッセージが単にキューに詰まっているだけなのに失敗したかのように見えます。DLRの遅延対API受付：遅れた配信通知によるプリペイド残高の枯渇を防ぐ方法で議論されているギャップを理解することは、再試行の安全性のために極めて重要です。アグリゲーターがAPIリクエストを受け入れたものの最終ステータスのコールバックが遅延した場合、早すぎる段階で失敗として扱うと重複送信がトリガーされます。オペレーターは、保留状態が維持される猶予期間を実装する必要があります。

安全なペイロードハッシュとべき等性キー

ネットワークレベルでの重複実行を防ぐため、すべての送信SMSリクエストには一意のべき等性キーが必要です。キャンペーンアイテムが失敗して再試行キューに入ると、システムは受信者のE.164番号、キャンペーンID、タイムスタンプを組み合わせたソルト付きハッシュを生成します。全く同じハッシュを持つ重複したウェブフックが到着した場合、課金エンジンはそれを即座に破棄し、二次的な元帳の引き落としを防ぎます。このパターンは、二重課金なしの部分フェイルオーバー送信で説明されている保護策と並行しています。

フェイルオーバー中の部分的なバッチ障害の処理

プライマリールートの品質が低下すると、トラフィックはバックアップルートに移行し、結果としてメッセージの半分が成功し、残りの半分が停止するという混在したバッチ結果をもたらします。これらの断片化した実行を安全に管理するには、アクティブなパイプラインを中断することなく、失敗したサブセットを切り離す必要があります。同様の原則は、マルチキャリア設定にわたるシナリオを管理する際にも適用されます。

IOSORで始める

IOSORコンソールを開き、キャンペーンの再送パイプライン全体でペイロードのべき等性ハッシングを有効にして、重複送信を自動的にブロックします。メッセージが再キューイングのために永続的失敗としてフラグ付けされる前に、必須のDLR（配信レポート）照合保留期間を設定します。ディスパッチキューのログから部分的なバッチ障害を直接分離し、未確認のE.164宛先のみが再処理されるようにします。

IOSORの要点

厳格なべき等性とDLR遅延照合を行わずに失敗したキャンペーンアイテムを再試行すると、メッセージの重複配信やプリペイ資金の無駄遣いに直接つながります。ルートのフェイルオーバー時にバッチ全体を盲目的に再実行すると、重複するトラフィックが発生し、キャリアからの信頼が損なわれ、受信者に重複テキストが届く原因になります。

受信者番号とキャンペーン識別子を組み合わせたソルト付きべき等キーを実装し、ゲートウェイレベルで重複送信を破棄してください。遅延配信レポートを確認したり、正確な失敗サブバッチを特定したりせずに、APIタイムアウト時に自動再キューイングスクリプトをすぐにトリガーしないでください。