场景:Zoho 页面正在要求输入手机号码
团队通常会在几种可预见的情况下遇到这一步。集成开发人员需要一个全新的 Zoho 账号,来测试与 CRM、Books 或 Desk 的 OAuth 连接。代理机构为客户设置 Zoho Mail 和 Zoho One,不希望把员工的个人手机绑定在管理员登录上。QA 负责人要证明注册流程对迪拜用户和悉尼用户的表现一致。在每种情况下,卡住的都是同一条短信,而需要它的人手里往往没有对应国家的 SIM 卡。
OTP Route 把这条短信变成了你的工具可以请求、等待和读取的东西。
Zoho 在哪些环节依赖手机验证?
Zoho 通常在创建新账号时要求提供手机号码,登录时也可以把短信作为第二重因素,与其验证器应用并用。已验证的号码还会在密码丢失时用于账号找回。验证码具体何时被请求,取决于产品、账号所在地区以及管理员选择的安全设置,因此请编写能同时容忍提示出现或不出现的测试。
为 Zoho 号码选择国家
zoho 服务目前在 198 个国家有线路。请让号码与你创建或测试的账号所在市场相匹配,因为国家会影响 Zoho 期望的拨号代码、短信语言,有时还会影响账号落在哪个区域数据中心。
常选的线路包括印度、美国、英国、阿拉伯联合酋长国、澳大利亚和德国。列表中的其他国家有加拿大、巴西、墨西哥、新加坡、沙特阿拉伯、南非、荷兰、西班牙、法国、日本、印度尼西亚、马来西亚和肯尼亚。可用情况在一天中会变化,所以请在运行开始时通过 GET /api/v1/countries 读取。
把 Zoho 验证码 API 接入你的测试
调用发往 https://otproute.com/api/v1,使用开发者控制台里的 Bearer 密钥。
- 用
GET /api/v1/prices?country=<id>&service=zoho获取价格。 - 创建激活:
POST /api/v1/activations,请求体为{"service": "zoho", "country": "<id>"}。 - 让你的浏览器自动化把返回的号码输入 Zoho 表单并请求验证码。
- 在你的 webhook 端点等待以激活 id 为键的
activation.sms_received事件。
有两个习惯能让处理程序更可靠。第一,校验 X-OTPRoute-Signature:用端点密钥对 "<t>.<raw body>" 计算 HMAC-SHA256,并拒绝过期的时间戳。第二,让处理程序保持幂等:记录激活 id 并忽略重复投递,这样验证码就不会被提交两次。如果你的测试运行器无法接收入站流量,则改为轮询 GET /api/v1/activations/{id},并保持在每分钟 300 次请求以下。webhook 捕获指南展示了这两种模式。
在控制台手动操作
对于一次性的设置,打开 OTP Gateway,选择 Zoho,选择国家,查看显示的价格并确认。把号码复制到 Zoho,点击发送验证码的按钮,并保持激活处于开启状态。验证码到达时会显示在屏幕上。你有 20 分钟时间;如果没有任何短信到达,或者你取消了订单,全部金额会退回你的钱包。
为什么 Zoho OTP 可能收不到
验证码缺失通常有很普通的原因:
- Zoho 可能在某些地区或账号类型上拒绝虚拟号码。这是它的决定,也是退款自动执行的原因。
- 该国线路此刻可能拥堵。稍后重试,或选择另一个符合测试的国家。
- 来自同一浏览器会话的重复请求可能被 Zoho 自身限流,所以请拉开尝试的间隔。
- 在紧密循环中不断下新的激活没有帮助,还会消耗你的 API 额度。
在断定某条线路失败之前,请先让时间窗口走完。
什么时候专用号码是更好的选择
一次性激活适合创建和测试账号。但对于下个月还会再次要求短信验证的管理员登录来说,它并不合适,因为那个号码以后不再属于你。针对这种情况,$1.95/月起的专用号码会给你一条美国或加拿大的号码,续费期间由你持有,来信短信显示在控制台并转发到你的 webhook。专用号码仅在这两个国家提供。更多内容请见虚拟号码。
负责任地使用 Zoho 号码
请遵守 Zoho 的条款。每位真实用户或每家企业创建一个账号,并使用 OTP Route 来测试和运营你自己的合法产品与客户账号,绝不能用于批量制造注册。OTP Route 与 Zoho 没有关联,Zoho 这一名称是其所有者的商标,《可接受使用政策》适用于每一次激活。管理多个客户的代理机构可以阅读代理机构解决方案页面。
常见问题
如何通过 API 接收 Zoho OTP?
用服务 id zoho 和你选定的国家创建激活,然后从 activation.sms_received webhook 或通过轮询该激活来读取验证码。
我可以用虚拟号码做 Zoho 短信验证测试吗?
通常可以,但 Zoho 在某些情况下可能拒绝虚拟号码。如果 20 分钟内没有验证码到达,费用会退回。
一次接收一条 Zoho 验证码的手机号码要多少钱?
每条验证码 $0.20 起。各国实时价格由价格接口返回,并显示在控制台中。
测试 Zoho 账号应该选择哪个国家?
选择你所测试的用户或市场所在的国家,这样拨号代码和短信语言才与真实情况一致。
以后的 Zoho 登录可以继续使用同一个号码吗?
一次性激活不行。对于以后还需要再次验证的账号,美国或加拿大的专用号码是合适的选择。
可以不花钱包里的资金来测试这个流程吗?
可以。开发账号可按要求切换到沙盒,它会返回模拟号码和验证码。详情请见文档。
服务名称均为其各自所有者的商标,OTP Route 与其无任何关联。请合法使用号码,并遵守各服务的条款及我们的可接受使用政策。