チームに+223のSIMがなくても、マリのサインアップフローをテストする方法

マリでローンチするのに、現地SIMを持つ人がいない。どうすればいい?

QAリードにはおなじみの悩みです。プロダクト側はバマコでのマーケティング施策の前にマリのサインアップ経路を検証したいと考え、電話番号欄はすでに+223を受け付けますが、エンジニア全員の端末には欧州か北米のSIMが入っています。同僚の個人番号を借りる方法は壊れやすく、テストスイートにも拡張できず、スタッフの個人データがテストアカウントに流れ込んでしまいます。

OTP Gatewayのマリ認証番号は、この限定的な問題を解決します。本物の+223番号を1コードのためだけに使い、その後は破棄します。スクリプトから操作することも、ダッシュボードから手動で注文することもでき、回帰テストへの組み込み方はQAテストとCI/CDのページで説明しています。

マリの認証番号でコードを受け取れるアプリは?

マリの現在のスナップショットには、WhatsApp、Facebook、Telegram、TikTok、Google(Gmail & YouTube)、Instagram、Snapchat、imo、Viber、Signal、Microsoft & Outlook、ChatGPT(OpenAI)、LinkedInが含まれます。ゲートウェイ全体では、マリで1,600を超えるサービスが利用できます。

利用可否は固定ではありません。ルートは一日の中で開いたり閉じたりするので、スクリプトは昨日の結果が今も有効だと決めつけず、実行時にサービスが購入可能か確認してください。

コードでマリOTP APIのフローはどう動きますか?

リクエストは https://otproute.com/api/v1 に、or_live_ で始まるBearerキーを付けて送ります。キーはDeveloperコンソールで発行し、1アカウントにつき最大10個です。

1. GET /api/v1/services と GET /api/v1/countries でIDを一度取得します。マリは ml です。
2. GET /api/v1/prices?country=ml&service=<id> でリアルタイム価格を確認します。
3. POST /api/v1/activations で注文します。例:{"service": "whatsapp", "country": "ml"}。返ってきたアクティベーションIDを保持します。
4. 返された+223番号をアプリの認証フォームに入力します。
5. GET /api/v1/activations/{id} でコードを取得するか、Webhookで通知を受けます。使わない番号は POST /api/v1/activations/{id}/cancel で解放します。

Webhookでは、エンドポイント(5つまで登録可能)で activation.sms_received、activation.expired、activation.cancelled を購読します。X-OTPRoute-Signature は、エンドポイントのシークレットで "<t>.<raw body>" のHMAC-SHA256を計算して検証し、古いタイムスタンプは拒否して、ハンドラーはアクティベーションIDに対して冪等にしてください。アカウントの上限は1分あたり300リクエストで、実装例はAPIインテグレーションガイドにあります。

8桁でトランクプレフィックスなし:マリの番号の保存方法

マリは8桁のクローズド番号計画で、トランクプレフィックスがありません。そのため、国内でダイヤルする番号と、海外で+223の後に続く8桁は同じです。正規化は非常に簡単で、E.164形式は +223 に8桁を続けたものであり、追加や削除が必要な先頭のゼロはありません。ただし、10桁の市場向けに書かれた汎用ルールは有効なマリの入力を拒否してしまうため、桁数は明示的に検証してください。

海外アプリからの認証SMSは通常フランス語で届き、日常生活で最も広く話されているのはバンバラ語です。そのためコードはフランス語や英語のテンプレートに入って届きがちです。フレーズの照合ではなく、数字パターンで抽出してください。

そもそもなぜここでテストするのか。西アフリカでモバイルマネー関連のプロダクトを立ち上げるチーム、バマコから現地スタッフのアカウントを運用するNGOや物流事業者、フランスや近隣国にいる多数のマリ系ディアスポラ向けのアプリは、いずれも+223の経路が動く必要があります。展開が地域をまたぐ場合は、セネガルのようなルートの確認も組み合わせてください。

+223のコードが沈黙したままのときの対処

SMSが届かない原因は、多くの場合、連携ではなくルートやサービス側にあります。バグ報告を出す前に確認してください。

• 20分のウィンドウを最後まで待ちます。送信元によっては、メッセージをまとめて放出するものがあります。
• サービスが仮想番号を拒否していないか確認します。拒否するサービスもあり、その場合は自動返金で保護されます。
• 短時間に再注文を繰り返さず、時間をおいて戻るか、別のサービスルートを試します。
• 放棄したアクティベーションはキャンセルし、残高をすぐに復元します。

ウィンドウが閉じるまでに何も届かなかった場合、またはその前にキャンセルした場合は、全額がウォレットに戻ります。

チームでマリの番号を長期間保持できますか?

OTP Routeには、マリ向けのセルフサービスの長期番号はありません。ml で利用できるのは、使い切りのOTP Gatewayのみです。

OTP RouteのDedicated Virtual Numbersは、ウォレットから更新され、受信・送信SMSとブラウザ通話に対応しますが、米国とカナダのみで、$1.95/月からです。運用で+223の継続回線が重要な場合は [email protected] までメールしてください。ゲートウェイ以外の提供は現地の規則によるため、保証できません。

マリのOTPルーティングの支払いと、費用をかけないテスト

1つのプリペイドUSDウォレットがすべての国をまかないます。従量課金で、月額料金もプラン選択もありません。カードまたはUSDT/USDCでチャージでき、チャージごとにPDFの請求書がメールで届きます。

開発中は、サポートに依頼して開発アカウントをサンドボックスモードに切り替えてもらってください。シミュレートされた番号とコードが返るため、ウォレットを使わずにSMS認証APIの一連の手順を通しでリハーサルできます。本物の番号は、自社製品と正当なアカウントのみに使い、各サービスの規約と利用規定(Acceptable Use Policy)を守ってください。最新の料金は料金のページにあります。

よくある質問

現地SIMを買わず、渡航もせずに、マリのサインアップを検証できますか?

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

OTP Route APIでのマリのIDは何ですか?

マリは ml で、価格照会とアクティベーション要求のボディの両方に使う値です。

マリの番号には取り除くべき先頭のゼロがありますか?

いいえ。マリにはトランクプレフィックスがなく、有効な番号は +223 に8桁が続く形です。

マリのSMS OTPはいくらかかりますか?

マリのコードは$0.20/コードからで、アプリごとの金額は購入前にAPIがリアルタイムで提示します。

アプリがコードを送ってこなかった場合、損をしますか?

いいえ。20分のウィンドウの終了までにSMSが届かなかったアクティベーション、またはキャンセルしたアクティベーションは、全額がウォレットに返金されます。

コーディングのスキルがなくても使えますか?

はい。ダッシュボードでマリとサービスを選んで番号を注文し、アプリに貼り付けると、アクティベーション画面にコードが表示されます。

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