处理即时 (JIT) 号码配置 Webhook 事件

处理即时 (JIT) 号码配置 Webhook 事件。

理解 JIT 配置生命周期

即时 (JIT) 配置允许您的平台根据需求动态分配入站渠道。当用户触发获取请求时，IOSOR 会发出一个包含 E.164 号码详情的 Webhook 事件。此事件标志着渠道已准备好立即附加到您的应用程序逻辑，例如 OTP 交付或短信路由。通过实时处理这些事件，您无需进行繁琐的手动库存管理，确保基础设施随着用户群的增长而扩展。在生命周期中，系统会进行即时状态检查，确保号码处于可用状态，并立即触发配置流程，将号码绑定至您的应用端点，从而减少从请求到激活的延迟。

为规模化配置 Webhook 端点

要接收 JIT 事件，您必须在 IOSOR 控制台中注册一个安全的 HTTPS 端点。请确保您的服务器已准备好在严格的超时窗口内以 200 OK 状态码确认接收。如果您的系统未能响应，平台将根据指数退避策略尝试重试。这确保了您的账本与已配置资产的实际状态保持同步，防止计费或渠道可用性方面的差异。建议实施请求验证机制，检查签名头以确保数据的完整性与来源的可信度，避免未经授权的请求干扰您的自动配置逻辑。

管理预付费余额与账本状态

IOSOR 基于预付费模式运作，要求最低 USD 20 的预付费余额以维持服务活跃。当 JIT 事件触发时，系统会在最终分配前验证您的可用余额。如果您的月度支出接近 USD 1,000/月，您的账户可能会接受软审核以确保服务连续性。请务必监控您的账本状态，以确认新配置号码的月度经常性费用 (MRC) 已从您的预付费余额中正确扣除。如果余额不足，系统将暂停分配流程，并向您的监控系统发送警报，以便及时充值，避免中断业务。

值班交接时把判定标准写进同一份说明：谁看 DLR、谁对账、谁能暂停路由。峰值前按清单复核。

对账或导出必须带同一 intent 或 session 键，方便财务回放。

上线前先跑窄走廊冒烟，确认闸门与回退触发后再放宽目的地。

处理 E.164 格式与 DLR 逻辑

每个 JIT Webhook 有效载荷都包含 E.164 格式的号码。您的应用程序必须解析此字符串，以将渠道映射到正确的用户账户或服务。一旦号码分配完成，您就可以开始处理流量，包括短信和 DLR 通知。如果用户发送了 STOP 命令，您的系统应监听相应的事件以更新渠道状态，确保符合消息传递法规并防止不必要的扣费。此外，针对 DLR 状态码的解析应具备健壮性，以便区分传输失败与用户侧拒收，从而优化您的流量路由策略。

基本集成协议

为了维持稳健的集成，您必须实施特定的安全与状态管理实践。请参考以下文档以确保您的实现符合我们的标准：

• 首次发送前的 webhook 契约
• 签名与重放窗口网关
• 报价单与账本附注中的目录状态

您的系统应定期核对账本记录与 Webhook 事件日志，以识别任何潜在的配置差异，并确保所有 API 调用都包含必要的安全令牌。

从 IOSOR 开始

请前往 IOSOR 控制台的 Webhook 模块，配置用于即时分发事件的 HTTPS 监听器。请确保您的服务器能够验证 Webhook 签名，并在超时时间内返回 HTTP 200 OK 状态码。配置完成后，直接将 E.164 格式的负载映射到您的用户路由逻辑中，以动态挂载入站通道。

IOSOR 要点

通过 Webhook 自动按需配置号码能够实现即时通道激活，彻底消除轮询延迟。及时确认事件投递可确保集成在高并发采集期间保持稳定，同时保留所分配资产的完整审计能力。

建议将 Webhook 的 HTTP 确认与内部应用处理解耦，以确保快速响应 200 OK。切勿在 Webhook 执行窗口内同步处理耗时任务，亦不可忽略负载签名验证。