产品团队为什么要针对肯尼亚市场做测试?
内罗毕是东非最繁忙的科技中心之一,而肯尼亚用户是彻底的移动优先人群。对他们中的许多人来说,手机号是通讯、网约车、电商,尤其是移动支付背后的主要身份标识,因此处理不好 +254 号码的注册流程,第一天就会流失客户。
英语和斯瓦希里语都是官方语言。大多数全球应用以英语发送验证码,而针对该地区本地化的产品可能改用斯瓦希里语,如果你自己的模板已翻译,这一点值得检查。在这里做测试的常见原因:
- 在东非推出金融科技、配送或市场平台类产品;
- 验证短信模板和引导页面中的斯瓦希里语文案;
- 为肯尼亚客户运行客服或运营账号,同时不暴露员工的号码。
我们的金融科技注册引导页面介绍了更广泛的模式。
肯尼亚手机号的 E.164 怎么写?
在当地,手机号带中继前缀 0 书写,如 07XX XXX XXX 或 01XX XXX XXX。在国际格式中零被去掉:+254 后接九位用户号码。
经典的缺陷是在国家代码之后仍保留那个零,拼出无效的 +2540... 字符串,发送方会在没有明确报错的情况下拒绝它。请在每个输入进入数据库之前先做规范化:
- 去掉空格、连字符和括号。
- 如果值以
0开头,就去掉它并在前面加上+254。 - 如果以
254开头但没有加号,就补上加号。 - 将结果存储为 E.164 字符串,并在规范化之后校验长度。
用 +254 号码做测试,就很容易借助真实的入站短信来证明这套逻辑的每个分支。
肯尼亚线路上目前有哪些服务?
肯尼亚的目录相当丰富,实时快照中有超过 2,800 种服务。常被请求的包括 WhatsApp、Telegram、Google(Gmail 和 YouTube)、Facebook、Instagram、TikTok、X(Twitter)、ChatGPT(OpenAI)、Microsoft 和 Outlook、Uber、LinkedIn、Signal 以及 Netflix。
可用性可能每小时都在变化,这就是 API 实时报告它,而不是提供固定列表的原因。
如何把肯尼亚 OTP API 接入测试套件?
使用开发者控制台中以 or_live_ 为前缀的 Bearer 密钥,对 https://otproute.com/api/v1 进行认证。肯尼亚的国家 id 是 ke。
典型的 CI 步骤会先调用 GET /api/v1/balance,让运行在钱包为空时快速失败。然后检查 GET /api/v1/prices?country=ke&service=<id>,用 POST /api/v1/activations 下单,请求体类似 {"service": "uber", "country": "ke"},并把返回的 +254 号码输入被测应用。验证码要么通过 activation.sms_received Webhook 返回,要么每隔几秒轮询 GET /api/v1/activations/{id} 获取,完全处于每分钟 300 次请求的额度之内。
使用 Webhook 时,最多可注册 5 个端点,并通过用端点密钥对 <t>.<raw body> 计算 HMAC-SHA256 来验证 X-OTPRoute-Signature,同时拒绝过期的时间戳。让处理程序以 activation id 为键,这样重试的投递不会造成问题。CI 测试指南展示了它如何融入流水线,文档中有完整的参考。
不写代码也能订购 +254 号码吗?
可以。在控制台中打开 OTP Gateway,选择肯尼亚,选择服务并确认显示的价格。号码会立即出现;把它粘贴到注册或登录表单中,一收到验证码,它就会显示在激活项旁边。客服人员和客户经理可以这样操作,而工程师则在同一个钱包上使用 API。
肯尼亚验证码延迟或缺失时怎么办?
每次激活都有 20 分钟的窗口。只有验证码到达时你才需要付费;当窗口结束仍然为空,或者你用 POST /api/v1/activations/{id}/cancel 取消时,金额无需工单即可退回钱包。
重试之前,先给窗口一些时间,因为有些发送方会让消息排队。如果仍然失败,请稍后再试或换用另一条服务线路,并检查该应用是否接受虚拟号码,因为有些不接受。避免在紧凑的循环里反复调用下单接口;许多发送方会限制对同一流程的重复请求。我们关于减少 OTP 投递失败的文章汇集了更多解决办法。请让每次测试都符合目标服务的条款;OTP Route 的《可接受使用政策》同样适用。
肯尼亚项目的长期线路、钱包与沙盒
OTP Route 不销售自助的长期肯尼亚号码。专用线路仅在美国和加拿大提供,起价 $1.95/月,支持收短信、发短信和浏览器通话。需要长期 +254 线路的团队可以发邮件到 [email protected] 询问,不过能否提供取决于当地规定。
付款采用按用量付费的单一美元钱包,可通过银行卡或 USDT、USDC 稳定币充值,每次充值都会生成 PDF 发票。没有月费;费用如何显示请参阅定价。开发账号可应要求切换到沙盒模式,返回模拟的号码和验证码用于端到端集成测试,不消耗钱包余额。
常见问题
我能在肯尼亚境外测试应用的肯尼亚注册流程吗?
可以。从 OTP Gateway 订购 +254 号码,无论团队身在何处,都能在控制台或通过 API 读取收到的验证码。
肯尼亚应该传哪个国家 id?
在价格查询和激活请求体中传 ke,例如 {"service": "whatsapp", "country": "ke"}。
存储肯尼亚号码时要保留开头的 0 吗?
不要。去掉中继前缀 0,把号码存储为 +254 加九位数字。
肯尼亚的验证短信会以斯瓦希里语送达吗?
通常是英语,但针对肯尼亚本地化的应用可能会发送斯瓦希里语,所以如果你的模板已翻译,请两种都检查。
如果验证码一直没到,我的钱会怎样?
20 分钟窗口结束仍没有短信时会自动退回你的钱包,取消时则立即退回。
+254 验证码用 Webhook 还是轮询更好?
Webhook 更适合并行的测试任务,而轮询 GET /api/v1/activations/{id} 对单个脚本来说更简单。两者读取的是同一个激活。
我能获得一个每月都保留的肯尼亚号码吗?
自助方式不行。专用号码仅限美国和加拿大;如果你需要肯尼亚线路,请发邮件到 [email protected]。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。