タイ(+66)の電話認証をテストする:チェックリスト、手順、対処法

開始前に:+66テストのチェックリスト

タイのサインアップフローには、失敗したCI実行で気づくより机上で見つけるほうが安く済む落とし穴がいくつかあります。まず各項目を確認してください。

• 認証情報。 開発者コンソールで発行した、or_live_ プレフィックスのBearerキー。使用する環境に限定します。
• 識別子。 タイの国IDは th です。サービスIDは推測せず、GET /api/v1/services から取得してください。
• 配信方式の選択。 署名シークレットを保存したWebhookエンドポイントか、1分300リクエストの制限を守るポーリングジョブのどちらか。
• 番号の扱い。 何かを保存する前に、国内表記の先頭の0をどう取り除くかを決めておきます(後述のフォーマットの項を参照)。
• メッセージの解析。 数字の前後にタイ文字があってもパーサーが対応できることを確認します。
• 予算。 チャージ済みのウォレット、または連携の動作確認だけならサンドボックスアカウント。

OTP Gatewayでカバーできるタイのサインアップフローは?

タイは対応の広いルートのひとつで、ライブのスナップショットでは1,800を超えるサービスが利用できます。現地ではメッセージングとコマースが中心なので、チームはまずLINE、Shopee、Lazada、TikTok、WhatsApp、Facebook、Instagram、Telegramから始めるのが一般的です。ほかにも、Google(Gmail & YouTube)、Microsoft & Outlook、ChatGPT(OpenAI)、Discord、Viber、Netflix、Amazon、Airbnbなどが一覧に含まれます。

サービスごとの利用可否は番号の出入りに応じて変わるため、前提を固定で書き込まず、実行のたびに価格エンドポイントを確認してください。

APIでタイの認証番号を注文する

ベースURLは https://otproute.com/api/v1 です。

1. GET /api/v1/prices?country=th&service=<id> をリクエストします。空または利用不可の応答が返ったら、別の時間帯かルートを選んでください。
2. POST /api/v1/activations に、たとえば {"service": "line", "country": "th"} のようなボディを送ります。返されたアクティベーションIDは、テスト実行と一緒に保存します。
3. テスト対象のアプリに+66番号を入力し、SMSを発生させます。
4. activation.sms_received イベントから、またはポーリングの場合は GET /api/v1/activations/{id} からコードを取得します。
5. 不要な注文は POST /api/v1/activations/{id}/cancel で解放します。

配信のたびに X-OTPRoute-Signature ヘッダー(t=<unix>,v1=<hex>)を検証し、タイムスタンプが古すぎるイベントは破棄してください。イベントはアクティベーションIDをキーにしているため、重複した配信も簡単に無視できます。リクエストの完全な例は開発者向けドキュメントにあります。

タイの番号形式、トランクの0、タイ文字のメッセージ

国内では、タイの携帯番号は先頭に 0 を付け、さらに9桁が続く形で書かれ、たいてい06、08、09で始まります。この0はトランクプレフィックスで、国際形式では消えるため、08x xxx xxxx は +66 8x xxx xxxx になります。E.164形式で保存し、ゼロが残ったままのユーザー入力は正規化してください。そうしないと、重複排除が1台の端末を2人として扱ってしまいます。

タイ向けアプリからのコードは、タイ語の文の中に入って届くことがよくあります。英単語を目印にせず、パターン(想定する桁数の数字の並び)でコードを抽出してください。また、タイ文字のSMSはUnicodeエンコードのため、メッセージはより短いセグメントに分割されることも覚えておきましょう。ローカライズQAもここでテストする理由のひとつです。タイ語のUIの日付欄には仏暦の年が表示されることが多く、タイ人の氏名や住所欄の文字数制限も間違えやすいポイントです。東南アジアでのプロダクトローンチ、マーケットプレイスの出品者オンボーディング、タイ語対応のサポートデスクなども、よくある利用例です。

サポートや運用スタッフが代わりにダッシュボードを使うには?

すべての確認にスクリプトが必要なわけではありません。運用チームの担当者は、サインアップして入金し、OTP Gatewayを開き、サービスとタイを選び、提示された価格を確認して番号を受け取れます。コードはブラウザ上のアクティベーションカードに表示されます。同じ20分の待機時間が適用され、時間切れで空のまま終了した場合は自動的に返金されます。

+66番号にコードが届かないときのトラブルシューティング

アクティベーションが空のままの場合は、次のリストを上から確認してください。

• キャンセルする前に、待機時間をフルに使いましょう。再送が遅れるのはよくあることです。
• そのサービスが、タイ向けに仮想番号を受け付けているかを確認します。受け付けないサービスもあり、自動返金はそのためのものです。
• 時間を置いて再試行するか、テストケースが許せば別の国のルートに切り替えます。チームがフォールバックをどう選ぶかは、国別ルーティングの記事で解説しています。
• 再試行の間隔を空けましょう。立て続けの再注文はほとんど効果がなく、ログも散らかります。

失敗した試行でお金を失うことはありません。期限切れまたはキャンセルされたアクティベーションは、全額がウォレットに戻ります。

タイのプロジェクト向けの長期回線、ウォレット、サンドボックス

OTP Routeでは、セルフサービスのタイの長期番号は販売していません。継続的なタイの回線が必要なチームは [email protected] にメールで問い合わせできますが、可能かどうかは現地の規制次第です。保持して更新できる専用番号は、米国とカナダのみで、月額$1.95からです。

それ以外はすべて、サブスクリプションなしのプリペイドUSDウォレットで動きます。カードまたはUSDT/USDCでチャージでき、そのたびにPDF請求書がメールで届きます。連携作業では、開発用アカウントをサンドボックスに移行すれば、シミュレートされた番号とコードがコード内を無料で流れます。最新の料金は料金ページをご覧ください。各サービスの利用規約を守り、すべてのアクティベーションにOTP Routeの利用規定が適用されることをご留意ください。

よくある質問

タイのSIMカードなしで、アプリのタイでのサインアップを検証できますか?

はい。OTP Gatewayで+66番号を注文してアプリに入力し、ダッシュボード、またはAPIとWebhookでコードを読み取ります。

タイの携帯番号を保存するとき、先頭の0は残すべきですか?

いいえ。トランクの0を外し、+66 に残りの9桁を続けた形で保存してください。

タイについて、APIはどのIDを求めますか?

国の値として th を使います。たとえば GET /api/v1/prices?country=th&service=<id> のように指定します。

LINEやShopeeのメッセージがタイ語で届くのはなぜですか?

多くのサービスは、番号の国やアカウントの言語に応じてSMSテンプレートをローカライズします。そのため、英語のキーワードではなく数字を解析してください。

タイでアクティベーションに失敗した場合、費用はかかりますか?

かかりません。20分の待機時間がSMSなしで終了した場合、またはキャンセルした場合は、全額が自動的にウォレットへ戻ります。

費用をかけずに、CIでタイのOTPテストを実行する方法はありますか?

はい、開発用アカウントにサンドボックスモードを依頼してください。シミュレートされた番号とコードが返されるので、パイプラインをエンドツーエンドでテストできます。詳しくはCI/CDソリューションのページで説明しています。

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