QA・ローンチ・OTPルーティングのためのコロンビア認証番号

コロンビアのSMS OTPコードを受信するための4つのAPI呼び出し

コロンビアOTP APIの連携に必要なリクエストはほんの数個です。まずGET /api/v1/prices?country=co&service=whatsappでルートが開いているかを確認します。サービスIDはテストするものに置き換えてください。レスポンスには、その組み合わせのライブ価格が含まれます。次に、POST /api/v1/activationsを、サービスと国としてcoを指定したJSON本文付きで送り、注文を作成します。返ってくるアクティベーションIDと+57番号を、テスト対象のアプリに入力します。

続いてメッセージを待ちます。多くのチームはWebhookエンドポイントを登録してactivation.sms_receivedを待ち受けますが、GET /api/v1/activations/{id}を緩やかな間隔で呼び出す方法もあります。最後に後片付けです。テストの方針が変わった場合は、POST /api/v1/activations/{id}/cancelで確保していた金額を解放できます。各リクエストの詳細は開発者向けドキュメントに記載されています。

現在、コロンビアのどのアプリがルートに対応していますか?

コロンビア向けのOTPルーティングは、最新のスナップショットで1,900を超えるサービスに対応しています。よくリクエストされるものには、WhatsApp、Telegram、Google (Gmail & YouTube)、Instagram、Facebook、TikTok、Uber、Microsoft & Outlook、Amazon、Discord、LinkedIn、Signal、Netflixなどがあります。対応状況は日中でも変動するため、定期実行のテストでは、固定のリストを信じるのではなく、GET /api/v1/servicesと料金エンドポイントに、今まさに利用可能なものを問い合わせるようにしてください。

E.164形式で保存するための+57携帯番号のフォーマット

コロンビアの携帯番号は、国番号の後に10桁が続き、先頭は3で始まります。E.164形式では+57 3XX XXX XXXXの形になります。国内では先頭の0を付けずにダイヤルするため、正規化は単純です。スペース、ダッシュ、かっこを取り除き、プラス記号と57を残して、正規の文字列を1つだけ保存します。先頭が3かどうかをクライアント側でチェックしておけば、固定電話の番号を貼り付けてしまったテスターにも、SMSの段階で原因不明の失敗になるのではなく、わかりやすいメッセージを見せられます。

QAチームがコロンビア市場に注目する理由は何ですか?

コロンビアはスペイン語圏で最大級の市場の一つで、ラテンアメリカ向けのローンチの多くがこの国か周辺国から始まります。認証メッセージは通常スペイン語で届くため、ローカライズの確認では、自社のテンプレートが自然に読めるか、アクセント記号付きの文字がエンコーディングで失われないか、長い文の中でも数字が見つけやすいかを確かめてください。配車、デリバリー、決済、マーケットプレイスなどのプロダクトはいずれもこの地域で電話番号の確認に依存しているため、テスト用の+57番号はリリースのチェックリストに繰り返し登場します。QAテストのページには、どのSMS認証APIでも使えるパターンをまとめています。

+57のコードが遅れています。どうすればよいですか?

各アクティベーションは20分間有効です。SMSが届かないままウィンドウが閉じた場合や、先にキャンセルした場合は、全額が自動的にウォレットに戻り、エンドポイントにはactivation.expiredまたはactivation.cancelledが届きます。再試行する前に、次の点を確認してください。

• テスト対象のアプリが仮想番号を受け付けるか確認する
• 新しい注文を積み重ねず、現在のウィンドウが終わるまで待つ
• 短い間隔で連続注文せず、再試行の間隔を空ける
• 時間をずらすか、同じサービスで別のルートを試す

それぞれの手順の考え方は、OTP配信失敗を減らす方法の記事で解説しています。

コロンビアの回線を数か月間保持できますか?

セルフサービスではできません。インバウンド・アウトバウンドのSMSとブラウザ通話が使えるDedicated Virtual Numbersは、アメリカとカナダ限定で、月額$1.95からです。ダッシュボードから長期の+57回線を購入することはできません。運用上必要な場合は、[email protected]までご連絡ください。手配できるかどうかは現地の規制によるため、事前にお約束することはできません。

コロンビア向け認証の支払い方法

OTP Routeは前払いのUSDウォレットで運営されており、月額料金もプランの選択もありません。チャージはカード、またはUSDT/USDCのステーブルコインで行え、チャージのたびに経理向けのPDF請求書がメールで届きます。コロンビアのルートは1コード$0.20 からで、サービスによって異なり、確定前に正確な金額が表示されます。連携作業中は、サポートに依頼して開発用アカウントをサンドボックスに切り替えられます。シミュレートされた番号とコードで、ウォレットの資金に触れずにフロー全体を試せます。最新の料金は料金ページにあります。

よくある質問

現地のSIMなしで、アプリのコロンビア向け登録フローをテストできますか?

はい。確認したいサービス用の+57番号を注文し、登録フォームに入力して、ダッシュボードまたはWebhookでコードを読み取ります。物理的な発送や有効化は一切不要です。

ダッシュボードからコロンビアの認証番号を注文するには?

サインインしてOTP Gatewayを開き、サービスとコロンビアを選んで価格を確認し、確定します。番号が画面に表示され、SMSが届くとその横にコードが表示されます。

APIでコロンビアに使う国IDは何ですか?

countryフィールドと価格の照会にはcoを使います。サービスIDはGET /api/v1/servicesから取得でき、たとえばtelegramやuberなどです。

コードが一度も届かなかった+57番号にも料金を払うのですか?

いいえ。SMSが届かないまま20分のウィンドウが終わった場合や、キャンセルした場合は、全額が自動的にウォレットに戻ります。

コロンビアの認証SMSは何語で届きますか?

送信元によって異なりますが、コロンビアのユーザーにはスペイン語のテンプレートが多く届きます。テンプレートは予告なく変わるため、決まった文言に一致させるのではなく、数字を抽出してください。

CIパイプラインだけでコロンビアのSMS OTPコードを受信できますか?

はい。パイプラインからアクティベーションを作成し、Webhookを待つか、アクティベーションをポーリングして、コードをテストに渡します。タイムアウトと後片付けについては、CIでのOTPテストの記事で解説しています。

Webhookが本当にOTP Routeから送られたものだと、どう確認できますか?

各リクエストにはX-OTPRoute-Signatureが付いており、タイムスタンプと、そのタイムスタンプ、ドット、生の本文をエンドポイントのシークレットでHMAC-SHA256にかけた値が含まれています。これを再計算し、定数時間で比較して、古いタイムスタンプは破棄してください。

+57番号で認証してよいものに制限はありますか?

はい。番号は自社のプロダクトと正当な事業用アカウントにのみ使い、各サービスの利用規約を守ってください。また、OTP Routeの利用規定(Acceptable Use Policy)はすべての注文に適用されます。

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