佇列中與已發送：IOSOR 中的單一訊息路徑

佇列中與已發送：IOSOR 中的單一訊息路徑。

佇列與已發送的單一狀態機

當 API 請求觸發平台以發送 SMS 或 OTP 酬載至 E.164 目的地時，產品與財務團隊必須參考完全相同的生命週期狀態。在傳統的白牌架構中，產品團隊將「佇列中」視為工程狀態，而財務團隊則需等待月底報表。IOSOR 透過單一決定性狀態機消除了此種脫節現象。當 HTTP 酬載通過驗證時，訊息會立即進入佇列中狀態。此狀態會在交易紀錄中建立明確的項目，鎖定路由費率並對客戶的預付錢包套用授權保留。系統同時會檢查目的地國家與時區是否處於「寧靜時段(Quiet Hours)」，若觸發管制，訊息將保留於佇列中並延後至合規時段分派，確保業務營運完全符合法規要求。在 IOSOR 主控台，此狀態機的轉換可在「訊息生命週期」儀表板中追蹤，並透過 API 請求的 `message_id` 進行精確定位。預付錢包的授權保留會即時反映在「錢包餘額」區塊，顯示為「待定授權」。

佇列時的財務保留與最終結算

一旦進入佇列狀態，引擎會立即執行餘額檢查。為了維持平台償付能力與防止欠款風險，帳戶必須在外部流量進入管道之前維持至少 20 美元(USD 20)的預付底線。在佇列中時，預付錢包會對該筆外部 SMS 區段套用精確的成本授權保留(Prepaid Wallet Hold)。此保留金額的計算基於預先配置的路由費率，該費率可透過 IOSOR 主控台的「費率管理」模組進行檢視與更新。若訊息順利由佇列中轉換為已發送，此保留金額將轉化為最終餘額扣款；若訊息在佇列階段驗證失敗或無效，保留金額將會立即全額釋放，並在主控台的「交易日誌」中記錄為「授權釋放」。隨著每月流量逐漸接近 1,000 美元的審查門檻，分類帳並行機制可防止在高吞吐量狀態轉換期間發生餘額漂移，確保資金零差距。此機制透過獨立的交易處理器執行，確保即使在大量訊息湧入時，預付錢包的餘額變動也能保持原子性。

轉換觸發條件：API 擷取至交接

佇列中與已發送之間的界線非常嚴格。佇列中意味著酬載已通過驗證、完成費率計算，並在保留資金的情況下分配至分派佇列中。已發送則表示邊緣閘道已將 PDU 傳輸至網路介面並接收到中間確認。在此毫秒，系統會將狀態從佇列中更新為已發送，並分派非同步的 webhook 事件。此 webhook 事件包含 `message_id`、`status` (已發送) 以及 `timestamp`，可供外部系統進行冪等性處理。號碼是使用 JIT(即時)配置進行配置，確保 E.164 路由和 MRC 會計在沒有投機性保留的情況下發生。針對跨區推播，系統亦支援根據當地區域的時間規範進行靜音時間微調，避免在禁止時段內誤發非緊急訊息。靜音時段的設定可在 IOSOR 主控台的「全球設定」中配置，並可針對特定國家代碼進行細部調整。若訊息在靜音時段內觸發，將被標記為「延遲發送」，直到合規時段才進入已發送狀態。

協調分類帳稽核與傳送報告

當 DLR(交付報告)發生延遲時，財務稽核往往會與工程日誌產生衝突。在 IOSOR 中，已發送是最終扣款確認的會計點，而 DLR 與 Webhook 則是驗證傳送成敗的最終單一事實來源(DLR/Webhook Truth)。諸如 DELIVERED 或 UNDELIVERED 等 DLR 狀態會即時更新營運指標與監控儀表板，而不會改變初始交易分類帳的財務扣款結果。DLR 的接收與處理透過專用的 DLR 處理器完成，並將狀態更新推送到訊息佇列，供後續的 Webhook 發送。此外，平台具備嚴密的退訂同步(Opt-out Sync)機制：若收到入埠的 STOP 命令，該 E.164 地址的退訂狀態會立即全局同步，後續發往該號碼的嘗試將在 API 邊緣遭到攔截拒絕，並在發生任何財務保留之前回傳 Verify OK 狀態，保護錢包不受重複無效計費損害。此退訂狀態的同步亦會觸發一個特殊的 Webhook 事件，通知下游系統該號碼已退訂。

營運手冊與相關架構

為了保持工程與財務營運之間的一致性，請遵循以下關於佇列處理、webhook 冪等性與錢包機制的核心參考指南：

• 大流量下的 Webhook 消費端營運
• 錢包試行週：即時流量中的預扣與扣款真相
• 冪等、重試與資金安全
• OTP 驗證流程與安全考量
• DLR 狀態碼詳解與故障排除
• 靜音時段與國際訊息合規

從 IOSOR 開始

請開啟 IOSOR 主控台並前往生命週期狀態機設定，將外寄通道與單一排隊發送管線進行對齊。設定帳本整合，將發送狀態視為最終扣款確認的權威基準，而非等待下游電信回條。執行測試發送並稽核工程網 webhook 與財務日誌中的統一交易狀態識別碼，以驗證設定是否正確。特別注意 OTP 訊息的發送，確保其狀態更新與 DLR 報告的即時性。配置預付錢包的最低餘額警報，以避免因餘額不足導致訊息佇列積壓。檢查所有路由的靜音時段設定，確保符合目標市場的法規要求。

IOSOR 要點

本指南證明了以單一狀態機整合產品遙測與計費，能有效消除工程與財務部門之間的營運摩擦。在進入佇列時預扣資金，並在閘道器發出發送事件時提交最終扣款，可建立不受延遲或遺失回條影響的決定性會計模型。此模型確保了預付錢包的準確性，並為財務稽核提供了清晰的軌跡。OTP 訊息的生命週期管理亦受益於此統一狀態機，從佇列到最終送達的每個階段都清晰可見。靜音時段的自動調整確保了合規性，而 DLR 和 Webhook 則提供了營運可見性。

請務必將會計結算觸發點嚴格對應至發送轉換，並將回條僅用於營運品質指標。切勿將帳本調整或扣款提交與非同步送達回條綁定，這會導致會計漂移與稽核對帳衝突。確保所有交易都與唯一的 `transaction_id` 或 `message_id` 相關聯，以便於追蹤和對帳。預付錢包的授權保留機制是防止欠款的關鍵，務必監控其狀態並及時補充餘額。