OTP Route の番号で Twitch の SMS コードを受け取るためのチェックリスト

最初の Twitch 注文の前の事前チェックリスト

番号をリクエストする前に、次を確認してください。

• 目的が正当であること：自社の連携や拡張機能のテスト、または組織が所有するチャンネルアカウントの運用であること。
• API キーの準備：Developer コンソールで発行した Bearer キー（プレフィックス or_live_）。
• Webhook エンドポイントの登録と、そのシークレットをサーバー側で保管していること。
• 国の選択：アカウントの視聴者層またはテストケースに合わせること。
• ウォレットへの入金、または試運転のためのサンドボックスの依頼。
• 長期的なニーズの確認：アカウントが後で再認証を必要とする場合は、先に最後のセクションをお読みください。

Twitch はどこで電話番号を求めるのか？

Twitch は、メールの代わりとしての登録時、アカウントの確認、パスワードの回復、二要素認証を有効にしたときに、電話番号を使うことがあります。配信、モデレーション、拡張機能の運用をするチャンネルは二段階ログインを有効にしていることが多く、連絡のつく番号は 1 回限りのステップではなく、日常的なアクセスの一部になります。

QA チームにとっては、これは 2 つの異なるテストの形を意味します。登録や確認のテストは 1 つのコードで完了するもので、まさに OTP Gateway が提供するものです。二段階認証のログインテストは、同じ番号で何度もコードが必要になるため、代わりに長期回線が必要です。必要な製品が変わるので、注文前にどちらの形をテストするのか決めてください。

Twitch の番号はどの国のものを選ぶべきか？

Twitch は 197 か国のルートで利用でき、米国、カナダ、英国、ドイツ、ブラジル、日本、メキシコ、フランス、スペイン、ポーランド、韓国、トルコ、フィリピン、オーストラリアなどが含まれます。

番号は、アカウントが属する市場に合わせてください。ブラジルのチャンネルのローカライズテストは、ブラジルの番号のほうが現実的で、地域のリスクチェックが不一致を不自然と見なすこともあります。理由は国別ルーティングガイドで解説しています。

手順：API で Twitch の OTP を取得する

1. GET /api/v1/services でサービス ID が twitch であることを確認し、GET /api/v1/countries から国 ID を選びます。
2. 費用を確認します。GET /api/v1/prices?country=<id>&service=twitch
3. 注文します。POST /api/v1/activations に {"service": "twitch", "country": "<id>"} を送ります。
4. 返ってきた番号を Twitch の電話番号欄に入力します。
5. activation.sms_received を待つか、GET /api/v1/activations/{id} をポーリングします。
6. コードを送信して、テストを締めくくります。

ベース URL は https://otproute.com/api/v1 で、アカウントあたり 1 分 300 リクエストです。CI ジョブでは、手順 3 から 6 を 1 つのテストフィクスチャにまとめ、そのティアダウンでアクティベーションをキャンセルすれば、中断された実行が注文を残すことはありません。この方法はCI パイプラインでの SMS OTP テストで紹介しています。

Webhook ハンドラーはどう書くべきか？

各配信には X-OTPRoute-Signature: t=<unix>,v1=<hex> が含まれます。エンドポイントのシークレットで <t>.<raw body> の HMAC-SHA256 を再計算し、定数時間で比較して、古いタイムスタンプは拒否します。ハンドラーはアクティベーション ID をキーにして冪等にし、再試行された配信で同じ Twitch コードを二重に送信しないようにします。エンドポイントに到達できない場合は、アクティベーションのポーリングが妥当なフォールバックです。Webhook による OTP 取得をご覧ください。

コミュニティ・チャンネル管理者向けのダッシュボード操作

誰もが API を必要とするわけではありません。ダッシュボードで OTP Gateway を開き、Twitch と国を選び、表示された料金を確認して注文します。番号を Twitch に入力すると、配信されたコードが注文の横に表示されます。これは、ブランドアカウントを 1 つ設定するチャンネル管理者に向いています。また、配信者の個人の電話番号を会社所有のプロフィールから切り離せるため、担当者が変わってアクセスをきれいに引き継ぐ必要があるときに重要です。

トラブルシューティング：コードが来ない、番号が拒否された、有効時間が切れた

• 何も届かない：20 分の有効時間が終わるまで待ちます。期限切れまたはキャンセルで、全額が自動的に返金されます。
• Twitch が番号を拒否した：Twitch が仮想番号を拒否することがあります。あとで別の国のルートを試してください。
• 失敗が続く：短い間隔で再注文せずに一休みし、国際番号を完全な形で入力しているか確認します。
• 誤ったコードを送信した：ハンドラーが、キャッシュされた以前のものではなく、最新のアクティベーションを読み取っているか確認します。
• 連携のバグ：サンドボックスを依頼して、シミュレートされたコードでフローを再現します。

米国・カナダの専用番号のほうが適しているケース

Gateway の番号は 1 回のコードを受信すると消えます。二段階ログインや共有チームログインの回復など、Twitch アカウントが再びコードを必要とするなら、専用番号（Dedicated Number）のほうが適しています。これは米国とカナダのみで即時に販売されており、月額 $1.95 からで、受信した SMS を Webhook に転送します。

どちらを選ぶ場合も、Twitch の規約を守ってください。アカウントは実在の個人または事業者につき 1 つです。OTP Route は、ご自身の正当なアカウントと製品のテストと運用のためのサービスであり、利用規約（Acceptable Use Policy）に従います。

よくある質問

個人の電話なしで Twitch の OTP を受信できますか？

はい。チームは OTP Gateway で twitch 用の番号を注文し、ダッシュボードでコードを確認できるため、スタッフの電話をブランドアカウントから切り離せます。

Twitch のコードの料金はいくらですか？

1 コード $0.20 からで、国によって異なります。最新の価格は、注文前に GET /api/v1/prices で確認できます。

Twitch が私の番号にコードを送ってこないのはなぜですか？

配信はルートに左右され、Twitch が一部の仮想番号を拒否することもあります。有効時間が終わるまで待てば自動で返金されるので、そのあとで、または別の国で試してください。

Twitch 用の仮想番号は、二要素認証のログインに向いていますか？

長期回線だけが意味を持ちます。Gateway の番号は 1 回のコードしか受信しないため、米国またはカナダの専用番号を使ってください。

CI でテスト用の Twitch SMS 認証を実行できますか？

はい。パイプラインから API で注文を発行して Webhook を受け取ります。開発中はサンドボックスを使えば、ウォレットの資金を使わずに済みます。

OTP Route は Twitch と関係がありますか？

いいえ。Twitch はその所有者の商標であり、OTP Route は提携していません。

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