スペイン語QAのためのウルグアイ認証番号

ウルグアイに専用のテストケースを用意する価値があるのはなぜですか?

モンテビデオは、より広い地域にサービスを提供するソフトウェアチームの拠点としてよく知られるようになり、ウルグアイはメルコスールの中でアルゼンチンとブラジルの間に位置しています。ラプラタ川流域をまたいでローンチするプロダクトは、ここを初期の市場として扱うことが多く、現地のニアショアのエンジニアリングチームが、スペイン語圏ユーザー向けのQAを担当していることもよくあります。

この組み合わせから、実用上のニーズが生まれます。プリペイドSIMでいっぱいの引き出しなしに、実際の+598番号をサインアップフォームに入れ、スペイン語のSMSを受信し、フロー全体を確認する確実な方法です。OTP Routeはテストごとに番号を用意し、コードを自社のシステムに返します。

典型的な場面は、スペイン語にローカライズしたオンボーディング画面が+598番号を受け付けるかの確認、フィンテックやマーケットプレイスのアプリがワンタイムコードを正しい宛先に送っているかの確認、そして地域のサポート担当者が個人の携帯を公開せずに、ビジネスアカウントを認証する手段を持てるようにすることなどです。

+598の電話番号はどのような形式ですか?

ウルグアイの国番号は+598で、トランク接頭辞は0です。国内では、携帯番号は09に7桁を続けて書きます。E.164では、ゼロを取り除いて+598 9と7桁になり、国番号の後は8桁です。

ユーザーは両方の形で入力するため、入力時に正規化してください。スペースとトランクのゼロを取り除き、E.164だけを保存します。公用語はスペイン語なので、ローカライズされたサービスからの認証テキストは通常スペイン語で届き、数字の周りに「código」などの言葉が付きます。フレーズに一致させるのではなく数字の並びを抽出することで、抽出ロジックを言語に依存しないものに保ってください。

ウルグアイのルートでは、どのサービスが使えますか?

ウルグアイは現在、1,700を超えるサービスを提供しています。現時点で人気のものには、WhatsApp、Instagram、Uber、Netflix、Facebook、Telegram、Google (Gmail & YouTube)、TikTok、X (Twitter)、Discord、AliExpress、Microsoft & Outlookがあります。

キャリアパートナーは一日の中で提供枠を入れ替えるため、決定的なリストは、注文する時点で GET /api/v1/services とダッシュボードが報告する内容です。

APIでウルグアイのSMS OTPを受信するにはどうしますか?

Developerコンソールでキーを生成します。キーの接頭辞は or_live_ で、https://otproute.com/api/v1 に対するBearerヘッダーに指定します。

1. 料金を調べます。GET /api/v1/prices?country=uy&service=instagram。
2. 注文します。JSONボディに uy とサービスidを指定して、POST /api/v1/activations を送ります。
3. 返ってきた+598の番号を、テスト対象のフローに入力します。
4. スペイン語のメッセージは、activation.sms_received イベントがエンドポイントに届いたとき、または短い間隔で GET /api/v1/activations/{id} を確認することで受け取ります。
5. 使わないアクティベーションは POST /api/v1/activations/{id}/cancel でキャンセルします。

各Webhookで X-OTPRoute-Signature のHMACを確認し、古いタイムスタンプは拒否し、再配信されたイベントが同じコードを二重に書き込まないよう、アクティベーションidを冪等性キーとして保存します。1アカウントにつき、キー最大10個、Webhookエンドポイント最大5つが許可され、上限は1分あたり300リクエストで、並列のテストワーカーには十分です。これらの手順を自動化したスイートに組み込む方法は、連携ガイドとCIパイプラインの記事で紹介しています。

クリックで済ませたい場合は?ダッシュボードの手順

プロダクトマネージャーやサポート担当者は、同じ作業を手作業で行えます。サインインしてOTP Gatewayを開き、サービスとウルグアイを選び、表示された料金を確認して注文します。+598の番号はすぐに表示され、コードは送信されると同じページに届きます。

各アクティベーションは20分間有効で、料金はコードが配信されたときにのみ発生します。何も届かない場合は、ウィンドウが終わるまで待ち、サービスが仮想番号を受け付けるか確認し、時間をおいて再試行するか、アルゼンチンやブラジルでテストしてください。短時間に何度も再注文するのは避けてください。

ウルグアイの番号を長期間保持できますか?

そのためのセルフサービスの選択肢はありません。OTP Routeの専用仮想番号は、アメリカとカナダでのみ利用でき、月額$1.95からで、SMS受信、SMS送信、ブラウザ通話が含まれます。長期の+598回線については [email protected] にメールしていただければ、チームが検討しますが、現地の規則によって決まるため、提供されない場合もあります。適切なモデルを選ぶには、一時番号と専用番号の比較をお読みください。

+598のアクティベーションの支払いはどうなっていますか?

OTP Routeは、月額料金のない1つのプリペイドUSDウォレットを使います。残高はカードまたはUSDT/USDCのステーブルコインでチャージでき、支払いのたびにPDFの請求書がメールで届くため、この地域でクライアントに請求する代理店にとって精算が簡単です。現在の残高は、GET /api/v1/balance でいつでも確認できるほか、料金ページでも確認できます。開発者は、開発用アカウントのサンドボックスへの切り替えを依頼でき、エンドツーエンドのテスト用に模擬の番号とコードが返されます。サービスはご自身の正当なアカウントとプロダクトにのみ使用し、各プラットフォームの規約に従い、利用規定(Acceptable Use Policy)を守ってください。

よくある質問

モンテビデオにいなくても、ウルグアイのサインアップフローを検証できますか?

はい。どこからでも国 uy でアクティベーションを注文し、+598の番号を入力して、ダッシュボード、ポーリング、またはWebhookでコードを読み取ります。

09Xで始まる番号をE.164に変換するにはどうしますか?

先頭の0を取り除いて+598を付けます。すると、国番号の後に9で始まる8桁が残ります。

ウルグアイの認証番号の開始価格はいくらですか?

$0.20/コードからです。サービスごとのライブ価格は、料金エンドポイントとダッシュボードから取得できます。

ウルグアイのコードはスペイン語で届きますか?

メッセージをローカライズするサービスでは、多くの場合そうです。パーサーは、周囲の言語に関係なく数字を抽出するようにしてください。

コードが届かなかった場合、料金は請求されますか?

いいえ。20分以内にSMSが届かない場合、またはキャンセルした後は、全額がウォレットに戻ります。

実際の課金なしで、ウルグアイに対してCIのテストを実行できますか?

サポートに依頼して、開発用アカウントをサンドボックスに切り替えてもらってください。番号とコードが模擬されます。

ウルグアイ向けのOTPルーティングは、多数のアカウント作成に適していますか?

いいえ。ご自身の正当なプロダクトのテストと運用のためのもので、アカウントは本人または事業者1つにつき1つ、各サービスの規約の範囲内とします。

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