日本語
社員の個人スマホを使わずに WhatsApp の認証コードを受け取る
OTP Route で WhatsApp の認証コードを受信するには、OTP Gateway で必要な国の WhatsApp 用番号を注文し、WhatsApp の登録画面に入力して、ダッシュボードまたは Webhook でコードを確認します。料金は 1 コード $0.20 からで、20 分の有効時間内に SMS が届かなければ全額がウォレットに戻ります。
なぜ誰の個人所有でもない WhatsApp 番号が必要になるのか？
よくある状況です。プロダクトチームが WhatsApp 上でサポートフローを構築したり、アプリからチャットへの引き継ぎをテストしたりするとき、誰かがアカウントを登録しなければなりません。いちばん手っ取り早いのは同僚の個人スマホですが、それでは業務の設定が一人の SIM に依存し、テスト用の通信がその人の私的な会話と混ざり、本人が退職した日に使えなくなります。
クライアント向けに WhatsApp を設定するエージェンシーも同じ壁に当たりますし、特定の市場で地域向けオンボーディングの挙動を確認したい QA エンジニアも同様です。OTP Gateway の WhatsApp 用電話番号を使えば、その作業を誰かの個人回線から切り離せます。国を選び、登録コードを受け取って、次の作業に進むだけです。
WhatsApp はいつ電話認証コードを求めるのか？
WhatsApp は電話番号でアカウントを識別するため、いくつかの場面でワンタイムコードによりその番号を管理していることを確認します。
- 新規登録: 新しいアカウントには SMS で 6 桁のコードが届きます。代わりに音声通話が提案されることもあります。
- 新しい端末: アプリを再インストールしたり別の端末へ移したりすると同じ確認が行われ、以前の端末はサインアウトされます。
- ビジネスアカウント: WhatsApp Business アプリを番号に設定する際も、同じ手順を踏みます。
- 2 段階認証: ユーザーが任意に決める PIN です。SMS では送られませんが、有効にしている場合はコードと合わせて入力を求められます。
テストの観点では単純です。SMS はその時点で番号を保有していることの証明なので、すでに手放した番号では後からアカウントを認証できません。
WhatsApp の認証コード API はどのように動くのか？
サービス ID whatsapp を、テスト対象の市場の国 ID（in、br、us など）と組み合わせて使います。Developer console で発行した Bearer キーを用意してください。
GET /api/v1/prices?country=<id>&service=whatsappで、現在の料金とそのルートが今利用できるかどうかを確認します。POST /api/v1/activationsに{"service": "whatsapp", "country": "<id>"}を送ると、番号が確保され 20 分の有効時間が始まります。- 番号を WhatsApp の登録画面に入力し、SMS を要求します。
- コードは
activation.sms_receivedWebhook イベントで届きます。あるいはGET /api/v1/activations/{id}を数秒おきにポーリングします。 - 実行を取りやめる場合は
POST /api/v1/activations/{id}/cancelで金額がウォレットに戻ります。
本文を信頼する前に X-OTPRoute-Signature を検証してください。エンドポイントのシークレットで <t>.<raw body> の HMAC-SHA256 を計算して v1 と比較し、古すぎるタイムスタンプは拒否します。そのうえで、イベントをアクティベーション ID に紐づけて記録し、同じ通知が再送されても結果が変わらないようにします。テストランナーが公開 URL を用意できない場合は、ポーリングのほうが簡単です。どちらの方法も開発者向けドキュメントで説明しています。
WhatsApp 用の番号はどの国で使えるのか？ 国の選択は重要か？
WhatsApp のルートは現在 198 か国で利用でき、インド、ブラジル、インドネシア、ナイジェリア、ドイツのほか、メキシコ、英国、米国、パキスタン、フィリピン、エジプト、ケニア、スペイン、トルコ、南アフリカなどが含まれます。全一覧は国のページで確認できます。
国は目的を持って選んでください。オンボーディングフローがブラジルのユーザーを対象にするなら、+55 の番号を使うことで、アプリが現地の番号をどう整形・検証・表示するかを確認できます。ビジネスアカウントが特定の市場だけを対象にするなら、その市場に合わせましょう。適当な国を選んでも得るものはなく、テスト結果が意味をなさなくなることもあります。
WhatsApp のコードが届かないのはなぜか？
WhatsApp はどの番号に送信するかを自ら判断し、WhatsApp の登録で仮想番号を完全に拒否することがあります。その場合、アクティベーションには何も届かず、有効時間が終わると全額がウォレットに戻ります。コードが実際に届いたときにのみ課金されます。ほかの原因はもっとありふれたものです。ルートが混み合っている、WhatsApp が次のコードを要求する前に待つよう求めている、SMS ではなく音声通話でコードを要求してしまった、などです。
対処法は次のとおりです。
- 1 分でキャンセルせず、有効時間いっぱいアクティベーションを開いたままにする。
- 登録画面で通話ではなく SMS を要求したことを確認する。
- 時間をおいて再試行するか、アカウントの市場が許すなら別の国のルートを試す。
- 試行の間隔を空ける。コードを次々に高速ループで要求すると、かえって状況が悪化しがちです。
長期間使う WhatsApp アカウントには専用番号を使うべきか？
たいていはそうです。OTP Gateway の番号は 1 回のコード用であり、端末の交換や再インストールの後にもう一度認証が必要になった場合は、同じ番号が手元に必要です。サポート窓口、共有のビジネスアカウント、テスターが何か月も使い回す QA アカウントには、専用の仮想番号（Dedicated Virtual Number）が向いています。米国とカナダで即時に購入でき、料金は $1.95/月 からです。ウォレットから更新され、受信 SMS は number.sms_received として Webhook に転送され、いつでも解約できます。この 2 か国以外にはセルフサービスの長期回線はありません。[email protected] にメールでご相談ください。詳細は仮想番号のページにあります。
API を使えなくてもダッシュボードから操作できるか？
できます。サインインしてカードまたは USDT/USDC でウォレットにチャージし、WhatsApp と国を選び、表示された料金を確認して注文します。番号を WhatsApp に入力すると、コードが届いた時点でアクティベーションのページに表示されます。月額料金もプランもなく、チャージのたびに PDF の請求書がメールで届き、返金ルールも API と同じです。先に連携をリハーサルしたい開発者は、サポートに開発アカウントのサンドボックス化を依頼できます。サンドボックスでは模擬の番号とコードで Webhook を動かせるため、資金を使わずに済みます。
WhatsApp の番号を責任ある形で使うとは？
OTP Route は、ご自身の正当なプロダクトとアカウントのテストと運用のためにあります。WhatsApp の利用規約を守り、実在する一人の個人または一つの事業につき 1 アカウントにとどめてください。アカウントの大量登録、迷惑メッセージの送信、停止後のプラットフォームへの復帰にルートを使ってはなりません。OTP Route の利用規定（Acceptable Use Policy）はすべてのアクティベーションに適用されます。WhatsApp は各権利者の商標であり、OTP Route は WhatsApp と提携していません。
よくある質問
SIM カードなしで WhatsApp の OTP を受信できますか？
はい。OTP Gateway の番号が WhatsApp の登録 SMS を受信し、コードをダッシュボードに表示するか Webhook へ送信します。物理的な SIM は不要です。
API での WhatsApp のサービス ID は何ですか？
GET /api/v1/prices と POST /api/v1/activations では、サービスに whatsapp を、国 ID（in や us など）と合わせて指定します。
WhatsApp はすべての仮想番号を受け付けますか？
いいえ。WhatsApp は仮想番号を拒否することがあります。そのため、コードが届かなかったアクティベーションは全額がウォレットに返金されます。
同じ番号で後から WhatsApp アカウントにログインし直せますか？
ゲートウェイの番号は 1 回のコード専用なので、できません。アカウントの再認証が必要になりそうなら、米国またはカナダの専用仮想番号を使ってください。
WhatsApp 認証番号の料金はいくらですか？
料金は 1 コード $0.20 からで、国によって異なります。注文前に、ダッシュボードと料金エンドポイントで最新の価格を確認できます。
CI パイプライン内で WhatsApp の SMS 認証をテストできますか？
はい。ご自身のテストアカウントであれば可能です。開発中はサンドボックスで構築し、本番ルートは試行の間にバックオフを入れて控えめに呼び出してください。
サービス名はそれぞれの所有者の商標です。OTP Route はこれらの企業と提携していません。番号は合法的にご利用いただき、各サービスの利用規約および当社の利用規定に従ってください。