モンテネグロ(+382)の認証番号:プロダクト・QAチーム向け

なぜモンテネグロをテスト対象に加えるのか?

モンテネグロはアドリア海沿岸の小さな市場ですが、多くのロードマップに登場します。西バルカン地域に展開するプロダクトは、言語が近いため一度のローカライズで複数国をカバーできることから、セルビア、ボスニア・ヘルツェゴビナ、クロアチアとあわせてリリースするのが一般的です。旅行・予約・配車アプリは沿岸の観光シーズンを意識しますし、海外在住のモンテネグロ人顧客を抱える企業は、+382 のユーザーがサインアップ時に何を体験するかを確認したいと考えます。

公用語はモンテネグロ語で、セルビア語、ボスニア語、アルバニア語、クロアチア語も公的に使われており、テキストはラテン文字でもキリル文字でも表示され得ます。モンテネグロの認証番号があれば、実ユーザーが触れる前に、電話番号ステップが正しく動作するかをQAで確認できます。

+382の携帯番号はどう表記され、どう保存すべきですか?

国内ではモンテネグロの番号には先頭の 0(トランクプレフィックス)が付き、携帯番号は 06x に続けてさらに6桁をダイヤルします。0 を除いた国内番号は8桁です。E.164形式にするには 0 を外して国番号を前置します。つまり国内表記の 06x xxx xxx は +3826x xxx xxx(スペースなしで保存)になります。

自社システムでの実践ルール:

• 先頭の 0 があってもなくても入力を受け付け、保存前に正規化する。
• 保存するのは正規の +382… 文字列のみとし、表示用の整形は画面側で行う。
• 番号帯は再割り当てされ、ユーザーは事業者間で番号ポータビリティを使うため、携帯のプレフィックスを妥当性チェックにハードコードしない。

モンテネグロのOTPメッセージは何語で届きますか?

グローバルなアプリの多くは、英語、またはユーザーがアプリ内で選んだ言語でコードを送ります。地域向けにローカライズしているサービスでは、ラテン文字のモンテネグロ語やセルビア語、場合によってはキリル文字(Unicode SMSとして送信)が想定されます。送信側のテンプレートが変わっても成功していたテストが壊れないよう、固定のフレーズではなく数字列を探すロジックにしてください。

`me` ルートではどのサービスが利用できますか?

現在のスナップショットでは、モンテネグロ向けに1,400を超えるサービスが掲載されています。よく使われるものとして、西バルカン全域で広く使われている Viber のほか、WhatsApp、Telegram、Instagram、Facebook、Google(Gmail & YouTube)、TikTok、Snapchat、Signal、LinkedIn、Discord、Amazon、Airbnb、Uber があります。

ある時点で何が利用できるかは当社のキャリアパートナーの状況によって決まり、一日の中で変動します。長期間キャッシュせず、GET /api/v1/services から最新の一覧を取得するか、ダッシュボードで確認してください。

SMS認証APIでモンテネグロのOTPを受信するには?

Developer console で Bearer キー(プレフィックス or_live_)を作成し、次の手順に進みます。

1. GET /api/v1/prices?country=me&service=<id> で現在の料金を確認します。
2. POST /api/v1/activations に {"service": "viber", "country": "me"} のような本文を送って注文します。
3. Webhook で activation.sms_received イベントを受け取るか、GET /api/v1/activations/{id} を適度な間隔でポーリングします。
4. 使わなかった注文は POST /api/v1/activations/{id}/cancel でキャンセルします。

配信ごとに X-OTPRoute-Signature ヘッダーを確認してください。エンドポイントのシークレットを使い、タイムスタンプ・ドット・生の本文に対する HMAC-SHA256 を計算して比較し、古いタイムスタンプは破棄します。再送された配信が一度だけ処理されるよう、ハンドラーはアクティベーション ID をキーにします。詳細は HMAC Webhook ガイド と APIドキュメント をご覧ください。アカウントあたり、キーは最大10個、Webhookエンドポイントは5つ、リクエストは1分あたり300回まで利用できます。

ダッシュボードでの手順と、コードが届かない場合の対処は?

開発者でない方も、ダッシュボードでモンテネグロとサービスを選び、料金を確認して注文するだけで、テスト用の +382 番号を取得できます。コードは +382 番号の隣に表示されます。

各アクティベーションの有効時間は20分です。課金されるのはコードが届いたときだけで、何も届かないまま時間切れになった場合やキャンセルした場合は、全額がウォレットに戻ります。コードが届かないときは、有効時間を最後まで待ち、そのサービスが仮想番号を受け付けるかを確認したうえで、短い間隔で連続注文するのではなく、時間をおくか別のサービスルートで再試行してください。

モンテネグロの番号を保持できますか?支払いの仕組みは?

+382 のセルフサービスの長期回線はありません。Dedicated Numbers は米国とカナダのみで、$1.95/月からです。モンテネグロの番号を長く使いたい場合は [email protected] にメールでご相談いただけますが、提供可否は現地の規制によります。

OTP Route はサブスクリプション不要の前払いUSDウォレットで運用されます。カードまたは USDT/USDC でチャージでき、チャージごとにPDFの請求書が発行されます。開発用アカウントでサンドボックスモードを依頼すると、シミュレートされた番号でエンドツーエンドのテストができます。番号は自社のプロダクトとアカウントにのみ使用し、各サービスの利用規約を守り、利用規定(Acceptable Use Policy)が適用されることにご留意ください。

よくある質問

モンテネグロのSIMカードなしで +382 のコードを受信できますか?

はい。OTP Gateway が1回の認証用にモンテネグロの番号を発行し、コードはダッシュボードに表示されるか、API 経由でお使いのシステムに届きます。

モンテネグロの番号は先頭の 0 を付けて保存すべきですか?

いいえ。0 は国内のトランクプレフィックスです。+382 で始まるE.164形式で保存し、ローカル表示が必要な場合にのみ 0 を付け直してください。

APIでのモンテネグロの国IDは何ですか?

me です。料金の問い合わせでも、アクティベーションのリクエスト本文でも使用します。

モンテネグロの認証番号の料金はいくらですか?

1コードあたり$0.20 からです。モンテネグロの個別のサービスの料金は料金エンドポイントから返されるため、注文のたびにスクリプトで確認できます。

Viber などのアプリが何も送ってこなかった場合、+382 の注文は返金されますか?

20分の有効時間がSMSなしで終了した場合、またはキャンセルした時点で、全額がウォレットに返金されます。

モンテネグロの番号でキリル文字のOTPメッセージをテストできますか?

テスト対象のサービスがキリル文字で送信する場合に限ります。内容は送信側が決めるためです。どの文字体系でも数字を抽出できるようにパーサーを作ってください。

モンテネグロ向けのOTPルーティングはCIパイプライン内で使えますか?

はい。多くのチームがテストランナーから API 経由で注文しています。不安定な再試行を避けるパターンは CIでのOTPテスト をご覧ください。

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