トンガ(+676)の認証コードを受信する方法を選ぶ

トンガのプロジェクトには、Gateway番号と長期回線のどちらが合いますか?

まず、作業の形を確認します。登録テスト、ローカライズの確認、サポートでの再現のために、SMSコードが届くのを1回見たいだけなら、OTP Gatewayが適した製品です。認証1回分の+676番号が取得でき、コードがダッシュボードとお客様のシステムに届いて、アクティベーションは終了します。

一方、アカウントに数か月間ひも付く番号が必要な場合、つまり再ログインやリカバリーコードの受信、サポート回線の運用には、専用バーチャル番号が向いています。これは米国とカナダでのみ提供され、月額$1.95からで、受信・送信SMSとブラウザからの通話が付きます。

OTP Routeには、トンガ向けのセルフサービスの長期回線はありません。必要なチームは [email protected] にメールで問い合わせできますが、提供できるかどうかは現地の規則次第で、難しい場合もあります。この違いについては、一時番号と専用番号の比較で詳しく説明しています。

なぜトンガの番号に対して登録フローをテストするのですか?

トンガには、ニュージーランド、オーストラリア、米国を中心とする大きなディアスポラがあり、家族はメッセージアプリや送金サービスを通じて、これらの国をまたいで連絡を取り合っています。送金ツール、コミュニティプラットフォーム、旅行サービスなど、太平洋地域のコミュニティ向けのプロダクトは、+64と同じ確かさで+676番号を受け付ける必要があります。

そのため、トンガはQAで有用なエッジケースになります。トンガ語と英語はどちらも公用語で、国際的なアプリからの認証SMSの多くは英語で届くため、興味深いバグはメッセージの文言ではなく、番号の扱いに現れる傾向があります。太平洋地域向けのフィンテックのオンボーディングを構築するチームの多くは、まさにこの理由で、リグレッションスイートにトンガのケースを加えています。

バリデーターは+676の番号をどう扱うべきですか?

トンガの国内番号は、多くの開発者が思い浮かべるヨーロッパやアメリカの番号よりずっと短く、国際形式にトランクプレフィックスはありません。最小桁数を固定したバリデーションコードは、こうした番号が拒否される最も一般的な原因です。

• すべての番号を、+676 に加入者番号の桁を続けたE.164形式で保存し、パディングは決して行わないでください。
• 他の国からコピーした正規表現ではなく、最新の電話番号ライブラリに頼ってください。
• SMS送信側が、番号が短すぎると判断した宛先を黙って破棄していないことを確認します。
• 将来のリファクタリングでバグが再発しないよう、テストデータにトンガの認証番号を残しておきます。

Gatewayで+676を1回注文すれば、実際のキャリアが配信するSMSで経路全体が動作することを、低コストで確認できます。

トンガのルートはどのサービスに対応していますか?

トンガのルートには、現在600を超えるサービスがあります。最新のスナップショットで人気のものには、Facebook、TikTok、Viber、WhatsApp、Instagram、Telegram、Google (Gmail & YouTube)、Snapchat、Microsoft & Outlook、Amazonがあります。

このリストは、ルート間で容量が移動するため、一日の中で変わります。目安として扱い、注文の前に、ダッシュボードまたは価格エンドポイントでリアルタイムの空き状況を確認してください。

トンガOTP APIはどのように呼び出しますか?

Developerコンソールで発行した or_live_ で始まるBearerキーで、https://otproute.com/api/v1 に認証します。トンガの国IDは to です。

価格と在庫は GET /api/v1/prices?country=to&service=<id> で確認し、POST /api/v1/activations に {"service": "viber", "country": "to"} のようなボディを送って注文します。レスポンスには、アクティベーションIDと+676番号が含まれます。

トンガのSMS OTPコードを自動で受信するには、activation.sms_received と activation.expired のWebhookを登録します。各リクエストには X-OTPRoute-Signature: t=<unix>,v1=<hex> が含まれます。エンドポイントのシークレットで <t>.<raw body> のHMAC-SHA256を再計算し、定数時間で比較し、古いタイムスタンプは拒否してください。小規模なジョブには GET /api/v1/activations/{id} のポーリングで十分で、POST /api/v1/activations/{id}/cancel は不要になった注文を解放します。上限は1アカウントあたり、1分300リクエスト、キー10個、Webhookエンドポイント5つです。リクエストとレスポンスの詳細は開発者ドキュメントをご覧ください。

トンガのコードが遅い、または届かない場合はどうすればよいですか?

小さな島嶼市場ではルートが細いのが普通なので、必要になる前に再試行のポリシーを作っておきましょう。

1. 20分の有効時間が終わるまで待ちます。SMSが届かなければ、注文は全額返金されます。
2. テスト対象のサービスが仮想番号を受け付けるか確認します。受け付けないサービスもあり、どのルートでもそれは変えられません。
3. 新しい注文を立て続けに出さず、待ってから再試行します。
4. テストが太平洋地域の番号全般に関するものなら、フィジーやサモアといった近隣のルートを試します。

すべての注文は、対象サービスの規約とOTP Routeの利用規定(Acceptable Use Policy)を守る必要があることを忘れないでください。

課金とサンドボックステストはどう機能しますか?

OTP Routeは従量課金の1つのプリペイドUSDウォレットを使うため、月額料金も選ぶべきプランもありません。カードまたはUSDT/USDCのステーブルコインで資金を追加でき、チャージごとにPDF請求書がメールで届きます。フローを構築中の開発者は、開発用アカウントのサンドボックスモードを申請できます。シミュレートされた番号とコードが返されるため、ウォレットを使わずにOTPルーティングのロジックとWebhookハンドラーをテストできます。現在のコードあたりの料金は料金ページをご覧ください。

よくある質問

トンガにいなくても、トンガの認証コードを受信できますか?

はい。OTP Gatewayで+676番号を注文すれば、チームがどこにいても、コードがダッシュボードに表示され、Webhookにも送られます。

SMS認証APIでトンガに使う国IDは何ですか?

IDは to で、GET /api/v1/prices と POST /api/v1/activations で使います。

自社のフォームが有効なトンガの番号を拒否するのはなぜですか?

たいていは、もっと長い番号を想定して書かれた最小桁数のチェックが原因です。メンテナンスされている電話番号ライブラリで検証し、番号はE.164形式で保存してください。

保持できる長期の+676番号はありますか?

セルフサービスではありません。長期の専用番号は米国とカナダでのみ提供しています。トンガについては [email protected] へメールでお問い合わせください。

トンガのコードが届かなかった場合、代金はどうなりますか?

SMSが届かないまま20分の有効時間が終わった場合や、キャンセルした場合は、全額が自動的にウォレットに戻ります。

アプリのトンガ向けオンボーディングをCIでテストできますか?

はい。環境ごとにAPIキーを使い、ポーリングするかWebhookを待ち受け、パイプラインを構築する間は開発用アカウントをサンドボックスに切り替えてください。

トンガの認証SMSは何語で届きますか?

国際的なアプリの多くは英語で送信しますが、サービスとアカウントの言語設定によります。

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