テストと運用で TikTok の SMS コードを受け取るためのチェックリスト

TikTok は何のために SMS コードを送るのか？

TikTok では、電話番号でのアカウント作成、パスワードの代わりにワンタイムコードでのログイン、二段階認証の有効化、パスワードを忘れたときのアクセス復旧ができます。これらの場面はどれも SMS コードを生み、TikTok を軸にプロダクトを作るチームが再現する必要のあるステップです。たとえば、運用するブランドアカウントを確認するエージェンシー、ソーシャルログイン連携を検証する QA エンジニア、会社のプロフィールを社員の個人スマホから切り離しておきたい運用チームなどです。

TikTok 用の仮想番号はこうしたケースに合い、中でも TikTok の SMS 認証テストがもっとも多い用途です。アカウントがご自身またはクライアントのもので、TikTok の規約の範囲内であれば、いずれも正当な使い方です。

注文前のプリフライトチェックリスト

最初の TikTok 注文の前にこれらの点に 10 分かけておけば、届かないコードを後で追いかける数時間を節約できます。

• 市場を決める。 番号の国は、アカウントの地域、または再現するテストケースに合わせます。
• 料金と在庫を確認する。 GET /api/v1/prices?country=<id>&service=tiktok が、その両方をリアルタイムで返します。
• ウォレットにチャージする。 実行の開始時に GET /api/v1/balance を呼べば、テストの途中ではなく最初に失敗が分かります。
• 受け取り方法を決める。 CI や並列ジョブには Webhook、手早い手動確認にはポーリングです。
• 再ログインを先に考える。 アカウントが来月またログインする必要があるなら、ワンタイム番号は適切なツールではありません（最後のセクションを参照）。
• ルールを知る。 実在する一人または一つの事業につき 1 アカウント、TikTok の規約、そして OTP Route の利用規定（Acceptable Use Policy）です。

TikTok の電話番号はどの国のものにすべきか？

TikTok のルートは 202 か国で利用できます。よく選ばれるのは、米国、カナダ、英国、ドイツ、フランス、ブラジル、メキシコ、インドネシア、フィリピン、ベトナム、タイ、トルコ、サウジアラビア、パキスタン、ナイジェリア、ケニアなどです。

国の選択は見た目だけの問題ではありません。TikTok は地域によってコンテンツ、機能、登録時のチェックを調整するため、ブラジルでのローンチの QA ケースには +55 の番号を、フィリピンのローカライズテストには +63 の番号を使うべきです。番号とアカウントの市場が食い違うと、ユーザーに見える挙動とフローの挙動が異なる原因になりがちです。

手順の解説: TikTok の認証コード API

Developer console で発行した or_live_ で始まる Bearer キーで https://otproute.com/api/v1 に認証します。

1. GET /api/v1/countries で国 ID を確認します。サービス ID は tiktok です。
2. 現在の料金を取得します。GET /api/v1/prices?country=br&service=tiktok。
3. POST /api/v1/activations に {"service": "tiktok", "country": "br"} を送ってアクティベーションを作成します。レスポンスのアクティベーション ID を保持します。
4. 返された番号を TikTok の電話番号画面に入力し、コードを要求します。
5. activation.sms_received イベントから受け取るか、GET /api/v1/activations/{id} を数秒おきにポーリングします。
6. シナリオを取りやめる場合は POST /api/v1/activations/{id}/cancel を呼び出すと、資金がすぐに戻ります。

アカウントの上限は 1 分あたり 300 リクエストで、複数のアクティベーションを同時にポーリングするには十分です。リクエストとレスポンスの全形式は API ドキュメントにあります。

Webhook レシーバーの構築

Developer console で HTTPS エンドポイントを登録し（アカウントあたり最大 5 つ）、activation.sms_received、activation.expired、activation.cancelled を購読します。そのうえで堅牢にします。

• X-OTPRoute-Signature を t と v1 に分解し、エンドポイントのシークレットで <t>.<raw body> の HMAC-SHA256 を計算して、定数時間で比較します。
• 数分以上古いタイムスタンプを拒否し、リプレイを防ぎます。
• アクティベーション ID を冪等性キーとして扱い、再配信されたイベントで二重に更新しないようにします。
• 2xx をすばやく返し、時間のかかる処理はキューに回します。

公開 URL のないローカル開発では、ポーリングを代替手段として残してください。検証コードはOTP Webhook のセキュリティのガイドで解説しています。

TikTok のコードがまったく表示されない場合のトラブルシューティング

TikTok からの無反応には、たいていありふれた原因があります。

1. 有効時間を待ち切る。 アクティベーションは 20 分間開いたままです。何も届かなければ、全額が自動的に返金されます。
2. 断られる番号があると理解する。 TikTok は地域や状況によって仮想番号を拒否することがあり、返金ルールがそのケースに対応します。
3. 変える条件は一つに絞る。 時間をおいて再試行するか、テストに合う別の国を試します。
4. 間隔を空ける。 短時間にコードを何度も要求すると、TikTok 側のレート制限に引っかかることがあります。
5. 自分側を確認する。 番号が国際形式で完全に入力されたこと、Webhook が 2xx を返したことを確認します。

米国またはカナダの専用回線が向いているのはいつか？

1 回限りのアクティベーションは単発の認証に向いています。数か月後に再ログイン、アクセス復旧、二段階チェックの通過が必要になるブランドアカウントには、チームが保持する番号が必要です。専用番号（Dedicated Numbers）は米国とカナダで $1.95/月 からその用途に対応し、受信 SMS はダッシュボードと number.sms_received 経由の Webhook に届きます。仮想番号をご覧ください。ほかの国では、セルフサービスの長期回線は提供していません。

すべての費用は 1 つのプリペイド USD ウォレットから支払われ、カードまたは USDT/USDC でチャージでき、チャージごとに PDF の請求書が発行されます。連携テスト用に、リクエストによりサンドボックスアカウントを有効にでき、模擬コードを使えます。

よくある質問

TikTok のコードを自動でバックエンドに届けるには？

サービス ID tiktok でアクティベーションを注文し、署名付きの activation.sms_received Webhook か、GET /api/v1/activations/{id} のポーリングでコードを受け取ります。

特定の国の TikTok SMS 認証をテストできますか？

はい。アクティベーションを作成するときに国を選びます。TikTok のルートは現在 202 か国をカバーしており、最新の提供状況は料金エンドポイントで確認できます。

TikTok の OTP の料金はいくらですか？

国によって異なりますが、1 コード $0.20 からです。正確な金額は、注文前にダッシュボードと GET /api/v1/prices に表示されます。

TikTok が仮想番号を拒否した場合はどうなりますか？

SMS が届かないため、アクティベーションは 20 分後に期限切れになるか、キャンセルすることになり、全額がウォレットに戻ります。

長期運用するブランドアカウントに、ワンタイム番号で足りますか？

たいていは足りません。繰り返しのログインや復旧には、更新されている間チームが保持できる、米国またはカナダの専用番号を使ってください。

OTP Route で TikTok アカウントを大量に作成できますか？

できません。OTP Route は、ご自身の正当なアカウントとプロダクトのテストと運用のためのものです。TikTok の規約に従い、実在する一人または一つの事業につき 1 アカウントにとどめてください。

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