日本語
OpenAI の電話認証コードを受け取るための実践チェックリスト
OTP Route で ChatGPT(OpenAI)の認証コードを受信するには、OTP Gateway で必要な国の openai サービスのアクティベーションを注文し、その番号を OpenAI のフォームに入力して、ダッシュボード、署名付き Webhook、または REST API でコードを取得します。料金は 1 コード $0.20 からで、国によって異なります。20 分以内に SMS が届かなければ、全額がウォレットに戻ります。
OpenAI は何のために電話番号を求めるのか?
OpenAI は、ChatGPT や開発者プラットフォームのアカウントを作成するとき、一部のセキュリティチェックの際、そしてアカウントの動きが追加の確認ステップを引き起こしたときなど、いくつかの場面で SMS 認証を使ってきました。正確なルールは地域によって異なり、時間とともに変わるため、どんなプロンプトも予測するものではなく、フローが対処すべきものとして扱ってください。
また OpenAI は、一つの番号で認証できるアカウント数に制限をかけることでも知られています。チームにとってこれは重要です。3 人のエンジニアがそれぞれ個人のスマホでテスト用ワークスペースを認証すると、それらのスマホが縛られてしまいます。個人ではなくテスト環境に属する ChatGPT 用の電話番号を使えば、運用がすっきりし、監査もしやすくなります。
プリフライトチェックリスト: 注文前にすべて整っているか?
このリストを一度確認しておけば、失敗する試行の大半は起きずに済みます。
- アカウントとウォレット。 チャージ済みの USD ウォレットを持つ OTP Route アカウント。カードまたは USDT/USDC でのチャージのたびに PDF の請求書が発行されます。
- API キー。 Developer console で発行する、
or_live_で始まる Bearer キー。テストファイルではなく、シークレット管理ツールに保管します。 - Webhook エンドポイント。 プッシュでコードを受け取る場合は、エンドポイントのシークレットを保存した公開 HTTPS ルート。
- 国の決定。 テストするアカウントの市場に合わせます。次のセクションで説明します。
- 目的の確認。 アカウントがご自身、会社、または開発中のプロダクトのテストアカウントであり、OpenAI の規約の範囲内で使うこと。
- 一時的か、永続的か。 アカウントが後からまたログインする必要があるなら、まず専用番号のセクションをお読みください。
- 構築フェーズ用のサンドボックス。 連携を書く間、模擬の番号とコードが欲しければ、開発アカウントのサンドボックスを依頼してください。
番号はどの国のものにすべきか?
openai サービスは現在 197 か国でルート可能で、米国、カナダ、英国、ドイツ、フランス、オランダ、スペイン、イタリア、ポーランド、インド、日本、韓国、シンガポール、オーストラリア、ブラジル、メキシコ、ナイジェリア、ケニア、フィリピン、アラブ首長国連邦などが含まれます。
意図をもって選んでください。OpenAI はすべての国でプロダクトを提供しているわけではなく、番号、請求情報、利用状況がそれぞれ別の場所を指すアカウントは、どの不正検知モデルにも不自然に映ります。QA では、テストケースが示す国を選びます。英国の顧客のオンボーディングを確認するなら、英国のルートを使います。チームがテストケースを国に対応づける方法は、QA テストのガイドに載っています。
手順: API でコードを受信する
これが ChatGPT 認証コード API フローの中核です。
GET /api/v1/prices?country=gb&service=openai(国 ID は自分のものに置き換えます)を呼び出し、その組み合わせが利用可能か、現在いくらかを確認します。POST /api/v1/activationsに本文{"service": "openai", "country": "gb"}を送って注文を作成します。返されたアクティベーション ID を、テストの実行記録と一緒に保存します。- 返された番号を、国際形式のまま OpenAI の認証画面に入力します。
- Webhook で
activation.sms_receivedを待ちます。信頼する前に、エンドポイントのシークレットで"<t>.<raw body>"の HMAC-SHA256 を再計算し、X-OTPRoute-Signatureのv1の値と比較して、tが古すぎる場合はイベントを拒否します。手順は HMAC による OTP Webhook の保護の記事で解説しています。 - ハンドラーを冪等にします。アクティベーション ID をキーにすれば、再試行された配信でコードが二重に送信されたり、すでに成功したテストが失敗したりしません。
- Webhook がない場合は、代わりに
GET /api/v1/activations/{id}を数秒おきにポーリングし、アカウントの上限である 1 分あたり 300 リクエストを大きく下回るようにします。 - 実行が取りやめられた場合は
POST /api/v1/activations/{id}/cancelを送ると、資金がすぐに戻ります。
手順: 手動テスター向けのダッシュボード経由
ChatGPT の OTP を受信するために、全員がコードを書く必要はありません。会社のワークスペースを一つだけ認証するサポートリーダーなら、次のようにできます。
- メールと 6 桁のコード、または Google でサインインします。
- ChatGPT(OpenAI)サービスと国を選びます。
- 表示された料金を確認し、番号をコピーします。
- OpenAI のフォームに貼り付け、アクティベーションのページで待ちます。コードが届くとそこに表示されます。
ご自身のダッシュボードログインに二要素認証(TOTP)を設定するのは、賢明な追加手順です。そのアカウントは会社のコードを受信できるからです。
トラブルシューティング: コードがまったく届かない場合は?
まずセーフティネットです。アクティベーションは 20 分間有効で、その間に SMS が届かない場合、またはキャンセルした場合は、全額がウォレットに戻ります。課金されるのは、配信されたコードの分だけです。
そのうえで、考えられる原因を順に確認してください。
- OpenAI が番号を拒否した。 サービスによっては、仮想番号を一律に、または特定の地域で拒否します。フォームが番号をすぐに拒否した場合、SMS は続いて届きません。
- 配信が遅い。 失敗と判断する前に、有効時間いっぱいアクティベーションを開いたままにしてください。
- ルートの状況。 新しい注文を連続で出すのではなく、時間をおくか、テストに合う別の国で再試行してください。
- 形式の誤り。 番号が国番号付きで、余分な先頭のゼロ(トランクプレフィックス)なしで入力されたか確認してください。
アクティベーション ID をログに残しておくと、サポートへの問い合わせが短く済みます。
専用番号が向いているのはどんなときか?
使い捨てのテスト用ワークスペースなら、1 回限りのコードで十分です。しかし、チームが来月またログインするアカウントには不適切です。一時的な番号では、後から 2 回目の認証を受信できないからです。
そのような場合は、専用仮想番号(Dedicated Virtual Number)が向いています。更新されている間保持できる米国またはカナダの回線で、$1.95/月 から、ダッシュボードで即時に購入できます。受信 SMS はそこに表示され、number.sms_received として Webhook に転送されます。専用回線は、この 2 か国でのみ利用できます。
責任ある利用とは何か?
OTP Route は、ご自身の正当なアカウントとプロダクトのテストと運用のためのものです。OpenAI の規約に従い、実在する一人または一つの事業につき 1 アカウントにとどめ、当社の利用規定(Acceptable Use Policy)がすべてのアクティベーションに適用されることを忘れないでください。ChatGPT 用の仮想番号は、本物の QA、オンボーディング、運用上のニーズを支えるものであり、プラットフォームの制限を回避する手段であってはなりません。
よくある質問
OTP Route で ChatGPT の SMS 認証をテストに使えますか?
はい。openai のアクティベーションを注文し、テストアカウントに番号を入力して、コードを API、Webhook、またはダッシュボードから確認します。
API での ChatGPT のサービス ID は何ですか?
openai で、アクティベーションのリクエストと料金のクエリの service フィールドに指定します。
OpenAI はすべての仮想番号を受け付けますか?
いいえ。一部の番号や地域を拒否することがあります。そのため、配信されなかったコードは自動的にウォレットに返金されます。
Webhook から同じコードを二重に処理しないようにするには?
最初のイベントが届いたときにアクティベーション ID を保存し、毎回署名を検証したうえで、同じ ID の繰り返しは無視します。
同じ番号で、後から ChatGPT アカウントにチームがログインし直せますか?
1 回限りのアクティベーションでは無理です。再認証が起きそうなら、米国またはカナダの専用番号を使ってください。
OpenAI のコードを受信するのに月額料金はかかりますか?
いいえ。ウォレットはプリペイドの従量課金で、選ぶべきプランはありません。
OTP Route は OpenAI と提携していますか?
いいえ。ChatGPT と OpenAI は権利者の商標であり、OTP Route は独立したルーティングサービスです。
サービス名はそれぞれの所有者の商標です。OTP Route はこれらの企業と提携していません。番号は合法的にご利用いただき、各サービスの利用規約および当社の利用規定に従ってください。