處理即時 (JIT) 號碼配置 Webhook 事件

處理即時 (JIT) 號碼配置 Webhook 事件。

深入理解 JIT 配置生命週期

即時 (JIT) 配置允許您的平台根據需求動態分配入站通訊管道。當使用者觸發採購請求時，IOSOR 會發送包含 E.164 號碼詳細資訊的 Webhook 事件。此事件表示該管道已準備就緒，可立即掛載至您的應用程式邏輯，例如 OTP 發送或簡訊路由。透過即時處理這些事件，您無需手動管理庫存，確保基礎設施能隨使用者群體同步擴展。在配置過程中，系統會執行檢查以確保資源的唯一性與可用性，避免重複分配導致的衝突，並確保所有資源狀態與您的後端資料庫保持高度一致。

為規模化配置 Webhook 端點

若要接收 JIT 事件，您必須在 IOSOR 控制台中註冊一個安全的 HTTPS 端點。請確保您的伺服器能在嚴格的超時視窗內以 200 OK 狀態碼確認接收。若系統未能回應，平台將根據指數退避策略進行重試。這能確保您的帳本與已配置資產的實際狀態保持同步，防止計費或管道可用性出現偏差。建議在端點實作請求驗證機制，使用簽章驗證來確保訊息來源的真實性，並記錄所有接收到的事件日誌以供後續稽核，同時確保您的 Webhook 處理邏輯能處理高併發請求，避免因處理延遲導致的事件堆積。

管理預付餘額與帳本狀態

IOSOR 採用預付模式，要求維持至少 USD 20 的預付餘額以維持服務啟用。當 JIT 事件觸發時，系統會在完成分配前驗證您的可用餘額。若您的每月支出接近 USD 1,000/月，帳戶可能會進行軟審核以確保服務連續性。請務必監控您的帳本狀態，確認新配置號碼的每月循環費用 (MRC) 已正確從預付餘額中扣除。若餘額不足，系統將暫停配置程序並發送通知，請務必設定低餘額警示以防服務中斷。預付錢包餘額的即時更新對於維持業務連續性至關重要，建議將餘額監控整合至您的儀表板中。

處理 E.164 格式與 DLR 邏輯

每個 JIT Webhook 負載皆包含 E.164 格式的號碼。您的應用程式必須解析此字串，將管道映射至正確的使用者帳戶或服務。一旦號碼分配完成，即可開始處理流量，包括簡訊與 DLR 通知。若使用者發送 STOP 指令，您的系統應監聽對應事件以更新管道狀態，確保符合簡訊規範並防止產生不必要的費用。處理 DLR 時，請確保您的資料庫能正確處理非同步更新，並將狀態碼對應至您的業務邏輯中。DLR 的真實性是確認訊息送達的唯一依據，務必將其作為業務邏輯的核心參考資料。

靜默時段與 opt-out 同步機制

為了優化使用者體驗並符合法規，我們強烈建議實作「安靜時段」邏輯，避免在深夜發送非緊急簡訊。此外，當使用者透過回覆 STOP 觸發 opt-out 時，您的系統必須立即同步此狀態至 IOSOR，以確保該管道自動排除在後續的行銷活動之外。此同步機制能有效降低客訴率，並維護您的傳輸聲譽。請務必在資料庫中標記這些 opt-out 狀態，並定期執行清理作業，確保您的發送清單始終保持最新狀態，避免向已拒絕接收的使用者發送訊息。

相關閱讀: 將 DLR 狀態 Webhook 與預付扣款進行關聯 · 重複的 Webhook 絕不能導致二次扣款 · 首次扣款前的預付資金保留.

從 IOSOR 開始

請前往 IOSOR 控制台的 Webhooks 區段，以設定用於即時分派事件的 HTTPS 接聽程式。請確保您的伺服器會驗證 webhook 簽章，並在逾時期限內回覆 HTTP 200 OK。設定完成後，將 E.164 酬載直接對應至您的使用者路由邏輯，即可動態附加入局通道。

IOSOR 要點

透過 webhooks 自動化即時號碼佈建，能夠實現瞬間啟用通道而無須輪詢延遲。立即確認事件傳遞，可讓您的整合在大量獲取期間維持強固性，同時保有已分派庫存的完整可稽核性。

請將 webhook 的 HTTP 確認與內部應用程式處理解耦，以確保能快速回應 200 OK。切勿在 webhook 執行期間同步處理長時間執行的工作，亦不可忽略酬載簽章驗證。