開発者・QAチーム向けのモンセラットSMS認証

そもそもなぜチームにモンセラットの番号が必要なのですか?

モンセラットは東カリブ海にある英国の海外領土で、公用語は英語です。小さな市場ですが、有用なエッジケースになります。番号は北米電話番号計画に属し、市外局番は 664 のため、米国の番号と同じ +1 で始まりながら、別の地域に属しています。カリブ海地域に展開するチームや、電話番号バリデーターを保守しているチームは、モンセラットの回線を使って、自社のコードがこの区別を正しく扱えるかを確認します。

典型的な目的は、サインアップフォームの国選択にモンセラットが表示されること、カリブ海のユーザーにとって英語のSMSテンプレートや同意文が自然に読めること、そしてトラフィックの中で珍しい地域だからという理由だけで、リスクルールが正当なユーザーを不審者扱いしないことの確認です。

+1 664 の番号はどのように保存すべきですか?

E.164形式で保存してください。+1664 に7桁の加入者番号が続く形で、プラス記号の後は合計10桁です。取り除くべきトランクの 0 はありません。+1 のプレフィックスから国を推測すると、モンセラットのユーザーが米国として分類されてしまうため、番号と並べてISO地域コード MS も記録してください。地域データが下流で重要になる理由は、OTPの国別ルーティング の記事で解説しています。

北米番号計画圏のユーザーは、市外局番の前に 1 を付けたり、プラス記号を省略したりして入力しがちです。そうした入力も受け付け、サーバー側でE.164の値に正規化し、テストのフィクスチャにも同じルールを適用してください。そうすれば、ステージングのモンセラット番号が本番と同じ挙動になります。

モンセラットの認証番号に届くのはどのサービスですか?

ms の最新スナップショットには、WhatsApp、Telegram、Google(Gmail & YouTube)、Facebook、Instagram、TikTok、Snapchat、Discord、Amazon、Netflix、Signal、Viber が並び、このルート全体では500を超えるサービスが利用できます。小さな島のルートでは在庫が短時間で変わることがあるため、昨日のペアが今日も使えると思い込まず、実行のたびに利用可否を問い合わせてください。

モンセラットのOTP APIの流れはどうなりますか?

or_live_ で始まる Bearer キーを使い、POST /api/v1/activations に本文 {"service": "<id>", "country": "ms"} を送ってアクティベーションを作成します。返ってきた番号を、サインアップフォームに入力します。コードが届くと、署名付きの activation.sms_received イベントが Webhook に送られます。X-OTPRoute-Signature の HMAC を検証し、古いタイムスタンプは破棄してください。公開エンドポイントがない場合は GET /api/v1/activations/{id} をポーリングします。有効時間が過ぎると activation.expired が届き、POST /api/v1/activations/{id}/cancel で手動停止すると activation.cancelled が発生します。再送されたイベントが一度だけ処理されるよう、ハンドラーはアクティベーション ID をキーにしてください。詳細は OTP Gateway のページをご覧ください。

ダッシュボードだけで行うこともできますか?

はい。サインインしてチャージし、サービスを選び、モンセラットを選択して番号をコピーします。コードは、20分の有効時間内に届いた時点でアクティベーション上に表示されます。1つのフローを手作業で確認する運用担当者なら、この画面だけで十分なことがほとんどです。1件のサインアップを手動で確認するテスターは、最初から最後までブラウザー内で完結でき、APIキーを作る必要すらありません。

モンセラットのテストケースでは何を確認すべきですか?

• 番号がフォームで受け付けられ、米国(US)ではなく地域 MS で保存されること。
• 自社プロダクトが送る認証SMSが、英語で正しく表示されること。
• コードの到着が遅いとき、再試行や再送ボタンが適切に動作すること。
• 分析システムや課金システムが、ユーザーを正しい領土に紐づけること。
• アプリが番号を拒否した場合のエラー文言が明確であること。

今日、使いたいアプリにモンセラットのルートがない場合は?

可用性は一日を通じて変動するため、時間をおいて再試行してください。テストにカリブ海の +1 番号が必要なだけであれば、アンギラ のような近隣のルートが現実的な代替になります。短時間のループで繰り返し注文するのは避け、試行の間隔をあけ、各有効時間が終わるのを待ってください。

課金や長期回線はどうなっていますか?

1つの前払いUSDウォレットですべてをまかない、月額料金はありません。カードまたは USDT/USDC でチャージでき、請求書(PDF)がメールで届きます。モンセラットのセルフサービスの長期番号はありません。[email protected] までお問い合わせいただけますが、提供可否は現地の規則によります。継続して保持できる Dedicated Numbers は、米国とカナダのみで、$1.95/月からです。モンセラットの連携を構築している間は、サポートが開発用アカウントをサンドボックスモードにでき、シミュレートされた番号とコードが返されます。従量課金の仕組みは 料金ページ で説明しています。

よくある質問

島にいなくてもモンセラットのSMS OTPを受信できますか?

はい。OTP Route が一時的な +1 664 番号を発行するので、どこからでも利用でき、コードはダッシュボードに表示されるか、API 経由で届きます。

APIでのモンセラットの国IDは何ですか?

アクティベーションの作成時や料金の照会時に、country フィールドに ms を指定します。

モンセラットのアクティベーションはどのくらいの間、有効ですか?

20分間です。その間に番号が受信できるコードは1件で、その後、注文は終了します。

コードが届かなかった場合、課金されますか?

いいえ。タイムアウトまたはキャンセルされたアクティベーションは、全額が自動的にウォレットに返金されます。

なぜバリデーターは +1 664 の番号を米国のものだと判断するのですか?

国番号だけを見ているためです。市外局番を確認し、地域 MS を保存して、モンセラットのユーザーが正しく分類されるようにしてください。

一部のアプリでモンセラットの番号が拒否されるのはなぜですか?

一部のサービスは仮想番号を受け付けません。これは OTP Route が制御できる範囲外であり、だからこそ未使用の注文は返金されます。各サービスの利用規約を守ってください。

連携を構築するためのサンドボックスはありますか?

はい、リクエストにより提供されます。サポートが開発用アカウントをサンドボックスに切り替えると、シミュレートされた番号とコードが返され、ウォレットの資金を使わずにテストできます。

モンセラットの認証番号の料金はいくらですか?

1コード $0.20 からです。正確な料金はサービスによって異なり、GET /api/v1/prices で返されます。

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