テスト用番号で Telegram のログインコードを受け取るための事前チェックリスト

Telegram 番号を注文する前に何を準備すべきか？

まず次のリストを確認してください。Telegram のテストが失敗する原因の多くは、このどれかに行き着きます。

• 明確な目的。 自社チームが運用するボット、Mini App、ログインウィジェット、サポートワークフローをテストしており、社員の個人スマホに紐づかない新しい Telegram アカウントが必要である。
• 対象国。 アカウントがどの市場に属するように見せたいかを決めます。言語の初期設定や一部のオンボーディング画面は番号の国に従います。
• ウォレット残高、またはサンドボックス。 チャージ済みのプリペイドウォレット、またはリハーサル用にサポートがサンドボックスに切り替えた開発アカウント。
• 自動化するなら API キー。 Developer console で or_live_ プレフィックスのキーを作成します。
• クリーンな端末またはエミュレーター。 Telegram は、すでにログイン中のセッションがあればアプリ内にコードを届けます。セッションのない端末を使えば SMS 経路の挙動を予測しやすくなります。
• 時間。 各アクティベーションは 20 分間有効です。テスターが番号を入力できる状態になるまで開始しないでください。

Telegram が実際に SMS コードを送るのはいつか？

Telegram は電話番号ですべてのアカウントを識別します。新しいアカウントを登録するときと、既存のアカウントを新しい端末でサインインするときにコードを求めます。そのアカウントがすでに別の場所で有効な場合、Telegram は通常 SMS ではなく既存セッションへのメッセージとしてログインコードを送ります。そのため、新しい端末で使う真新しい番号が、SMS の手順をテストするいちばん確実な方法です。少し待つと、通話や再送が提案されることもあります。

Telegram の 2 段階認証は、アプリ内で設定する別のクラウドパスワードです。SMS による要素ではないため、テストアカウントで有効にした場合は、そのパスワードをチームのシークレット管理ツールに保管してください。

Telegram ではどの国を選べるのか？ なぜ重要か？

telegram サービスは現在 199 か国で提供されており、インド、ドイツ、ブラジル、ナイジェリア、インドネシアのほか、英国、ウクライナ、カザフスタン、ウズベキスタン、トルコ、スペイン、メキシコ、フィリピン、ベトナム、エジプトなどが含まれます。

国はテストケースに合わせます。ポルトガル語で応答するボットはブラジルのアカウントから試すべきですし、中央アジアをカバーするサポートチームにはカザフスタンの番号が向いているかもしれません。また、Telegram は国によって番号をより慎重に扱うことがあるため、あるルートで失敗が続く場合は隣接する市場を代替にするのが現実的です。提供状況は一日の中で変わるので、保存した一覧ではなく API から取得してください。

API で Telegram のコード取得を自動化するには？

1. 必要に応じて GET /api/v1/prices?country=<id>&service=telegram で料金を確認します。
2. 注文を作成します。POST /api/v1/activations に {"service": "telegram", "country": "<id>"} を送ります。国 ID は GET /api/v1/countries から取得します（例: br、de）。
3. 返された番号をテストランナーに渡し、Telegram クライアントまたはエミュレーターに入力させます。
4. コードを待ちます。Webhook なら activation.sms_received を受信し、そうでなければ適切な間隔で GET /api/v1/activations/{id} をポーリングします。
5. 実行が中断された場合は POST /api/v1/activations/{id}/cancel で後始末をします。

Webhook では、エンドポイントのシークレットで <t>.<raw body> の HMAC-SHA256 を再計算して X-OTPRoute-Signature を検証し、古いタイムスタンプを拒否し、処理済みのアクティベーション ID を記録して再送イベントを無視します。アカウントごとに最大 5 つの Webhook エンドポイントと 1 分あたり 300 リクエストが利用できます。並列実行については CI パイプラインのガイドをご覧ください。

同じ手順をダッシュボードで手動でもできるか？

できます。サインインして OTP Gateway を開き、Telegram と国を選んで料金を確認し、注文します。番号を Telegram の電話番号画面にコピーし、該当する国番号を選んでコードを要求します。SMS が届くと注文の横に表示され、そのまま貼り付けられます。

Telegram のコードが届かなかった。トラブルシューティングの項目は？

• 既存のセッションはないか？ その番号を以前使っていた場合、Telegram がコードをアプリ内に送った可能性があります。新しいアクティベーションなら避けられます。
• 有効時間は終了したか？ 20 分のタイマーを最後まで進めてください。コードが届いたときにのみ課金され、期限切れやキャンセルの場合は全額が自動的に返金されます。
• そのルートは受け付けられているか？ Telegram は一部の仮想番号を拒否することがあります。これは当社では制御できず、まさに返金ルールがある理由です。
• 間隔を空けて再試行する。 後で、または別の国で注文し直してください。短い間隔で連続注文しても、配信にもレート制限にもよい影響はありません。
• 端末側の国番号を確認する。 手動テストでは、選択した国と番号の不一致が起きやすいミスです。

Telegram で専用番号のほうが向いているのはいつか？

1 回限りの OTP Gateway 番号は登録テストに向いています。来月も Telegram アカウントでサインインする必要がある場合、たとえばサポートチャンネルを運営するチームアカウントやボットの管理者ログインなどでは、チームが引き続き管理できる電話番号が必要です。米国とカナダの専用番号（Dedicated Numbers）は $1.95/月 からで、更新されている間は自分のものとして使え、受信 SMS をダッシュボードと number.sms_received として Webhook に転送します。トレードオフについては、一時番号と専用番号の比較で解説しています。

責任ある Telegram テストとはどのようなものか？

Telegram の利用規約に従ってください。実在する一人の個人または事業目的につき 1 アカウントを作成し、自社のプロダクト、ボット、運用のために使い、スパム、アカウントの大量作成、停止措置の回避には決して使わないでください。Telegram に対するすべての注文は、OTP Route の利用規定（Acceptable Use Policy）の対象でもあります。Telegram は権利者の商標であり、OTP Route は Telegram と提携していません。

よくある質問

個人のスマホを使わずに Telegram の認証コードを取得できますか？

はい。OTP Route の OTP Gateway で Telegram 用の番号を注文し、アプリに入力して、SMS コードをダッシュボードまたは API で確認します。

API での Telegram のサービス ID は何ですか？

telegram です。アクティベーションを作成するときに、GET /api/v1/countries で取得した国 ID と組み合わせます。

Telegram の SMS 認証テストの料金はいくらですか？

1 コード $0.20 からです。正確な価格は国によって異なり、料金エンドポイントでリアルタイムに返されます。

Telegram が SMS ではなくアプリ内にコードを送ったのはなぜですか？

Telegram は、既存のセッションがあればそこにログインコードを届けます。SMS 経路をテストするには、新しい番号とログイン済みセッションのない端末を使ってください。

1 回限りの番号を再利用して、後で Telegram にログインし直せますか？

できません。OTP Gateway の番号は 1 回のコード専用です。繰り返しログインするなら、米国またはカナダの専用番号を使ってください。

Telegram が番号を拒否した場合も課金されますか？

いいえ。20 分以内に番号へコードが届かなかった場合、またはキャンセルした場合は、全額がウォレットに戻ります。

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