QAと市場投入チームのためのニカラグア(+505)SMS認証

+505番号はどういう構造で、データベースにはどう保持すべきですか?

ニカラグアの番号は、国番号 +505 の後に8桁が続き、国内ダイヤルにトランクプレフィックスはありません。したがって、正規のE.164形式は +505 にその8桁を付けたものだけです。

地域特有の落とし穴があります。コスタリカ(+506)、ホンジュラス(+504)、エルサルバドル(+503)、グアテマラ(+502)も国内番号が8桁なので、8桁の数字だけではどの国の番号なのか判断できません。中米向けプロダクトの実践的なルールです。

• UIが国を事前選択していても、国番号なしで電話番号を保存しないでください。
• ブラウザだけでなくサーバー側でも正規化し、インポートやAPIクライアントにも同じルールを適用します。
• テストデータに+505番号を含め、国選択のリグレッションがサポートチケットではなくアサーションの失敗として表面化するようにします。

ニカラグアでは認証メッセージにどの言語が使われますか?

公用語はスペイン語で、ほとんどのニカラグア人ユーザーの標準言語です。カリブ海沿岸では、英語系クレオール語やミスキート語などの先住民言語も話されています。大手プラットフォームは、アカウントや端末のロケールからSMSの言語を決めるため、同じサービスでも、あるテスターにはスペイン語、別のテスターには英語のテンプレートが送られることがあります。

ローカライズのQAでは、次の2点を確認します。コード入力欄まわりの自社のスペイン語(中南米)の文言が正しいこと、そして、オートフィルのヒントやテストでの正規表現による抽出といったコード解析ロジックが、メッセージ本文の英単語に依存していないことです。

なぜチームはニカラグアの番号でテストや運用を行うのですか?

ニカラグアだけで事業を始める企業は多くなく、通常は中米展開の一部として登場します。ニカラグアの認証番号が必要になる典型的な理由は次のとおりです。

• 地域ローンチの確認。 地峡の各国で、登録の流れ、通貨表示、サポートの振り分けを確認する必要があります。
• 海外在住の顧客。 近隣国や北米で働きながら、家族や銀行のために+505のSIMを持ち続けている人たちです。
• ニアショア運用。 サポートやバックオフィスの担当者がビジネスアカウントを管理し、会社として個人の電話番号とひも付けたくない場合です。
• フィンテックやマーケットプレイスのオンボーディング審査。 チームのテスト構成はフィンテックのオンボーディングで紹介しています。

ニカラグアの番号にコードを送れるサービスは?

ニカラグアでは、OTP Gatewayを通じて1,000を超えるサービスを利用できます。現在よく選ばれているのは、WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、X (Twitter)、ChatGPT (OpenAI)、Microsoft & Outlook、Amazon、Uber、Discordなどです。

このリストはスナップショットです。各組み合わせの空き状況は一日の中で変動するため、APIは固定の表ではなくリアルタイムで返します。

国ID `ni` のAPI呼び出しはどうなりますか?

or_live_ で始まるBearerキーで https://otproute.com/api/v1 に認証します。キーはDeveloperコンソールで発行され、1アカウントあたり最大10個です。ニカラグアの国IDは ni です。

1. GET /api/v1/services でサービスIDを一度だけ調べ、GET /api/v1/countries で国を確認します。
2. GET /api/v1/prices?country=ni&service=<id> でリアルタイムの価格を確認し、そのサービスが現在提供されていなければ注文を見送ります。
3. POST /api/v1/activations に {"service": "telegram", "country": "ni"} を送って注文します。返されたアクティベーションIDを保管してください。
4. +505番号を使って、アプリの認証ステップを実行します。
5. activation.sms_received イベントを待つか、GET /api/v1/activations/{id} をポーリングします。不要になったテストは POST /api/v1/activations/{id}/cancel で解放します。

すべてのWebhookには t=<unix>,v1=<hex> 形式の X-OTPRoute-Signature が含まれます。エンドポイントのシークレットで <t>.<raw body> のHMAC-SHA256として検証し、古いタイムスタンプのリクエストは破棄してください。イベントはアクティベーションIDをキーとして扱えば、再送されても問題ありません。上限は1分300リクエストで、Webhookエンドポイントは最大5つです。詳細は開発者ドキュメントとOTP API連携ガイドをご覧ください。

ダッシュボードで+505を確認する方法と、コードが届かない場合の対処

開発者でなくても、同じことを手作業で行えます。ニカラグアとサービスを選び、表示された価格を確認し、番号をアプリにコピーして、コードが画面に表示されるのを待ちます。

アクティベーションは20分間有効です。その間にSMSが届かなかった場合、またはキャンセルした場合は、全額が自動的にウォレットに戻ります。課金されるのは受信したコードだけです。配信のタイミングはサービスとルートによって異なります。何も届かない場合は、有効時間が終わるまで待ってから、時間をおいて再試行するか、注文を連続で出さずに別のサービスルートを試してください。また、その手順でサービスが仮想番号を受け付けるかも確認してください。拒否するサービスもあります。各サービスの規約を守ってください。OTP Routeの利用規定(Acceptable Use Policy)が適用されます。

ニカラグアの長期番号は利用できますか?支払いはどうなりますか?

ニカラグア向けのセルフサービスの長期回線はありません。月額$1.95からの専用バーチャル番号は、米国とカナダでのみ即時に購入できます。詳細はバーチャル番号をご覧ください。+505の長期回線が必要な場合は [email protected] までご連絡ください。ただし、可否は現地の規則次第です。

すべての費用は、プランも月額料金もない1つのプリペイドUSDウォレットから支払います。カードまたはUSDT/USDCでチャージでき、チャージごとにPDF請求書がメールで届きます。開発用アカウントでは、申請によりサンドボックスモードを有効にでき、シミュレートされた番号とコードが返されるため、CI実行でウォレット残高を消費しません。まずは新規登録からどうぞ。

よくある質問

ニカラグアにいなくても、ニカラグアのSMS OTPコードを受信できますか?

はい。OTP Gatewayが発行する+505番号は世界中どこからでも使え、コードはダッシュボードに表示されるか、Webhookに届きます。

APIでニカラグアに使う国IDは何ですか?

POST /api/v1/activations の country フィールドと、価格の取得で ni を使います。

ニカラグアの番号は、コスタリカやホンジュラスの番号と混同されますか?

国内の桁だけを保存していると、混同される可能性があります。近隣諸国も8桁の番号を使うためです。常に+505付きの完全なE.164形式で保存してください。

ニカラグアの認証番号はいくらですか?

サービスにより異なりますが、$0.20/コードからです。20分の有効時間内にSMSが届かない場合やキャンセルした場合は、自動的に返金されます。

コードはスペイン語で届きますか?

多くの場合そうですが、言語はアカウントや端末の設定に応じてサービス側が選ぶため、特定の文面を前提にしたテストは避けてください。

後のログインのために+505番号を保持できますか?

セルフサービス製品としてはできません。長期の専用回線は米国とカナダのみです。ニカラグアについては [email protected] へメールでお問い合わせください。

OTP Routeを使って、1つのプラットフォームで大量のアカウントを作成できますか?

できません。ご自身の正当なプロダクトとアカウントのテストと運用に、実在の個人または事業者につき1つずつ、各プラットフォームの規約の範囲内でご利用ください。

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