IOSOR ガイド
レンタル番号の着信イベントと受信箱:webhook混乱のない双方向運用
レンタル番号上の着信イベント、監査可能な受信トレイ、webhook 再試行と冪等——一本の white-label prepaid 口座。
発信はロードマップのスライドを取り、着信はポケベルを取ります。顧客がレンタル番号に STOP を返し、写真を送り、かけ直すとき、イベントはあなたのシステムに着地しなければなりません——サポートが信頼できる受信トレイであり、散らばったログではありません。着信規律のない双方向は、一方通行の約束に苦情キューを足しただけです。
IOSOR は着信 webhook とクライアント安全なエラー付きでレンタル番号を割り当てます——white-label、翌日運用に別ポータルは不要です。月次プラットフォーム利用が USD 1,000+ 付近になると、webhook 認証の証拠・STOP ログ・受信トレイ相関が商用レビューの材料になります。証拠を先に、拡大は後です。
設計段階で押さえる着信イベント
| イベント | 製品面 | 運用要件 |
|---|---|---|
| 着信 SMS | スレッド / チケット | 重複排除 webhook + 永続化 |
| 配信回証(DLR) | 状態タイムライン | 発信送信との相関 |
| 音声コールバック | キュー / 留守電 | 録音ポリシー + 同意 |
| キーワード STOP/HELP | コンプライアンスログ | 即時抑制 |
STOP の欠落はコンプライアンス事故であり、「あとで記録」ではありません。DLR と発信の相関が無いと、財務は月末に目隠し突合になります。参照 双方向受信トレイのガイド と STOPとHELPのキーワード方針。カタログ live の双方向は上表四行を覆います。in setup は本番の双方向ではありません。
着信 webhook の規律
- 着信リクエストをすべて認証する
- ハンドラは冪等——再試行は正常系
- 副作用(チケット、自動返信、CRM)の前に永続化する
- デッドレターキューとリプレイ手段
比較 着信Webhookの再試行。カタログが live なのに webhook が未認証では、弁明できない約束です。プラットフォームは再試行します。消費側が再試行を新規イベントとして扱うと、受信トレイと台帳が同時に壊れます。自動返信の前に永続化します。
不正の隙がない受信トレイ
受信トレイはチャット玩具ではなく、証拠です。
- 番号・タイムスタンプ・安全に伏せた本文を示す。
- 返信がスレッドになるとき、発信コンテキストを結ぶ。
- 自動返信をレート制限し、ループを防ぐ。
- コンプライアンス照会向けに監査可能なエクスポート。
エージェントは生の上流ペイロードを決して見ません。生診断は運用チャネルへ。上限のない自動返信は、誤設定ループで prepaid を空にします。
レンタル番号のライフサイクルと受信トレイ
番号は UTC 暦月で更新されます。解放は着信をきれいに止めなければなりません。更新担当と退役担当を文書化します。対 地域番号とフリーダイヤルの賃貸実態。カタログが in setup のままなら本番双方向ではありません。生きた割り当てのない受信トレイ行は幽霊チケットです。
危険信号
- 本番番号の着信が「近日公開」
- 重複排除なし → チケット重複
- 同意コンテキストなしの自動返信
- どの番号がイベントを受けたか辿れない
- エージェントへ生の上流ペイロード
- カタログ live なのに未署名 webhook
- 解放済み番号がまだ着信を配信
- 双方向を約束しているがカタログは in setup
IOSOR で始める
借りた双方向番号を一つ割り当てる。試験 MO を送る。受信箱を開き、DID・テナント・相関 id の一行を確認する。死信から同じ事件を再生し、二行目がないことを見る。サポートが声に出して読む STOP 経路を渡す。これは借りた DID 上の受信箱の品であり、ゲートウェイのロックでも洪水泥縄でもない。
IOSORの要点
借り番号の受信箱は支援の一行。行のない webhook 2xx は静かな欠落。
する:各 MO を担当が開ける行に結ぶ。しない:生ログに入着を残して受信箱と呼ばない。
このガイドは役に立ちましたか?
関連ガイド
- 着信音声の不在着信時フォールバックSMSトリガーの設定
IOSORホワイトラベルCPaaSコンソール内で、不在着信や話中時の音声に対して自動SMSトリガーを設定する方法を学びます。
- キャリア遅延スパイクに対するインバウンドWebフック処理のバッファリング
IOSORのインバウンドバッファリングルールを設定し、キャリア配信の遅延、同時実行数のスパイク、アップストリームのタイムアウトエラーからWebフックを保護する方法を学びます。
- マルチテナントアカウント全体でのインバウンドオプトアウトキーワードの同期
IOSORにおけるマルチテナントのオプトアウト同期をマスターします。インバウンドのSTOPキーワードがグローバルな配信停止を管理しつつサブアカウントを隔離する方法を学びます。