IOSOR 知識庫
未送達狀態與帳本完整性:未知訊息與 DLR 對應機制
深入了解為什麼未送達的 SMS 代碼不能在 IOSOR 帳本中被改寫為成功。掌握 DLR webhook、預付費餘額凍結規則與路由優化方式。
在 IOSOR 的 CPaaS 架構中,系統接獲 UNKNOWN 狀態的 DLR 時必須一律視為未送達,以維護帳本資料的完整性。若將失敗的 OTP 簡訊強行竄改為成功,會引發嚴重的計費偏差與財務不符。精確地映射 API 狀態與 webhook 資料,才能確保 USD 扣款與 JIT 額度扣抵同步無誤。
了解帳本作業中的未確認 DLR 狀態
在白牌 CPaaS 架構中,訊息狀態的最終性決定了投遞準確度與財務結算。當外寄的 SMS 或 OTP 訊息透過 E.164 格式發送時,核心引擎會追蹤其透過各個電信節點的傳輸管線。如果終端投遞回條 (DLR) 回傳了未知 (UNKNOWN) 或未送達狀態碼,這代表遠端行動網路營運商無法確認接收裝置已成功收件。特別是在涉及各國地區的靜音時間 (Quiet Hours) 法規時,於限制時段內發送的非緊急行銷訊息可能會被電信端暫緩傳輸或拒絕投遞,導致 DLR 狀態進入長期未確認的狀態。系統必須精確記錄這些時間戳記,確保營運團隊能釐清延遲原因而非隨意標記完成。
為什麼未送達的 SMS 代碼不能被改寫為成功
合規訊息處理的主要要求之一,是未知或未送達的代碼絕對不能在帳本中被竄改或改寫為成功。若在 DLR 明確回報 UNKNOWN 時,試圖強行寫入如 'Verify OK' 或 'Delivered' 等人工狀態更新,將嚴重違反核心財務控制。當客戶應用程式發送關鍵驗證負載卻未收到確切投遞回條時,篡改歷史紀錄會產生危險的偽陽性結果。此外,當使用者觸發退訂機制時,系統必須進行即時的退訂同步 (Opt-out Sync),將該號碼列入黑名單。若無視退訂狀態與 DLR 失敗回報而強制修改狀態,不僅會引發嚴重的合規裁罰,更會破壞整體數據庫的真實性。
未送達流量的帳本扣款與對帳
白牌訊息服務的財務層採用嚴格的預付費原則。當 API 呼叫觸發新的外寄傳輸時,預付錢包 (Prepaid Wallet) 會在帳戶餘額中設置暫時性的預扣額度 (Wallet Hold)。一旦上游電信狀態解析完成,系統會根據終端回應將凍結額度轉換為已結算扣款或進行退款處理。為了確保系統在高流量併發時不致因欠費而中斷服務,帳本設有 USD 20 的安全餘額底線 (USD 20 Floor)。當預付錢包可用餘額扣除預扣額度後低於 20 美元門檻時,系統會自動發出儲值警報並限制高風險路由的發送,保護白牌營運商的現金流與資金安全。
Webhook 負載與即時狀態對應
平台應用程式依賴自動化 webhook 端點來即時解析訊息狀態轉移。當 DLR 回呼到達時,負載會公開關鍵參數,包含訊息 ID、時間戳記詮釋資料、目標 E.164 號碼以及明確的狀態字串如 UNKNOWN。Webhook 數據被視為系統的單一事實來源 (Single Source of Truth),不可在傳輸過程中被中間件過濾或變更。應用程式邏輯必須建構為能夠取用這些原始 webhook 事件,並將 DLR 狀態原封不動地寫入審計帳本,同時維持與退訂資料庫的雙向狀態同步。
優化策略與內部路由規則
為了將模曖可探的投遞狀態降至最低,平台營運商必須執行主動式資料庫維護與路由監控。無法路由的目標號碼、持續的網路逾時或無效的 E.164 輸入都必須被快速隔離。整合自動化抑制過濾器可防止對不活躍端點進行浪費的重複傳輸。同時,內部路由規則應自動整合目的地國家與地區的靜音時間規範 (Quiet Hours Rules),在禁止時段自動排程或阻斷行銷類訊息,避免無謂的電信懲罰性扣款與無效的預扣額度佔用。
相關閱讀: 財務與客服可引用的狀態碼 · 白牌 CPaaS 中的錯誤目錄與可達性手冊 · 首次扣款前的預付資金保留.
從 IOSOR 開始
若要確保 IOSOR 主控台內帳本的完整性,請導覽至「Gateway Routing」與「DLR Mapping」面板以驗證您的狀態轉換規則。請確保任何傳入的「UNKNOWN」或「UNDELIVERED」回呼資料皆嚴格對應至最終失敗狀態,而非被攔截或修改。您可以在 IOSOR 測試套件中執行模擬,以確認針對這些特定狀態碼的手動帳本覆寫已被封鎖。
IOSOR 要點
本文指出,企圖將帳本上未知或未送達的訊息狀態人為改寫為成功交易,是嚴重的合規性違規行為。這樣做會損害財務對帳、扭曲送達率指標,並導致電信商日誌與平台計費之間產生偏差。
請勿實作自動化指令碼或手動覆寫,將未解決的送達報告轉換為「Success」或「Delivered」狀態以迎合用戶端的預期。相反地,應保留原始的 DLR 狀態以維持嚴格的帳本透明度,並利用自動化 Webhook 通知下游應用程式確切的傳輸結果。
這篇指南有幫助嗎?
相關指南
- 財務與客服可引用的狀態碼
標準化支援與財務部門之間的簡訊與驗證碼狀態碼。了解確定性錯誤代碼如何簡化帳本審計與客訴解決流程。
- 白牌 CPaaS 中的錯誤目錄與可達性手冊
學習如何在 IOSOR 中排查租戶支援工單時,將原始 DLR 狀態碼參考指南與廣泛的簡訊可達性手冊區分開來。