+258のSIMを誰も持っていないチームでモザンビークのサインアップをテストする

モザンビークでのローンチが電話認証で止まっています。どこから始めればよいですか?

よくある状況です。アプリは翻訳済みで、決済画面も準備できているのに、最後に残ったチケットには、モザンビークの顧客が実際にサインアップを完了できるか誰かが確認する必要がある、と書かれています。誰も +258 のSIMを持っておらず、ローミングの手配には時間がかかり、同僚の個人の電話はテスト用の機材ではありません。

OTP Gateway なら、この依存がなくなります。特定のサービス向けに +258 の番号を1つリクエストし、テスト中の画面で一度だけ使えば、届いたコードが手元に返ってきます。QAとテスト自動化、ローンチ前のチェックリスト、そして誰かの端末を借りずに顧客の報告を再現したいサポートチームに適しています。

+258の番号はどのような形式で、どう保存すればよいですか?

モザンビークの国番号は +258 で、国内番号は9桁です。取り除くべきトランクの 0 はないため、国内形式と国際形式の違いは国番号の有無だけです。携帯番号は 8 で始まります。実際には次のようになります。

• E.164形式、つまり +258 に9桁が続く形を保存し、表示用の整形は別に行う。
• 他の市場の習慣で先頭に 0 を付けた入力は弾くか、検証の前に静かに取り除く。
• 国内でしか発信しないユーザーの番号にも国番号を残す。SMSの送信側や Webhook の受信側には必要です。

公用語はポルトガル語なので、メッセージはサービスやアカウントのロケールに応じて、ポルトガル語または英語で届く場合があります。自社のテンプレートがポルトガル語の場合は、ç や ã のようなアクセント付き文字が正しく表示されるか確認してください。ASCII以外のテキストはSMSのエンコードを変え、メッセージが複数パートに分割される可能性があります。

モザンビークの認証番号にコードを送れるサービスは?

すべてのサービスを合わせると、モザンビークのスナップショットには1,600を超えるものが数えられます。よくリクエストされるのは、WhatsApp、Telegram、Facebook、Instagram、Google(Gmail & YouTube)、Microsoft & Outlook、LinkedIn、Uber、Signal、Viber、Netflix、Airbnb、Discord、Claude などです。

利用可否は固定ではなくリアルタイムです。同じサービスでも、ある時間帯は十分にあり、後で足りなくなることがあります。テスト計画に一覧をハードコードせず、注文のたびにAPIかダッシュボードから読み取ってください。

モザンビークのOTP APIは、最初から最後までどう動きますか?

開発者にとって、連携は https://otproute.com/api/v1 に対する短い手順で、or_live_ で始まる Bearer キーで署名します。

1. GET /api/v1/countries と GET /api/v1/services から、モザンビークのID(mz)とサービスIDを取得します。
2. GET /api/v1/prices?country=mz&service=<id> で、現在の料金と番号が用意されているかを確認します。
3. POST /api/v1/activations に {"service": "telegram", "country": "mz"} を送り、返ってきたアクティベーション ID と番号を保持します。
4. activation.sms_received がエンドポイントに届いたらコードを取得するか、数秒おきに GET /api/v1/activations/{id} を照会します。
5. テストを中止する場合は POST /api/v1/activations/{id}/cancel を呼び出します。

Webhook のリクエストには X-OTPRoute-Signature ヘッダー(t=<unix>,v1=<hex>)が付き、これはエンドポイントのシークレットをキーにした <t>.<raw body> の HMAC-SHA256 です。これを検証し、古いタイムスタンプは拒否し、ハンドラーはアクティベーション ID に対して冪等にします。キーは Developer console にあり(最大10個、Webhook エンドポイントは5つ)、レート制限は1分あたり300リクエストです。エラー処理を含む同じSMS認証APIの流れは、OTP API連携ガイド で紹介しています。

開発者でない人も、ダッシュボードで+258の番号を注文できますか?

はい。APIとまったく同じOTPルーティングを使います。メールアドレスと6桁のコード(または Google)で アカウントを作成 し、資金を追加して OTP Gateway を開き、モザンビークとサービスを選んで、表示された料金を確認します。番号はすぐに表示されるので、アプリに貼り付けると、コードが届いた時点で同じページに表示されます。アカウント自体には、認証アプリによる二要素サインインも利用できます。

なぜコードが届かなかったのか、次に何を試すべきですか?

すべてのアクティベーションには20分の有効時間があります。SMSが届かないまま終了した場合、またはキャンセルした場合は、全額が自動的にウォレットに戻ります。課金されるのはコードが届いたときだけです。

実行のたびに空振りが続く場合は、次を試してください。

• 有効時間を最後まで待つ。コードが届くまでの速さは、サービスとルートによって異なります。
• そのサービスが仮想番号を受け付けるか確認する。完全に拒否するものもあります。
• 時間をおいて再試行するか、テストがモザンビークの番号を必須としない場合は別のルートを選ぶ。
• 注文エンドポイントを連打せず、試行の間隔をあけ、失敗を比較できるよう各アクティベーション ID を記録する。

モザンビークの固定回線はありますか?課金はどうなりますか?

モザンビーク向けのセルフサービスの長期番号はありません。専用回線は米国とカナダのみで、$1.95/月からです。モザンビークの回線を継続的に必要とするチームは [email protected] にメールでご相談いただけますが、可能かどうかは現地の規則によるため、難しい場合もあります。

支払いは、1つの前払いUSDウォレットからの従量課金で、サブスクリプションはありません。チャージはカードと USDT/USDC のステーブルコインのどちらも利用でき、そのたびにPDFの請求書がメールで届きます。構築やデバッグ向けには、リクエストにより開発用アカウントをサンドボックスに移せるので、コストをかけずにシミュレートされた番号とコードをコードに流せます。料金の表示方法は 料金ページ をご覧ください。

よくある質問

モザンビークのサインアップフローを、国外からテストできますか?

はい。+258 の番号は OTP Gateway から取得するので、チームはどこからでもテストを実行し、ダッシュボードか API でコードを読み取れます。

モザンビークのAPI上の国IDは何ですか?

GET /api/v1/prices と、POST /api/v1/activations の本文で mz を使用します。

モザンビークの番号に先頭の 0 は必要ですか?

いいえ。モザンビークには国内のトランクプレフィックスがないため、保存形式は +258 に9桁を続けた形だけです。

モザンビークのSMS OTPを受信するのにいくらかかりますか?

コードは1コード $0.20 からで、各サービスの正確な料金はAPIからリアルタイムで返され、注文前にダッシュボードにも表示されます。

+258のテスト番号は、来週のログインにも使えますか?

使えない前提で計画してください。OTP Gateway の番号は1回のコード用であり、長期の専用番号は米国とカナダでのみ提供されます。

これらの番号で認証してよい対象に決まりはありますか?

はい。自社の正当なプロダクトとアカウントのテストと運用にのみ使用し、各サービスの利用規約と、OTP Route の利用規定(Acceptable Use Policy)を守ってください。

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