为什么委内瑞拉号码开头的 0 会引发 Bug？
委内瑞拉的国家代码是 +58，国内号码书写时带有干线前缀 0。在国内拨打时，手机号形如 0412、0414、0416、0424 或 0426，后面再跟七位数字。转换成 E.164 格式时这个 0 要去掉：0414 123 4567 应变成 +584141234567。
最典型的缺陷是表单直接把 +58 拼在用户输入的内容前面，得到 +580414…，任何服务都不会接受。可以这样防范：
- 当所选国家为委内瑞拉时，先去掉开头的一个 0，再添加国家代码；
- 只存储规范化后的 E.164 字符串，显示时再另行格式化；
- 增加一个测试用例：输入本地写法，并断言最终存储的值。
从 OTP Gateway 获得的 +58 测试号码本身就是国际格式，正好可以作为这些断言的参考值。
本地化 QA 应该检查委内瑞拉用户的哪些方面？
西班牙语是官方语言，也是大多数委内瑞拉用户期望看到的语言。全球平台发送的验证短信通常跟随账号或设备的区域设置，所以设置不同时，测试人员可能今天收到西班牙语、明天收到英语。编写提取逻辑时，应当识别数字本身，而不是依赖数字周围的文字。
在你自己的产品一侧，请检查手机号输入页和验证码输入页的拉美西班牙语文案、号码无效时的错误提示，以及重新发送倒计时的文字。这些字符串恰恰出现在用户最容易放弃注册的时刻。
委内瑞拉号码对产品团队有什么意义？
委内瑞拉有庞大的海外侨民，分布在拉丁美洲、西班牙和美国，许多人搬家后仍保留 +58 的 SIM 卡。因此，委内瑞拉号码的意义远不止这个国家本身：
- 跨境注册：用户在国外用本国号码注册，你的国家识别逻辑不能把它拒之门外。
- 以即时通讯为先的客服：聊天应用是人们联系企业的主要方式，团队会用这种方式验证 WhatsApp 和 Telegram 的企业账号设置。
- 区域发布：面向南美洲的上线需要在发布清单中包含一条真实的 +58 路径。
- 代理机构：为委内瑞拉品牌运营社交账号，希望验证码进入共享工具，而不是经理的个人手机；参见代理商与分销商。
OTP Gateway 在委内瑞拉覆盖哪些服务？
委内瑞拉号码上可用的服务超过 1,700 个。常被请求的包括 WhatsApp、Telegram、Google（Gmail 与 YouTube）、Facebook、Instagram、TikTok、X（Twitter）、ChatGPT（OpenAI）、Claude、Microsoft 与 Outlook、Amazon、Discord 和 LinkedIn。请把它当作随时变化的快照：各服务在各国家的可用性会在一天中不断重新计算，并始终由 API 实时返回。
如何在测试执行器中调用委内瑞拉 OTP API？
所有请求都发往 https://otproute.com/api/v1，并携带前缀为 or_live_ 的 Bearer 密钥。请在开发者控制台中按环境分别生成密钥（上限为 10 个）。委内瑞拉的国家 id 是 ve。
- 每次运行时通过
GET /api/v1/services和GET /api/v1/countries把易读名称映射为 id。 - 下单之前先调用
GET /api/v1/prices?country=ve&service=<id>，让测试知道当前价格以及该组合是否可用。 - 通过
POST /api/v1/activations下单，请求体例如{"service": "whatsapp", "country": "ve"}。 - 把返回的 +58 号码填入被测页面。
- 在 Webhook 上接收
activation.sms_received，或轮询GET /api/v1/activations/{id}；如果流程中途中止，在清理阶段调用POST /api/v1/activations/{id}/cancel。
测试套件启动时检查一次 GET /api/v1/balance。使用 Webhook 时，用端点密钥对 <t>.<raw body> 计算 HMAC-SHA256，以此校验 X-OTPRoute-Signature（t=<unix>,v1=<hex>），并拒绝过期的时间戳。每个账号允许 5 个 Webhook 端点，每分钟 300 次请求。流水线的做法请见 CI 流水线中的短信 OTP 测试和 API 文档。
手动下单，以及验证码迟迟不来怎么办
在控制台中操作很简单：选择委内瑞拉，选择服务，确认价格，在应用中使用该号码，然后在屏幕上等待验证码。产品经理和客服负责人无需写代码就能快速检查一次。
每次激活都有 20 分钟 的窗口。若到时仍没有短信，或者你取消了订单，全部费用会自动退回钱包；你只为收到的验证码付费。到达时间取决于服务和线路。如果验证码迟到，请让窗口走完，然后稍后重试，或换用其他服务线路，而不要循环重复下单。同时检查该服务在这一操作上是否拒绝虚拟号码，因为有些服务确实会拒绝。请遵守各服务的条款；OTP Route 的《可接受使用政策》始终适用。
我能长期持有 +58 号码吗？钱包如何充值？
自助方式不行。专用虚拟号码（Dedicated Virtual Numbers）从 $1.95/月 起，只能即时购买美国和加拿大的号码（参见虚拟号码）。如果团队需要长期使用的委内瑞拉线路，可以发邮件至 [email protected] 咨询；能否提供取决于当地法规。
付款方式为按量付费，使用同一个预付美元钱包，没有套餐，也没有月费。可通过银行卡或 USDT/USDC 充值，每次充值都会通过电子邮件收到 PDF 发票。开发账号可按需申请切换到沙盒，沙盒会返回模拟号码和验证码，用于端到端集成测试。费用请对照价格页。
常见问题
没有委内瑞拉 SIM 卡，也能测试委内瑞拉的注册流程吗？
可以。在 OTP Gateway 下单一个 +58 号码，填入你的应用，验证码会显示在控制台，或送达你的 Webhook。
委内瑞拉在 OTP Route API 中的 id 是什么？
是 ve。在 GET /api/v1/prices 中使用它，也可作为创建激活时的 country 值。
存储委内瑞拉手机号时应该保留开头的 0 吗？
不应该。去掉国内干线前缀 0，存储为 +58 加其余数字，例如 +58414 后面再跟七位数字。
委内瑞拉验证号码多少钱？
每个验证码 $0.20 起；下单前 API 和控制台会显示各服务的确切价格。未使用的激活会退款。
为什么我的委内瑞拉验证码是英文的？
语言由发送方服务决定，通常取决于账号或设备的区域设置。请解析数字本身，不要依赖短信的措辞。
委内瑞拉有专用的长期号码吗？
没有自助选项；专用线路是仅限美国和加拿大的产品。你可以发邮件至 [email protected] 咨询委内瑞拉的情况。
OTP Route 能用来绕过平台的限制吗？
不能。它仅用于测试和运营你自己合法的产品与账号，每个真实的个人或企业一个账号，并遵守各服务的条款。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。