エクアドル(+593)の認証コードをテストランに取り込む

エクアドルのサインアップフローが、電話待ちで止まってしまうのはなぜですか?

よくあるパターンです。プロダクトチームがローンチ予定の国にエクアドルを加えると、登録画面が+593の携帯番号を求めますが、QA側の誰もその番号を持っていません。誰かがプリペイドSIMを注文し、それは別の街の引き出しにしまわれたまま、リグレッションテストのたびに、同僚がチャットでコードを読み上げることに頼る状態になります。

この方式は、テストが夜間や並列で走った時点で破綻します。また、コードが本来届くべきでない場所に漏れてしまいます。OTP Routeは、引き出しのSIMをAPIによるOTPルーティングに置き換えます。テストがエクアドルの番号を要求し、認証SMSはこちら側で受信され、コードは要求したジョブに返されます。起きている人は必要なく、誰の個人の携帯電話も関与しません。

エクアドルの認証用番号には、どのアプリがコードを送れますか?

エクアドルのルートは現在、1,700を超えるサービスに対応しています。最新のスナップショットで人気のあるものは、WhatsApp、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、X (Twitter)、LinkedIn、Microsoft & Outlook、Uber、Airbnb、Netflix、Discord、ChatGPT (OpenAI)です。

在庫はキャリアパートナーからリアルタイムで供給されるため、このリストは日中に動きます。約束ではなく目安として捉えてください。ある瞬間の確かな答えは、お使いのサービスとecの国IDに対してGET /api/v1/pricesが返す内容です。カタログ全体はサービスのページで閲覧できます。

エクアドルOTP APIの流れは、コードではどうなりますか?

すべてはhttps://otproute.com/api/v1の下にあり、Developerコンソールで生成したor_live_で始まるBearerキーで認証します。典型的なテストステップは次のように進みます。

1. GET /api/v1/prices?country=ec&service=<id>で、価格とリアルタイムの提供状況を確認します。
2. {"service": "uber", "country": "ec"}のようなボディでPOST /api/v1/activationsを呼び、注文を作成します。アクティベーションIDと+593の番号が返ります。
3. その番号を自社アプリの登録フォームに入力し、SMSを発生させます。
4. エクアドル向けのジョブはactivation.sms_receivedイベントでブロックして待ち、代わりに数秒おきのGET /api/v1/activations/{id}で補います。
5. テストが途中でクラッシュしたときは、POST /api/v1/activations/{id}/cancelで+593の注文を解放します。

Webhookの配信にはX-OTPRoute-Signatureヘッダーが付きます。エンドポイントのシークレットを使って、タイムスタンプ、ドット、生のボディに対するHMAC-SHA256を再計算し、定数時間で比較し、古いタイムスタンプは拒否してください。連携ガイドでは、SMS認証APIのクライアント全体を解説しており、ドキュメントにはすべてのフィールドが載っています。

データベースでは+593の携帯番号をどう保存すべきですか?

エクアドルの人々は通常、携帯番号を先頭の0付きで書きます。たとえば09に8桁が続く形です。このゼロは国内ダイヤル専用のトランクプレフィックスです。E.164形式では消え、+593と、9で始まる9桁の国内番号が残ります。

• 標準形式として+5939XXXXXXXXを1つだけ保存します。入力時にスペース、ハイフン、トランクのゼロを取り除きます。
• 現地の人はどちらの形式でも入力するため、フォームでは09…と+593 9…の両方を受け付けます。
• メッセージテンプレートが英語だと決めつけないでください。エクアドルの公用語はスペイン語なので、コードのほとんどはスペイン語の文面で届きます。「code」のような単語ではなく、数字を抽出してください。

課金テストにとって小さな利点があります。エクアドルは通貨に米ドルを使っているため、OTP Routeでチャージするドルのウォレットと一致します。

エクアドルでコードが届きませんでした。どうすればよいですか?

番号が沈黙している場合、たいていはテストハーネスのバグではなく、ルートかサービス側の受け入れの問題です。次の順番で確認してください。

• 20分の有効時間が終わるまで待ちます。何も届かなければ全額が自動的にウォレットに戻るため、早めにキャンセルする理由はありません。
• エクアドル向けのサービスが、そもそも仮想番号を許容しているかを調べます。ポリシー上拒否するサービスもあり、だからこそ返金ルールがあります。
• 時間をおいて再試行するか、同じサービスで新しいアクティベーションを注文して、別の番号を使います。
• 短い間隔での再注文は避けます。短いバックオフを入れると、ウォレットとルートの両方を守れます。

CIでエクアドルのSMS OTPコードを確実に受信したい場合は、バックオフをハーネス自体に組み込んでください。OTP配信失敗を減らす方法の記事には、再試行ロジックのパターンがさらに載っています。

再度ログインするアカウント用に、エクアドルの番号を保持できますか?

セルフサービスの製品としては提供していません。長期の専用番号(Dedicated Numbers)は米国とカナダのみで販売しており、1か月$1.95から、SMSの受信、Webhookへの転送、SMSの送信、ブラウザからの通話に対応しています。エクアドルには、現在セルフサービスの長期回線はありません。ユースケース上どうしても必要な場合は、[email protected]に内容を添えてメールしてください。提供の可否は現地の規制によるため、お約束はできません。

エクアドルのコードの料金はどう請求されますか?先に無料でテストできますか?

OTP Routeは、月額料金もプラン選択もない、前払いのUSDウォレット1つで運用されます。クレジットカード、またはUSDT/USDCでチャージでき、チャージごとにPDFの請求書がメールで届きます。各アクティベーションは、コードが届いたときにのみ、その残高から引き落とされます。

お金をかける前に、開発用アカウントのサンドボックスモードを依頼してください。シミュレーションされた番号とコードが返されるため、CIジョブ、Webhookの検証処理、パーサーをエンドツーエンドで試せます。これをパイプラインに組み込むチームは、QAテストの概要から始めることが多いです。いつものとおり、各サービスの利用規約と当社の利用規定(Acceptable Use Policy)に従ってください。

よくある質問

現地のSIMがなくても、自社アプリのエクアドル向けサインアップフローをテストできますか?

はい。ecの国IDでアクティベーションを注文し、+593番号をアプリに入力して、コードをダッシュボード、Webhook、またはポーリング呼び出しで読み取ります。

エクアドルの認証コードはいくらですか?

料金は1コード$0.20からです。正確な金額はサービスによって異なり、注文前にダッシュボードに表示されるか、価格エンドポイントから返されます。

+593番号がSMSを受信しなかった場合も支払いますか?

いいえ。メッセージが届かないまま20分の有効時間が終わった場合、またはその前にキャンセルした場合は、全額がウォレットに戻ります。

エクアドルの番号を入力するとき、先頭のゼロを付けるべきですか?

フォームが国内形式を想定している場合のみです。国際形式ではトランクのゼロが外れるため、番号は+593に、9で始まる9桁が続く形になります。

エクアドルのOTPメッセージは何語で届きますか?

主にスペイン語ですが、英語で送るグローバルアプリもあります。周囲の言葉に頼らず、数字のコードを解析してください。

数か月保持できるテスト用の+593番号はありますか?

エクアドルにセルフサービスの選択肢はありません。長期の回線は米国とカナダ向けの製品です。特別なケースについては、[email protected]にメールでお問い合わせいただけます。

APIではなくブラウザからエクアドルの番号を注文できますか?

はい。サインインしてOTP Gatewayでサービスとエクアドルを選び、表示された価格を確認すると、コードが届いた時点で同じ画面に表示されます。

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