IOSOR 知識庫

針對子帳戶的 Webhook 路由：實現租戶隔離與安全傳輸

掌握子帳戶的 Webhook 隔離技術。學習如何配置特定租戶的端點，確保 DLR 與狀態回調資訊保持私密，並防止中繼資料洩漏。

針對子帳戶的 Webhook 路由：實現租戶隔離與安全傳輸。

建立租戶專屬的 Webhook 架構

為了在白標 CPaaS 平台中維持嚴格的隔離性，您必須將 Webhook 路由從主要夥伴帳戶中分離。當子帳戶觸發 SMS 或 OTP 事件時，系統會產生唯一的 DLR 負載。透過在子帳戶層級指派專屬的 Webhook URL，您可以有效防止跨租戶的元數據洩漏。請前往子帳戶設定面板，選取 API 設定標籤頁，並定義狀態回調的端點。此舉確保每個事件直接路由至客戶的基礎設施，而不會經過您的全域夥伴監聽器，從而實現端到端的安全隔離。在 IOSOR 主控台的夥伴設定中，您可以為每個子帳戶配置獨立的 Webhook 端點。請確保您的後端服務能處理高併發的 Webhook 回調，以避免在尖峰時段發生請求佇列阻塞，並監控伺服器日誌以偵測潛在的延遲或錯誤。

實作安全的負載驗證機制

在處理回調時，安全性至關重要。請務必使用每個 Webhook 請求標頭中提供的 HMAC-SHA256 簽章驗證。透過為每個子帳戶產生唯一的密鑰，您可以讓客戶驗證收到的 DLR 或 Verify OK 訊號確實來自我們的平台。這能防止未經授權的偽造請求，並確保客戶僅處理合法的流量。建議在入駐階段定期輪替這些密鑰，以維持強大的安全防護基準，並防止潛在的攔截攻擊。在 IOSOR 的 API 設定中，您可以為每個子帳戶生成並管理這些專屬的簽章密鑰。同時，請確保您的伺服器僅接受來自我們已知 IP 範圍的請求，進一步強化端點的存取控制能力，並考慮實施速率限制以防止暴力破解攻擊。

管理 JIT 資源配置與預付餘額

我們的平台針對所有號碼採用即時 (JIT) 配置，這意味著不會有庫存處於靜態狀態。當子帳戶請求號碼時，系統會在付款完成後立即指派。請確保您的客戶維持至少 USD 20 的預付餘額，以保持服務持續運作。若餘額低於此門檻，系統將暫停發送功能以防止負值產生。對於高流量的夥伴，當每月支出達到 USD 1,000 時，我們將執行軟性審查，以便調整信用額度並優化路由路徑。這種自動化方法使您的營運保持精簡，並消除了手動管理庫存的需求，讓您可以專注於業務擴展，同時透過 IOSOR 的錢包系統即時監控資金流向。在 IOSOR 的預付錢包設定中，您可以設定低餘額警報，並查看詳細的交易記錄。

配置 DLR 與 STOP 邏輯

標準化您的子帳戶處理傳入訊號的方式。請設定 Webhook 以解析 E.164 格式的號碼，並將其對應至正確的內部客戶 ID。當用戶回覆 STOP 時，系統必須在您的資料庫中觸發自動化的退訂旗標，並確保此狀態能即時同步至我們的全域拒絕清單，以防止後續的非預期訊息發送。透過將此邏輯集中在子帳戶的 Webhook 處理器中，您可以在遵守全球訊息傳遞法規的同時，保持夥伴層級日誌的整潔與審計就緒狀態。此外，建議實作靜音時段(Quiet Hours)邏輯，根據接收方所在時區自動過濾非必要的行銷訊息，以提升用戶體驗並降低投訴率。在 IOSOR 的訊息設定中，您可以配置 DLR 的處理規則和 STOP 訊息的自動回應。

整合關鍵的夥伴資源

為了簡化您的設定流程，請參考以下技術整合路徑。這些指南涵蓋了品牌安全營運與 API 連線的基礎步驟，協助您快速上手：

從 IOSOR 開始

請開啟 IOSOR 主控台並前往夥伴設定標籤頁來定義您的租戶路由規則。為每個子帳戶指派明確且經過密鑰簽章的網路鉤子網址，以便獨立處理訊息傳送狀態回條與連入回呼。透過針對每個客戶帳戶觸發沙盒簡訊發送來測試路由隔離性，並確認回呼僅會發送至各自的租戶端點而不會發生外洩。在 IOSOR 的開發者工具中，您可以模擬 SMS 發送並監控 DLR 的接收情況，以驗證 Webhook 的正確配置。同時，請務必測試 OTP 驗證流程，確保其穩定性和安全性。

IOSOR 要點

本指南說明瞭如何透過將不同的網路鉤子端點與 HMAC-SHA256 簽章金鑰綁定至個別客戶設定檔，來隔離子帳戶回呼。將夥伴層級的後設資料與最終租戶狀態回呼脫鉤，能確保白牌環境中的高可靠性與完全的營運獨立性。在儀表板初始化子帳戶期間，設定獨特的密鑰與租戶專屬的回呼網址。切勿透過單一龐大的夥伴端點來路由所有狀態回條與驗證酬載，亦不可略過對連入流量的簽章驗證。實施靜音時段(Quiet Hours)策略，並確保預付錢包餘額始終高於 USD 20 的最低門檻，以維持服務的連續性。透過 IOSOR 的儀表板，您可以全面監控所有子帳戶的訊息傳遞狀態、餘額以及 Webhook 的運作情況，確保營運的順暢與安全。

這篇指南有幫助嗎？