インバウンドSMS Webhook：リトライ・順序・受信冪等

アウトバウンドSMSはダッシュボードを占めます。インバウンドこそSTOP・HELP・顧客返信が着地する場所であり、素朴なハンドラが重複チケット、二重ウォレット副作用、「STOPを受け取っていない」コンプライアンス幽霊を生む場所です。受信パスが厳密順序のexactly-once配信を仮定するなら、最初の本格障害で破綻します。

IOSORはインバウンドメッセージングをアウトバウンドと同じホワイトラベル前払い面に収めます。検証可能なイベント、ブランド安全なペイロード、返信嵐の突合せのために外部Opsポータルに住む必要はありません。

なぜWebhookはリトライするのか

多くのプラットフォームでインバウンドWebhookが約束するのはリトライ付きat-least-once配信であり、魔法のexactly-once厳密順序ではありません。ハンドラは次を許容すべきです。

• 同一論理イベントの重複POST
• タイムアウト後の遅延到着
• 他イベント種別との相対的な順序乱れ

プロダクトUXは、自社ストアが決定的マージするなら順序立てて見えます。回線が決して乱れないという希望では起きません。

設計必須の三つの失敗モード

冪等：三つを同時に直す一つの性質

インバウンドにも金銭と運用副作用があります。

• 自動返信が前払いウォレットを引き落とす
• STOP処理は将来のマーケ送信を抑止する
• チケットを開くサポートマクロは3回のPOSTで3枚開いてはならない

冪等受信ハンドラのチェックリスト：

1. 副作用前にインバウンドイベントidを永続化
2. 重複は前回outcomeでショートサーキット
3. 自動返信送信に独自の冪等キー
4. 相関ログ：inbound id → ウォレット行 → reply id
5. 失敗文言をオペレータ向けにホワイトラベル安全に

月間プラットフォーム利用がUSD 1,000+近辺では、重複インバウンド嵐は財務・コンプライアンス会話になります。パイロットは低量キーワードで先に台帳を証明できます。

イベント順序：なぜ「最後の書き込み勝ち」が危険か

よくある誤仮定：

1. STOPが次のマーケ送信より先に着く（レースがある）
2. アウトバウンドDLRがインバウンド返信より先（独立パス）
3. 耐久イベントキーなしの「先頭POST勝ち」

耐久 event / message id で受信台帳を構えます。ビジネス規則はその台帳上の状態遷移であり、「各HTTP 200パスで副作用」ではありません。

. . . .

2xx — typically under a second. . .

1. インバウンドコールバックの文書化されたリトライ方針
2. テスト可能な署名/認証検証
3. ペイロード内の耐久イベントid
4. 冪等ハンドラのガイダンス（「200を返す」だけではない）
5. 重複配信に耐えるSTOP / HELPパス
6. 自動返信支出が同一前払いウォレットで見えること

危険信号

. . Near USD 1,000+ — .

IOSORで始める

先週の入着 webhook ログを引き、二度以上着いたイベント ID を数える。重複一件と順不同の対（failed のあと delivered）を再生する。受信は効果を一つだけ残す。受信箱一行、STOP 一回、財布一触。後書き勝ちで STOP を戻すのは失敗。受信側の冪等と再試行順であり、署名検証でもキュー前のゲートウェイ錠でもない。

関連ガイド: 着信自動返信ループ · キャリア遅延スパイクに対するインバウンドWebフック処理のバッファリング · 初回引き落とし前のプリペイド残高確保.

IOSORの要点

入着 webhook は再試行する。受信冪等が唯一の安全な答え。順序は約束ではない。

する：イベントに鍵を付け、双子を無視する。しない：STOP に後書き勝ちを使うな。同じイベントを二度減算するな。