実際の+256ルートでウガンダの電話認証をテストする

ウガンダに専用のテストを行う価値があるのはなぜですか?

ウガンダはモバイルファーストの市場で、電話番号がその人の金融上のIDを兼ねることもよくあります。モバイルマネーが日常生活の一部になっているため、ウォレット、融資アプリ、アグリテック、マーケットプレイスはSMS認証に大きく依存しています。プロダクトチームにとっては、オンボーディングの電話番号ステップは単なる形式ではなく、玄関口だということです。

地域的な背景も重要です。東アフリカへ展開するプロダクトは、ケニア、タンザニア、ルワンダをウガンダと同時にローンチすることが多く、国ごとに番号の形式もサービスの提供状況も異なります。実際のルートで一国ずつテストすれば、1か国だけのテストでは見逃す問題が見つかります。チームがその作業をどう組み立てているかは、フィンテックのオンボーディングをご覧ください。

ウガンダの電話番号はどう書かれ、どう正規化しますか?

ウガンダのトランク接頭辞は 0 です。携帯番号は国内では通常 07 に8桁を続けて書きます。国際形式では0がなくなり、+2567 に8桁が続く形になり、国番号の後は合計9桁です。

• 先頭に0を付けた国内形式の入力を受け付け、保存前にE.164形式へ変換します。
• 国番号と0の両方を入力するユーザー(+2560…)に注意し、入力を拒否せずに0を取り除いてください。
• 重複検出やログインの照合が正しく動くよう、正規の列を1つだけ持ちます。

ビジネスや公的な通知の主な言語は英語で、スワヒリ語も公用語であり、ルガンダ語も広く話されています。海外サービスの認証テンプレートは通常英語で届くため、ここでのローカライズQAは、文字エンコーディングよりも、番号のマスク、国選択、文面のトーンが中心になります。

+256の番号では、どのサービスを認証できますか?

ウガンダは対応カタログが比較的広い国の一つで、現在1,600を超えるサービスにルートがあります。人気のものには、WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、X (Twitter)、Uber、Amazon、LinkedIn、Snapchat、Discord、ChatGPT (OpenAI)があります。このリストはライブのスナップショットです。必要な時点でのルートは、料金エンドポイントで確認してください。

ウガンダ OTP APIの注文は、最初から最後までどう進みますか?

リクエストは https://otproute.com/api/v1 に、or_live_ で始まるBearer APIキーを付けて送ります。ウガンダの国idは ug です。

1. 料金と利用可否を調べます。GET /api/v1/prices?country=ug&service=<id>。
2. アクティベーションを作成します。POST /api/v1/activations に {"service": "whatsapp", "country": "ug"} を送ります。
3. 返ってきた番号をテスト対象のアプリに入力し、コードをリクエストします。
4. activation.sms_received のWebhookで受け取るか、GET /api/v1/activations/{id} をポーリングします。
5. 中断した実行は、POST /api/v1/activations/{id}/cancel で、すぐに返金されます。

X-OTPRoute-Signature ヘッダー(t=<unix>,v1=<hex>)は、タイムスタンプ、ドット、生のボディをつなげたもののHMAC-SHA256で、キーはエンドポイントのシークレットです。これを検証し、古いタイムスタンプは拒否し、ハンドラーはアクティベーションidに対して冪等にしてください。ウガンダ向けのテストスイートでは、アカウントの上限(キー10個、Webhookエンドポイント5つ、1分あたり300リクエスト)を踏まえて設計します。詳しいリファレンスは開発者ドキュメントにあります。

クリック操作がよければ、ダッシュボードでウガンダとサービスを選び、ライブ料金を確認すると、コードが届いた時点で注文画面に表示されます。

ウガンダのコードが遅れているとき、どうするのが正解ですか?

20分のウィンドウを待ってください。料金はコードが届いた場合にのみ発生し、期限切れまたはキャンセルの際は、お客様が何も請求しなくても全額がウォレットに戻ります。

コードが何度も届かない場合は、テストしているステップでそのサービスが仮想番号を受け付けるか確認し、時間をおくか別のサービスルートで再試行し、自動テストでは試行の間に待ち時間を入れてください。連続して再注文を繰り返しても時間の無駄になるうえ、サービス側のレート制限にかかることがあります。

代わりに、ウガンダの長期回線が必要ですか?

同じアカウントが繰り返しコードを受け取る必要がある場合のみです。OTP Routeは、アメリカとカナダで専用番号をすぐに購入でき、月額$1.95からで、SMSの送受信、Webhook転送、ブラウザからの通話が付きます。ウガンダはこのセルフサービス製品の対象外です。継続して使える+256回線が必要なチームは、[email protected] にメールでご相談ください。実現できるかは現地の規則によるため、保証はできません。ウガンダ案件での2つの製品の比較は、一時番号と専用番号で取り上げています。

ウガンダのプロジェクトで、ウォレットとサンドボックスはどう使いますか?

1つのプリペイドUSDウォレットですべてをまかない、従量課金で、月額料金もプランもありません。カードまたはUSDT/USDCでチャージでき、チャージや購入のたびにPDFの請求書がメールで届きます。連携の期間中は、リクエストに応じて開発用アカウントをサンドボックスに切り替えられます。模擬の番号とコードが返されるため、本番の注文の前にOTPルーティングのロジックを検証できます。ルートは、ご自身の正当なプロダクトとアカウントにのみ、各サービスの規約とOTP Routeの利用規定(Acceptable Use Policy)の範囲内でご利用ください。

よくある質問

ウガンダ国外から、ウガンダのサインアップフローを検証できますか?

はい。OTP Gatewayで+256の番号を注文し、アプリやサービスからコードをリクエストして、ダッシュボードまたはWebhookで読み取ります。

07で始まる番号を国際形式にするにはどうしますか?

先頭の0を取り除いて+256を付けます。国内の携帯番号は、+2567に8桁が続く形になります。

APIでウガンダに使う国idは何ですか?

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

ウガンダの認証SMSは英語で届きますか?

通常は英語です。ビジネス向けメッセージでは英語が広く使われているためですが、実際の言語はサービスとアカウントの設定によります。

ウガンダのコードが届かない場合、料金はかかりますか?

いいえ。20分以内に何も届かなければ、またはキャンセルすれば、全額が自動的にウォレットに戻ります。

東アフリカの市場をまとめてテストできますか?

はい。ケニア、タンザニア、ルワンダにも同じAPI呼び出しが使えます。変わるのは国idだけで、利用可否はルートごとにライブで確認されます。

OTP Routeは、ウガンダの番号での一括サインアップに向いていますか?

いいえ。ご自身の正当なアカウントのテストと運用のためのもので、各サービスの規約とOTP Routeの利用規定(Acceptable Use Policy)が適用されます。

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