IOSOR 知識庫

DID 復原週:訊息功能恢復不等於已啟用

了解為何 DID 凍結後,號碼顯示「已啟用」狀態不代表訊息功能正常運作,以及如何在重新指派號碼前驗證入站和出站簡訊路徑。

依賴狀態標籤進行 DID 復原的缺陷

當電話號碼經歷凍結或復原事件時,平台儀表板通常會將狀態標籤翻轉回「已啟用」。然而,網路層級的狀態變更並不能保證簡訊功能完全正常運作。轉售白標 CPaaS 要求平台擁有者區分基本路由啟用和功能性訊息吞吐量。在看到「已啟用」標籤後立即路由租戶流量,可能會導致 OTP 傳送遺失和 Webhook 處理中斷。

在 DID 故障週:訊息功能失效並非未上架或缺貨 事件後的復原週期間,自動化配置系統會在下游簡訊中心刷新其路由表之前完成 API 握手。為確保系統可靠性,協調者必須在將號碼重新開放給終端客戶之前,測試端到端訊息傳遞,同時嚴密監控任何潛在的路由延遲與封包遺失風險,以維護整體服務的穩定度。這包括檢查控制台日誌中的連線錯誤,並確保預付錢包餘額充足,以避免因預算限制而導致的訊息佇列凍結。

為何「已啟用」狀態會遺漏訊息路徑驗證

號碼標記為「已啟用」表示註冊條目已附加到您的帳戶,並且在系統中存在有效的路由配置。這並不能證明入站 Webhook 正在成功觸發並將訊息內容 POST 到指定的端點,也不能證明出站簡訊路由已清除運營商層級的垃圾郵件過濾器或任何臨時封鎖。靜默的入站訊息意味著訊息抵達了我們的基礎設施,但未能通過 API 閘道傳遞到您的應用程式。出站請求被系統接受,但可能在傳輸過程中因路由問題或下游拒絕而失敗,導致 DLR 返回錯誤代碼,例如 `DELIVERY_FAILED` 或 `UNKNOWN`。

  • 入站 Webhook 靜默: 號碼接收簡訊,但上游閘道無法將事件 POST 到您的端點。這可能與您的 Webhook 端點配置錯誤、防火牆規則阻止了來自我們 IP 的請求,或是端點本身無法回應有關。
  • 出站握手失敗: 系統接受出站請求,但 DLR (傳送回執) 返回失敗代碼。這可能源於號碼的簡訊功能被暫時禁用、目標運營商拒絕了訊息,或是訊息內容違反了某些內容策略。
  • 設定檔不匹配: 10DLC 或品牌註冊可能落後於原始號碼啟用,導致訊息在運營商層級被標記為未經授權的流量而遭到拒絕。確保您的 10DLC 設定檔與號碼的實際用途和預期流量模式相符至關重要。

在將復原的號碼重新投入生產之前,請查閱您的 號碼指派不等於生產簡訊就緒 指南,以確認設定檔綁定和路由策略符合平台預期,並檢查是否有任何與「安靜時間」(quiet hours) 設定衝突的路由規則。

驗證協定:測試入站、出站和 DLR

安全的重新指派需要結構化的三步驟驗證循環,而不是簡單的資料庫查詢。這是一個確保訊息通路暢通無阻的關鍵流程。

  1. 合成入站測試: 從您的控制台或透過 API 發送一條測試簡訊到該 DID。監控您的 Webhook 端點日誌,確認是否收到了預期的 POST 請求,並檢查請求中的訊息內容是否準確。這一步驟驗證了從外部到您應用程式的訊息接收路徑。
  2. 出站握手檢查: 使用該 DID 發送一條測試出站簡訊到一個已知可接收訊息的手機號碼。密切關注 DLR 的狀態更新。您需要等待直到 DLR 達到終端狀態,理想情況下是 `DELIVERED`。如果收到 `FAILED` 或其他錯誤代碼,則需要進一步調查出站路由問題。
  3. 延遲基準測試: 在完全指派租戶之前,透過發送一系列測試訊息(入站和出站),測量訊息從發送到最終狀態變更(入站的 Webhook 觸發,出站的 DLR 報告)的時間。確認傳送延遲保持在目標閾值(例如,入站 Webhook 在 5 秒內觸發,出站 DLR 在 30 秒內返回 `DELIVERED`)以下。這有助於識別潛在的網路瓶頸或路由延遲。

透過自動化這些測試,白標營運商可以防止租戶投訴,並避免在 DID 第二個月:UTC 日曆翻轉時的完整月租費 MRC 生效長期使用之前,過早更新帳單,進而確保持續流暢的營運交接與帳務透明度。同時,確保預付錢包餘額始終高於最低要求,以防止因帳戶餘額不足而導致的服務中斷。

表格:狀態標籤與實際訊息路徑狀態

系統狀態 入站 Webhook 出站簡訊 實際運作狀態
已啟用 失敗 未驗證 不安全指派
已啟用 已驗證 待處理 DLR 測試階段
已啟用 已驗證 已送達 可指派
已暫停 失敗 已封鎖 隔離/凍結

財務保留、帳戶餘額與限制

即時號碼管理採用即時 (JIT) 分配與即時預付保留相結合的模式。當號碼恢復到運作狀態時,系統餘額必須支援主動路由,而不會觸發意外的餘額耗盡。這意味著在進行任何號碼重新指派之前,必須驗證帳戶的預付錢包餘額是否充足。

IOSOR 維持 USD 20 的預付底線,以防止在自動重新驗證掃描期間服務突然中斷。此外,每月接近 USD 1,000 軟性審查的帳戶會進行自動路由檢查,以確保隨著租戶帳戶的流量擴展,訊息傳送率保持穩定,並且在高峰時期依然具備足夠的頻寬與系統容錯能力。這項檢查也涵蓋了對「安靜時間」設定的合規性審核,確保在非工作時間不會觸發不必要的訊息傳送,從而優化資源利用率並降低運營成本。

使用 IOSOR 安全復原號碼

凍結解除、徽章寫 Activated 之後,先別把號碼還給租戶。登入 IOSOR 控制台,檢查號碼的入站和出站訊息路徑。發一則合成入站測試訊息,確認您的 Webhook 端點正常接收並處理。接著,發一則測試出站簡訊,並耐心等待終端 DLR 狀態報告為 `DELIVERED`。僅當這兩項測試均成功通過後,才可以在控制台執行重新指派操作。匯出兩份測試證明(入站 Webhook 記錄和出站 DLR 報告)作為操作記錄。請記住,單靠 Activated 狀態標籤並不能保證訊息通路已經完全恢復。

IOSOR 要點

復原週:訊息回來是路徑測試,不是徽章翻轉。確保預付錢包餘額充足,並檢查控制台日誌以驗證 Webhook 和 DLR 狀態。

要做:重新指派前做入站回報與出站 DLR 測試。檢查預付錢包餘額是否高於 USD 20 的最低線。不要:凍結後憑 Activated 狀態就把租戶接回去,忽略了實際的訊息通路驗證和預算限制。

這篇指南有幫助嗎?

相關指南