IOSOR 知識庫

DID 入站 Webhook 路由：防止遺失的 MO 和未被認領的 STOP 指令

安全地將入站 Webhook 路由至擁有帳戶。在白標預付費 CPaaS 中防止孤立的 MO 事件和錯失的退訂，確保合規性與客戶滿意度。

設定 DID 的入站 webhook 路由是確保 SMS 雙向通訊穩定運作的關鍵步驟。若路由配置不當，系統將無法正確接收 MO 訊息，甚至導致重要的 STOP 指令被遺漏，進而引發合規性風險。透過優化路由邏輯，您可以即時處理 DLR 並確保所有入站請求都能精確對接後端 ledger 系統以維持服務品質。

DID 入站流量路由的運作機制

當終端用戶向配置的 E.164 號碼發送 SMS 時，電信網路會將酬載傳送至我們的閘道。在多租戶白標 CPaaS 環境中，每個收到的行動發起 (MO) 訊息必須即時解析至特定的子帳戶所有者。此過程依賴於精確的路由表和即時所有權查找。如果路由邏輯失敗、指派表格過期，或目標 DID 在系統中未被正確識別，酬載就會變成孤立的 MO。若無明確所有者，像 STOP、UNSUBSCRIBE 或 CANCEL 這類的關鍵消費者指令將被靜默丟棄，從而破壞合規性、損害客戶體驗並引發潛在的監管投訴。

防止孤立的 MO 與遺失的 STOP 指令

未指派的 MO 事件代表著一個嚴重的營運風險。如果入站 SMS 包含如 STOP 或 CANCEL 的關鍵字，但系統無法即時識別租戶對應，退訂處理就會失敗。這會導致訂閱者在非自願的情況下保持活躍狀態，進而引發客戶流失、負面評價以及電信商處罰。為維護電信商信任和平台聲譽，我們的基礎設施對每個入站 Webhook 執行嚴格的驗證檢查。如果目標 DID 缺乏有效的訂閱記錄或有效的路由表項目，閘道將會將該訊息標記為無法路由，並觸發告警，而非靜默丟棄。

預付費錢包安全與閾值防護

高流量和訊息傳遞營運需要強大的財務控制來防止濫用和意外支出。我們的基礎設施為每個租戶建立並強制執行嚴格的預付費錢包機制。入站和出站訊息傳遞管線必須在有足夠資金儲備的情況下運行，以確保服務的連續性。我們設定了最低 USD 20 的預付費底線，並實施自動化風險引擎。此引擎會在總花費接近每月 USD 1,000 或訊息速率異常升高時觸發溫和審核，並可能暫停服務，直到帳戶重新充值。這可保護平台免受意外流量激增的影響，並確保 webhook 傳遞端點的合法性與有效性。

Webhook 分派、DLR 與消費者營運

交付高吞吐量的 HTTP 酬載需要具備韌性的重試策略、可靠的訊息確認機制（如 DLR - Delivery Report）以及嚴格的端點隔離。將入站 SMS 路由至租戶伺服器時，不良的消費者實務可能會壓垮您的基礎設施。高流量下的 Webhook 消費端營運原則規定，接收伺服器必須快速傳回 2xx 狀態碼，同時將繁重的解析和處理工作卸載給背景工作執行緒。如果您的端點逾時或傳回錯誤狀態碼，閘道將會根據預設的重試策略進行重試，並記錄 DLR 以追蹤訊息傳遞狀態。若持續失敗，訊息將進入死信佇列。

處理抑制清單、OTP 與合規性

在訊息傳遞營運中，合規性是沒有妥協餘地的。當入站的 STOP 指令成功處理後，平台會立即記錄退訂請求，並將該號碼對加入到抑制清單中。這能防止未來對已撤銷同意的號碼進行任何出站嘗試，確保遵守電信法規和行業標準。對於需要雙重驗證的場景，我們也支援 OTP (One-Time Password) 的發送與驗證流程。若要了解管理退訂和抑制清單的更深入營運細節，請參閱我們的相關指南。妥善處理抑制清單和驗證流程可確保您的白標品牌完全合規，並維持良好的發送信譽。

從 IOSOR 開始實現穩健路由與營運

在入站訊息傳遞啟動前，必須將每個目的 DID 精確對應到一個唯一的租戶。任何無法匹配的 DID 應被導向死信佇列，並觸發告警通知，絕不允許靜默丟棄。若消費者端點未能為不匹配的 DID 回傳 2xx 狀態碼，而是回傳其他錯誤，這將被視為潛在的安全洩漏或路由配置錯誤，尤其是在處理 STOP 指令時，這可能導致指令無法送達正確的所有者。此過程強調的是所有權查找的準確性，而非抑制名單本身的寫入或 E.164 號碼的單純清洗。

IOSOR 核心要點與營運考量

入站路由的核心是精確識別訊息的接收者，即哪個租戶擁有該 DID。如果找不到對應的所有者，則無法進行任何進一步的處理，包括將訊息寫入抑制名單。我們強調的營運模式是：對於無法匹配的 DID，必須將其導向死信佇列並觸發告警。我們不支援消費者端點在未正確識別租戶的情況下回傳 2xx 狀態碼，並承諾零丟棄的服務等級協議，因為這可能導致關鍵指令（如 STOP）遺失，損害合規性和使用者體驗。此外，我們實施了嚴格的預付費錢包管理和閾值監控，以及 DLR 和重試機制，以確保訊息傳遞的可靠性和平台的財務穩定性。我們也支援 OTP 驗證流程，以增強安全性。嚴格的抑制清單管理是我們合規性策略的基石。

這篇指南有幫助嗎？