eSIM

安装 eSIM 和激活套餐是同一回事吗?

安装是将数字 SIM 添加到设备;激活和套餐有效期的起算遵循所选服务的规则。

客户在手机上看到 “installed”,在应用中看到 “pending”。这些标签描述的可能是不同的观测结果。设备、网络和购买记录并不共享同一个统一状态。

客户需要了解哪些步骤?

运营商提供一份数字 SIM 配置文件,其中包含设备连接网络所需的移动身份和凭据。安装就是将该配置文件添加到设备。已购套餐决定客户可以使用哪些服务。

客户可能需要启用配置文件。客户也可能需要将其选为移动数据使用的 SIM。客户还需遵循套餐的漫游说明。

连接到覆盖网络并使用数据是后续结果。成功结账只确立了购买结果,并不能证明这些设备端步骤已经完成。

套餐何时开始生效?

所选产品定义了触发套餐生效的事件和有效期。你的应用必须在客户决定何时安装之前展示这些条款。

对于出发前提前准备的客户,将在家即可完成的步骤与需要到达目的地覆盖网络后才能完成的步骤区分开。

为什么显示的状态会不同?

Gigs 在缺少生命周期信息时,会将配置文件状态报告为未知。你的应用应继续显示该状态。缺少信息并不能证明安装成功或失败。

Gigs 的配置文件生命周期中,状态响应可能跳过某些阶段。如果设备失去连接,Gigs 的配置文件已禁用事件可能延迟到达。显示已上报的状态及其观测时间。如果其中任何一项不可用,保持该缺失可见。

在你的安装流程中,在客户验证连接成功之前,始终保留设置说明。仅凭购买确认无法确定该结果。

简而言之

  1. 安装针对的是设备配置文件。

    配置文件可以存在于手机上,但预期的网络服务并未投入使用。

  2. 产品定义有效期规则。

    产品规定触发套餐生效的事件及其有效期。

  3. 缺少观测记录不等于安装失败。

    将不可用的状态显示为未知,并保持观测时间可见。

付诸实践。

继续查阅此主题的文档、指南和示例。资源为英文。

获取实施简报

使用 Bird 构建您的移动服务。

准备好您的目标市场、套餐需求和客户旅程。借助 Bird 探索移动连接,启动您的首个服务。

从一个渠道开始。
准备好后,再添加其他渠道。

测试 API 密钥即刻可用。添加支付方式并验证发送者身份后,即可解锁生产环境。

正在使用 Claude Code、Cursor 或 Codex?复制一条设置提示,您的智能代理即可自动安装 Bird CLI 和相关技能。选择您的工具:

Cursor