ベネズエラ(+58)の認証コードをテストスイートに取り込む方法

ベネズエラの番号で先頭の0がバグの原因になるのはなぜですか?

ベネズエラの国番号は+58で、国内では番号の先頭に市外・トランク接頭辞の0を付けて表記します。携帯番号は、国内でダイヤルする際は0412、0414、0416、0424、0426のいずれかで始まり、その後に7桁が続きます。E.164形式ではこの0が消え、0414 123 4567は+584141234567になります。

よくある不具合は、ユーザーが入力した値の前にそのまま+58を付けてしまい、どのサービスも受け付けない+580414…になるケースです。次の対策で防げます。

• 選択された国がベネズエラの場合、国番号を付ける前に先頭の0を1つだけ取り除く。
• 正規化済みのE.164文字列だけを保存し、表示用の整形は描画時に行う。
• ローカル形式で入力し、保存値を検証するテストケースを追加する。

OTP Gatewayで取得した+58のテスト用番号は最初から国際形式で届くため、こうしたアサーションの基準値として便利です。

ベネズエラのユーザー向けのローカライズQAでは何を確認すべきですか?

公用語はスペイン語で、ベネズエラのユーザーの多くはスペイン語の表示を期待します。グローバルなプラットフォームの認証メッセージは通常、アカウントや端末のロケールに従うため、設定が異なるとテスターに届くメッセージが日によってスペイン語だったり英語だったりします。周囲の文言ではなく、数字そのものを探す抽出ロジックを書いてください。

自社側では、電話番号入力画面とコード入力画面のラテンアメリカ向けスペイン語の文言、無効な番号のエラーメッセージ、再送タイマーの表示を見直しましょう。これらは、ユーザーが最も離脱しやすい瞬間に目にする文字列です。

ベネズエラの番号はプロダクトチームにとってどんな場面で重要ですか?

ベネズエラには、ラテンアメリカ、スペイン、米国に広がる大きなディアスポラがあり、移住後も+58のSIMを持ち続ける人が少なくありません。そのため、ベネズエラの番号は国内にとどまらず幅広い場面で関係します。

• 国境をまたぐ新規登録:ユーザーが海外で母国の番号を使って登録する場合、国の判定ロジックがそれを弾いてはいけません。
• メッセージング中心のサポート:チャットアプリは企業への連絡手段の中心なので、チームはこの方法でWhatsAppやTelegramのビジネス設定を検証します。
• 南米での地域展開:リリースチェックリストに、現実的な+58の経路を1本入れておく必要があります。
• 代理店:ベネズエラのブランドのSNSアカウントを運用し、コードを担当者個人の電話ではなく共有ツールに届けたい場合は、代理店とリセラーをご覧ください。

OTP Gatewayはベネズエラでどのサービスに対応していますか?

ベネズエラの番号では1,700以上のサービスを利用できます。リクエストの多いものとして、WhatsApp、Telegram、Google(GmailとYouTube)、Facebook、Instagram、TikTok、X(Twitter)、ChatGPT(OpenAI)、Claude、MicrosoftとOutlook、Amazon、Discord、LinkedInなどがあります。これはあくまで変動するスナップショットとしてご覧ください。サービスと国ごとの対応状況は一日を通して再計算されており、常にAPIがリアルタイムの情報を返します。

テストランナーからベネズエラのOTP APIを呼び出すにはどうしますか?

すべてのリクエストはhttps://otproute.com/api/v1に対して、or_live_プレフィックスのBearerキーを付けて送信します。キーは開発者コンソールで環境ごとに1つ作成してください(上限は10キーです)。ベネズエラの国IDはveです。

1. 実行ごとに一度、GET /api/v1/servicesとGET /api/v1/countriesで、人間が読める名前をIDに対応付けます。
2. 注文の直前にGET /api/v1/prices?country=ve&service=<id>を呼び、現在の価格とその組み合わせが提供されているかをテストに把握させます。
3. POST /api/v1/activationsで注文します。ボディの例は{"service": "whatsapp", "country": "ve"}です。
4. 返された+58の番号を、テスト対象の画面に入力します。
5. Webhookでactivation.sms_receivedを受け取るか、GET /api/v1/activations/{id}をポーリングします。フローが途中で中断した場合は、後片付けとしてPOST /api/v1/activations/{id}/cancelを使います。

スイートの開始時にGET /api/v1/balanceで残高を確認してください。Webhookでは、エンドポイントのシークレットを使って<t>.<raw body>のHMAC-SHA256を計算し、X-OTPRoute-Signature(t=<unix>,v1=<hex>)を検証し、古いタイムスタンプは拒否します。アカウントでは、Webhookエンドポイントは5つ、リクエストは毎分300回まで利用できます。パイプラインのパターンは、CIパイプラインでのSMS OTPテストとAPIドキュメントにあります。

手動での注文方法と、コードが届かない場合の対処

ダッシュボードでの手順は簡単です。ベネズエラを選び、サービスを選び、価格を確認し、アプリで番号を使い、画面にコードが表示されるのを待ちます。コードを書かずにさっと確認したいプロダクトマネージャーやサポートリーダーに向いています。

すべてのアクティベーションには20分の有効時間があります。その時間内にSMSが届かない場合、またはキャンセルした場合は、全額が自動的にウォレットへ返金され、課金されるのは受信できたコードのみです。到着までの時間はサービスと経路によって異なります。コードが遅れている場合は、有効時間が終わるまで待ってから、後で再試行するか別のサービス経路に切り替えてください。立て続けに再注文を繰り返すのは避けましょう。また、その操作でサービス側が仮想番号を拒否していないかも確認してください。拒否するサービスもあります。各サービスの利用規約を守ってください。OTP Routeの利用規定(Acceptable Use Policy)も全体に適用されます。

+58の番号を保持することはできますか?ウォレットへのチャージ方法は?

セルフサービスではできません。月額$1.95からの専用バーチャル番号は、米国とカナダに限り即時購入できます(バーチャル番号を参照)。ベネズエラの回線を長期的に維持したいチームは、[email protected]にメールでお問い合わせください。可否は現地の規則によって決まります。

支払いは、プリペイド式のUSDウォレット1つによる従量課金で、プランや月額料金はありません。カードまたはUSDT/USDCで入金でき、入金のたびにPDFの請求書がメールで届きます。ご依頼いただければ、開発用アカウントをサンドボックスに切り替えられます。サンドボックスでは、エンドツーエンドの連携テスト用に、模擬の番号とコードが返されます。費用は料金ページで比較できます。

よくある質問

ベネズエラのSIMカードなしで、ベネズエラの新規登録フローをテストできますか?

はい。OTP Gatewayで+58の番号を注文してアプリに入力すると、コードがダッシュボードに表示されるか、Webhookに届きます。

OTP RouteのAPIで、ベネズエラのIDは何ですか?

veです。GET /api/v1/pricesや、アクティベーション作成時のcountryの値として使います。

ベネズエラの携帯番号を保存するとき、先頭の0は残すべきですか?

いいえ。国内用のトランク0は取り除き、+58に続けて残りの桁を保存します。例えば+58414の後に7桁が続く形です。

ベネズエラの認証番号はいくらですか?

$0.20/コードからです。正確な価格はサービスごとにAPIとダッシュボードで注文前に表示されます。未使用のアクティベーションは返金されます。

ベネズエラのコードが英語で届いたのはなぜですか?

言語は送信元のサービスが決めており、通常はアカウントや端末のロケールに基づきます。メッセージの文言ではなく、数字を解析するようにしてください。

ベネズエラ向けの専用の長期番号はありますか?

セルフサービスの選択肢はありません。専用回線は米国とカナダ向けの商品です。ベネズエラについては[email protected]にメールでご相談いただけます。

OTP Routeはプラットフォームの制限を回避するために使えますか?

いいえ。テストのほか、各サービスの規約に沿って、本物の個人または事業者1つにつきアカウント1つという形で、ご自身の正当なプロダクトとアカウントを運用するためのものです。

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