製品テストのためにマダガスカル（+261）のワンタイムパスコードを受信する

マダガスカルの番号でテストや運用を行うのは誰で、なぜか？

マダガスカルはフランス語圏の市場で、マラガシ語が国語であり、両方が公用語です。この二言語の環境は、アフリカのユーザーにフランス語の文言を提供するあらゆる製品にとって、有用な確認ポイントになります。パリでは問題なく読めるサインアップ画面でも、+261の番号形式やモバイル中心のブラウザで壊れることがあるからです。

マダガスカルの認証番号が必要になりやすいチームには、次のようなものがあります。

• アンタナナリボのフランス語圏サポートとBPO運用。 メッセージングやソーシャルのプラットフォームで業務用アカウントを運用し、社員の個人電話を結び付けたくない。
• インド洋地域とフランス語圏アフリカに展開するプロダクトチーム。 マーケティング施策の前に、オンボーディングが機能することを確認する必要がある。
• ディアスポラ向けのアプリ。 顧客は海外に住んでいるが、すでに持っているマダガスカルの番号で登録する。

いずれの場合も目的は同じで、モックを信用するのではなく、実際の+261ルートに本物のメッセージが届くのを確認することです。

+261番号は、データベースではどのように見えるのか？

国内では、マダガスカルの携帯番号はトランクの0を付けた10桁で書かれ、たいてい03で始まります。国際形式ではその0が消え、+261に9桁を続けた形になります。

ユーザーテーブルの実用的なルールは次のとおりです。

• E.164に変換するときは、トランクの0を取り除きます。+2610…は常に誤りです。
• スペースで区切った、見慣れた表記での入力を許容し、そのうえで数字と先頭のプラス記号以外をすべて取り除きます。
• 携帯の場合、国内の桁がちょうど9桁残っているか確認します。

グローバルなアプリのメッセージは、アカウントの言語に応じて、通常フランス語か英語で届き、マラガシ語のテキストはあまり多くありません。パスコードを抽出するときは、翻訳された単語ではなく、数字に合わせてください。

マダガスカルのルートで使えるサービスは？

現在、1,000を超えるサービスがマダガスカルの番号にコードを届けられます。よく使われるものには、WhatsApp、Facebook、Telegram、Google（Gmail＆YouTube）、TikTok、Instagram、Microsoft＆Outlook、LinkedIn、Viber、imo、Signal、ChatGPT（OpenAI）があります。

この顔ぶれは一日の中で変わるため、昨日の一覧がまだ通用すると考えず、テスト実行の前にGET /api/v1/servicesで最新の状態を読み取ってください。

+261のコードを自社のシステムに取り込むには？

https://otproute.com/api/v1のREST APIは、or_live_で始まるBearerキーを使います。1アカウントにつき、キー10個とWebhookエンドポイント5つを保持でき、上限は1分あたり300リクエストです。

マダガスカルの国IDはmgです。すっきりした手順は次のとおりです。

1. GET /api/v1/prices?country=mg&service=telegramで価格を取得します。
2. POST /api/v1/activationsに{"service": "telegram", "country": "mg"}を渡してアクティベーションを作成します。
3. 返された番号を、テスト対象の製品に入力します。
4. エンドポイントでactivation.sms_receivedを受け取ります。ポーリングの方がよければ、GET /api/v1/activations/{id}を呼び出します。
5. シナリオを放棄する場合は、POST /api/v1/activations/{id}/cancelで終了させ、保留中の金額を返金します。

信頼する前に、Webhookはすべて検証してください。X-OTPRoute-Signatureヘッダーにはt=<unix>,v1=<hex>が入っており、v1は、エンドポイントのシークレットによる<t>.<raw body>のHMAC-SHA256と一致しなければなりません。古いタイムスタンプのものは拒否し、同じ配信が繰り返されても害がないよう、書き込みはアクティベーションIDをキーにしてください。Webhookキャプチャのガイドで、ハンドラーの全体を順に説明しています。

技術者以外のスタッフ向けに、ダッシュボードで使う方法はあるか？

あります。運用リーダーはログインしてOTP Gatewayを開き、マダガスカルとサービスを選び、表示された価格を確認して注文できます。+261番号はアクティベーションカードに表示され、受信したテキストも同じカードに現れます。ターミナルもキー管理も不要で、20分のウィンドウは、API経由の場合とまったく同じように動作します。

マダガスカルのコードが届かなかったら、どうすればよいか？

失敗の多くは、設定ではなく送信側のサービスに原因があります。エスカレーションする前に、次を確認してください。

• アクティベーションに20分間をフルに与えます。再送が遅れて届くことがあります。
• そのサービスが仮想番号を受け付けるか確認します。拒否するものもあり、だからこそ応答のなかったアクティベーションは自動で返金されます。
• 間をおいてから再試行するか、同じフローを試せる別のサービスルートに切り替えます。
• 新しい注文を立て続けに出さないでください。配信が良くなるわけではなく、レート制限を無駄に消費するだけです。

ウィンドウが閉じるまでにSMSが届かなかった場合やキャンセルした場合は、チケットを出さなくても全額がウォレットに戻ります。

長期回線と利用料金の支払いについて

OTP Routeには、セルフサービスで利用できるマダガスカルの長期番号はありません。Dedicated Numbersは米国とカナダのみで、$1.95/月からです。長期の+261回線が必要な場合は、[email protected]にメールをいただければ、現地の規則で可能かどうかをチームがお答えします。提供をお約束するものではありません。どの製品がどの用途に合うかは、一時番号と専用番号の比較の記事で説明しています。

支払いは、プリペイドのUSDウォレット1つで行います。サブスクリプションもプランの選択もありません。カードまたはUSDT/USDCでチャージし、チャージごとにPDFの請求書がメールで届きます。組み合わせごとの最新の料金は料金ページにあります。開発者はサンドボックスモードもリクエストでき、模擬の番号とコードが提供されるので、実際の支出が始まる前に連携を検証できます。

よくある質問

現地のSIMなしで、アプリのマダガスカル向けサインアップフローを確認できるか？

はい。OTP Gatewayでサービス用の+261番号を注文すると、コードがダッシュボードに表示されるか、Webhookに届きます。料金は、届いた場合のみです。

OTP Routeはマダガスカルにどの国IDを使うか？

IDはmgで、POST /api/v1/activationsなどの呼び出しで使います。

マダガスカルの携帯番号を保存するとき、先頭の0を残すべきか？

いいえ。トランクの0を外して+261に9桁を続けた形で保存し、スペースを入れた整形は表示のときだけにしてください。

パスコードのテキストは何語か？

送信元とアカウントの設定によります。通常はフランス語か英語なので、固定の文言ではなく、数字のコードを解析してください。

テスト用の+261番号は後で再利用できるか？

各アクティベーションは、20分以内の1つのコード用に作られています。時間を置いて再びログインする必要があるアカウントには別の方法が必要で、セルフサービスで使える長期番号は米国とカナダだけです。

利用ルールはあるか？

あります。各サービスの規約とOTP RouteのAcceptable Use Policyを守り、番号は自社製品のテストや、本物の業務用アカウントの運用に使ってください。実在する1人または1事業者につき、アカウントは1つです。

マダガスカルへのOTPルーティングには、別の契約が必要か？

いいえ。同じウォレットとSMS認証APIがすべての国で使え、メールコードまたはGoogleサインインでサインアップできます。

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