IOSOR 知識庫

DID 故障週:訊息功能失效並非未上架或缺貨

學習如何在斷線期間處理您的第一個 DID 訊息故障,在沒有庫存虛構的情況下管理預付扣款,並傳遞誠實的狀態。

訊息失效代表路由異常,而非商店缺貨

當新佈建的號碼發生訊息發送失敗時,您的第一直覺可能是檢查庫存或尋找補貨通知。在白牌 CPaaS 營運中,並沒有倉庫或實體貨架。號碼是透過即時(JIT)佈建來實例化的。如果傳入的 SMS 或 OTP 傳遞中斷,問題必定出在路由表、webhook 派發器或上游閘道交握中,絕不是『售罄』。請將每次中斷視為即時網路異常,而不是商品銷售錯誤。這與傳統的電信服務不同,後者可能涉及物理基礎設施的故障或容量限制。在我們的模型中,所有資源都是軟體定義的,因此故障點更可能是配置錯誤、API 整合問題或下游服務的暫時性不可用。理解這一點對於快速診斷和解決問題至關重要。

立即凍結號碼指派與發送佇列

一旦客戶回報訊息傳遞回條(DLR)遺失或 OTP 流程靜默,請立即凍結自動化號碼指派與高流量發送佇列。在服務持續降級時讓腳本繼續分配路由,只會擴大災害範圍。對受影響的子帳戶預付餘額配置施加暫時凍結。在支援團隊追蹤心跳(HB)與 API 酬載日誌時,清楚傳達該事件正在進行主動工程審查,同時保持最低 USD 20 的預付底限完整。這包括暫停任何自動化的預付充值觸發器,直到問題解決,以防止進一步的財務損失或混亂。凍結操作應透過 API 或管理控制台執行,確保即時生效。

在怪罪網路前先驗證就緒狀態

在升級事件之前,請先驗證受影響的號碼是否符合基準協定要求。許多表面上的中斷源自於跳過了 號碼指派不等於生產簡訊就緒 指南中所列出的驗證步驟。請檢查 10DLC 註冊狀態、品牌合規性以及 webhook URL 的回應能力。如果標頭回傳 5xx 錯誤,瓶頸是在應用程式端點,而不是電信網路。這包括確認所有必要的 API 端點都已正確配置,並且能夠響應來自 CPaaS 平台的請求,例如接收 DLR 更新或處理傳入訊息。同時,檢查與之相關的預付錢包餘額是否充足,以避免因餘額不足而導致的服務中斷。

置換、退款或釋放失效資產

如果底層路由路徑永久降級且無法在 SLA 期限內恢復,切勿讓客戶枯等待命。請執行乾淨的置換或發布自動化信用額度。請參閱 號碼下單失敗後的退款與更換 協定,以確保餘額調整正確清算。必須立即釋放預付保留金,以便租戶能夠佈建可用的資產,而不會為失效的基礎設施支付雙倍費用。這可能涉及透過 API 調用來取消先前分配的號碼,並將相應的預付金額退還至客戶錢包。對於需要立即恢復服務的客戶,提供備用號碼的選項至關重要。

跨越蜜月期之後的財務可預測性

營運事件通常與規模擴展的里程碑同時發生。一旦租戶度過初步測試並接近每月 USD 1,000 左右的軟審查,流量模式就會從零星的 OTP 爆發轉變為持續的 A2P 活動。請密切關注 DID 第二個月:UTC 日曆翻轉時的完整月租費 MRC 週期,以確保循環費用與使用加值能夠乾淨地對帳,而不會在主動故障排除期間觸發誤判的詐欺暫停。這需要對預付錢包進行精確的計費和餘額管理,確保服務不會因預付餘額不足而中斷,同時避免不必要的「安靜時間」或服務限制。定期審查預付錢包的消耗率,並在必要時觸發自動充值,是維持服務連續性的關鍵。

從 IOSOR 開始,實現原生白牌可靠性

DLR 或訊息 webhook 一死,就凍結該 DID 的發送佇列。不要因為號碼列仍寫著 assigned 就繼續 MT。匯出凍結時刻、最後一次好的 DLR,以及 messaging-down 狀態。只有同一串數字上的現場冒煙通過後再恢復。這不是店面「缺貨」徽章,也不是發票爭執。在發生此類事件時,應立即透過系統日誌記錄所有相關資訊,包括時間戳記、錯誤代碼、受影響的號碼範圍以及任何相關的 API 請求和響應。這有助於後續的根本原因分析和預防措施的制定。同時,應確保客戶能夠透過他們的預付錢包餘額來支付服務費用,避免因餘額不足而導致的服務中斷。

IOSOR 要點

訊息中斷是凍結,不是庫存斷檔。要確保預付錢包始終有足夠餘額,並監控 DLR 和 webhook 的狀態。當訊息傳遞失敗時,應立即凍結發送佇列,並通知客戶。不要繼續發送訊息,也不要把 DID 標記為缺貨。應仔細檢查路由配置、API 整合和上游閘道狀態。在問題解決並進行充分測試之前,不應恢復服務。同時,要確保預付錢包的餘額充足,以避免因餘額不足而導致的服務中斷。在發生故障時,應立即凍結號碼指派和發送佇列,並暫停對受影響帳戶的預付餘額配置。在進行故障排除時,應保持最低 USD 20 的預付底限。在升級事件之前,應驗證受影響的號碼是否符合基準協定要求,包括檢查 10DLC 註冊狀態、品牌合規性以及 webhook URL 的回應能力。如果底層路由路徑永久降級且無法在 SLA 期限內恢復,應執行置換或發布自動化信用額度。必須立即釋放預付保留金,以便租戶能夠佈建可用的資產。一旦租戶接近每月 USD 1,000 左右的軟審查,流量模式就會從零星的 OTP 爆發轉變為持續的 A2P 活動。應密切關注 DID 第二個月的完整月租費 MRC 週期,以確保循環費用與使用加值能夠乾淨地對帳。DLR 或訊息 webhook 一死,就凍結該 DID 的發送佇列。不要因為號碼列仍寫著 assigned 就繼續 MT。匯出凍結時刻、最後一次好的 DLR,以及 messaging-down 狀態。只有同一串數字上的現場冒煙通過後再恢復。這不是店面「缺貨」徽章,也不是發票爭執。

這篇指南有幫助嗎?

相關指南