テストとビジネスアカウントのために Zoho の SMS コードを受信する

状況: Zoho の画面が携帯電話番号を求めている

チームがこのステップに出会う場面は、だいたい決まっています。連携開発者は、CRM、Books、Desk に対する OAuth 接続をテストするために、新しい Zoho アカウントが必要です。代理店は、クライアントのために Zoho Mail と Zoho One を設定しますが、従業員の個人の電話を管理者ログインに紐づけたくありません。QA リードは、ドバイのユーザーとシドニーのユーザーでサインアップのフローが同じように動作することを証明しなければなりません。いずれの場合も、障害になるのは同じ 1 通のテキストメッセージで、必要な本人が適切な国の SIM を手元に持っていることはまずありません。

OTP Route は、そのメッセージを、ツールからリクエストし、待機し、読み取れるものに変えます。

Zoho は電話認証をどこで利用しますか？

Zoho は、新しいアカウントを作成するときに携帯電話番号を求めるのが一般的で、サインイン時には認証アプリと並んで SMS を第 2 要素として使うこともあります。確認済みの番号は、パスワードを紛失したときのアカウント復旧にも使われます。コードが要求されるタイミングは、プロダクト、アカウントの地域、管理者が選んだセキュリティ設定によって変わるため、プロンプトが表示される場合も表示されない場合も許容できるテストを作ってください。

Zoho 用の番号の国を選ぶ

zoho サービスは、現在 198 か国でルーティングされています。作成またはテストするアカウントの市場に番号を合わせてください。国によって、Zoho が想定するダイヤルコード、メッセージの言語、そして場合によってはアカウントが割り当てられる地域のデータセンターが変わるためです。

よく選ばれるルートは、インド、アメリカ、イギリス、アラブ首長国連邦、オーストラリア、ドイツです。一覧には、ほかにカナダ、ブラジル、メキシコ、シンガポール、サウジアラビア、南アフリカ、オランダ、スペイン、フランス、日本、インドネシア、マレーシア、ケニアもあります。提供状況は 1 日の中で変わるため、実行の開始時に GET /api/v1/countries から取得してください。

Zoho 認証コード API をテストに組み込む

呼び出しは https://otproute.com/api/v1 に、開発者コンソールで発行した Bearer キーを付けて送ります。

1. GET /api/v1/prices?country=<id>&service=zoho で料金を取得します。
2. POST /api/v1/activations に {"service": "zoho", "country": "<id>"} を送ってアクティベーションを作成します。
3. ブラウザ自動化で、返された番号を Zoho のフォームに入力し、コードを要求します。
4. アクティベーション ID をキーとする activation.sms_received イベントを、Webhook エンドポイントで待ちます。

ハンドラーを信頼できるものにする習慣が 2 つあります。1 つ目は、エンドポイントのシークレットで "<t>.<raw body>" に対する HMAC-SHA256 を計算して X-OTPRoute-Signature を検証し、古いタイムスタンプを拒否することです。2 つ目は、ハンドラーを冪等にすることです。アクティベーション ID を記録し、再配信されたイベントは無視することで、コードが 2 回送信されることを防ぎます。テストランナーが受信トラフィックを受けられない場合は、代わりに GET /api/v1/activations/{id} をポーリングし、1 分あたり 300 リクエストを下回るようにしてください。両方のパターンはWebhook による取得ガイドで紹介しています。

ダッシュボードで手動で行う

単発のセットアップでは、OTP Gateway を開いて Zoho を選び、国を選び、表示された料金を確認して確定します。番号を Zoho にコピーし、コードを送信するボタンを押して、アクティベーションを開いたままにします。コードが届くと画面に表示されます。時間は 20 分で、何も届かない場合やキャンセルした場合は、全額がウォレットに戻ります。

Zoho の OTP が届かない理由

コードが届かない原因は、たいていありふれたものです。

• Zoho は、一部の地域やアカウントの種類で仮想番号を拒否することがあります。それは Zoho 側の判断であり、返金が自動で行われる理由でもあります。
• その国のルートがその時点で混雑している可能性があります。時間を置くか、テストに合う別の国で再試行してください。
• 同じブラウザセッションからの繰り返しの要求は、Zoho 自身にレート制限されることがあるため、試行の間隔を空けてください。
• 新しいアクティベーションを短い間隔で次々に注文しても効果はなく、API の利用枠を消費するだけです。

ルートが失敗したと結論づける前に、ウィンドウが切れるのを待ってください。

Dedicated Number のほうが適しているのはどんなときですか？

アカウントの作成とテストには、1 回限りのアクティベーションが適切です。来月また SMS を求められる管理者ログインには向きません。その番号は後でご自身のものではなくなるためです。その場合は、1 か月 $1.95 からの Dedicated Number で、更新を続ける限り保持できる米国またはカナダの回線を持てます。受信 SMS はダッシュボードに表示され、Webhook にも転送されます。専用回線を提供しているのは、この 2 か国だけです。詳しくは仮想番号をご覧ください。

Zoho の番号を責任を持って使う

Zoho の規約を守ってください。アカウントは実在する 1 人または 1 社につき 1 つとし、OTP Route は、ご自身の正当なプロダクトやクライアントのアカウントのテストと運用にのみ使い、サインアップを大量に作るために使ってはいけません。OTP Route は Zoho と提携しておらず、Zoho の名称は所有者の商標です。すべてのアクティベーションに Acceptable Use Policy が適用されます。複数のクライアントを管理する代理店は、代理店向けソリューションのページをご覧ください。

よくある質問

API で Zoho の OTP を受け取るには？

サービス ID zoho と選んだ国でアクティベーションを作成し、activation.sms_received Webhook またはアクティベーションのポーリングでコードを取得します。

Zoho の SMS 認証テストに仮想番号を使えますか？

多くの場合は使えますが、Zoho が仮想番号を拒否することもあります。20 分以内にコードが届かなければ、料金は返金されます。

Zoho のコード 1 つ分の電話番号はいくらですか？

1 コード $0.20 からです。国ごとのリアルタイムの料金は、料金エンドポイントが返し、ダッシュボードにも表示されます。

Zoho のテストアカウントにはどの国を選ぶべきですか？

テスト対象のユーザーや市場の国を選んでください。そうすれば、ダイヤルコードとメッセージの言語が実際のケースと一致します。

今後の Zoho ログインのために同じ番号を保持できますか？

1 回限りのアクティベーションでは保持できません。あとで再認証が必要になるアカウントには、米国またはカナダの Dedicated Number が選択肢になります。

ウォレットの資金を使わずにフローをテストできますか？

はい。リクエストに応じて、開発用アカウントをサンドボックスに切り替えられます。シミュレートされた番号とコードが返されます。詳しくはドキュメントをご覧ください。

サービス名はそれぞれの所有者の商標です。OTP Route はこれらの企業と提携していません。番号は合法的にご利用いただき、各サービスの利用規約および当社の利用規定に従ってください。