ボリビア(+591)SMS認証の事前チェックリスト

+591番号を注文する前に、チェックリストに入れるべきことは?

ボリビアのテスト実行が失敗する原因の多くは、ルートそのものではなく、設定していなかった何かにあります。まず次の項目を確認してください。

• APIキー:Developerコンソールで作成した or_live_ 接頭辞のキーを、CIまたはアプリの設定にシークレットとして保存します。環境ごとにキーを1つ用意すると、ログが読みやすくなります。
• Webhookエンドポイント:HTTPSで素早く応答し、署名シークレットが読み込まれているもの。ポーリングでも動作しますが、テスト環境でどちらを使うかを決めておきましょう。
• ウォレットの資金:実行に必要な分。配線の動作確認だけなら、サンドボックスアカウントでも構いません。
• サービスID:テスト対象アプリのIDは GET /api/v1/services から取得し、ボリビアの国IDは bo です。
• 電話番号パーサー:+591 の入力を受け付けるもの。受信した番号をサインアップフォームに実際に入力できるようにするためです。

足りない項目が1つでもあれば、アクティベーションを1回でも使う前に解消してください。

現在、ボリビア経由でルーティングできるアプリは?

ボリビアの最新リストには、1,700を超えるサービスが載っています。チームからのリクエストが特に多いのは WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、Uber、Microsoft & Outlook、Discord、LinkedIn、Viber、Signal、AliExpress です。

ボリビアのような市場では、この幅広さが重要です。コンシューマー向けアプリはメッセージングアプリのログインに頼ることが多く、配達や配車のプロダクトは独自の電話番号確認を必要とするからです。上のリストはスナップショットとして扱ってください。サービスごとの提供状況は日中に変わるため、静的なページではなく、料金エンドポイントが最新の状況を返すようになっています。

ボリビアのOTP APIフローを、ステップごとに実行するには?

すべての呼び出しは、Bearerキーを付けて https://otproute.com/api/v1 に送ります。アカウントの上限は1分間300リクエストです。

1. GET /api/v1/prices?country=bo&service=<id> で、最新の料金と提供状況を取得します。ルートが現在空の場合は、注文を見送ってください。
2. アクティベーションを作成します。POST /api/v1/activations に {"service": "<id>", "country": "bo"} を送ります。返されたアクティベーションIDと番号を保存します。
3. その番号を、テスト対象アプリのサインアップまたはログイン画面に入力します。
4. activation.sms_received Webhookを待つか、ゆとりのある間隔で GET /api/v1/activations/{id} をポーリングします。
5. テストを中止する場合は POST /api/v1/activations/{id}/cancel を呼び出し、保留分をすぐにウォレットへ戻します。

信頼する前に、すべてのWebhookを検証してください。X-OTPRoute-Signature ヘッダーには t=<unix>,v1=<hex> が入っており、hexはエンドポイントのシークレットによる "<t>.<raw body>" のHMAC-SHA256です。古いタイムスタンプは拒否します。ハンドラの全体像はOTP API連携ガイドで解説しています。

ボリビアの番号はどのように保存・確認すべき?

ボリビアの携帯番号は、国番号 +591 の後に8桁が続き、通常は6または7で始まります。たとえば +591 の後にその8桁を続けるE.164形式で、スペースなしで保存してください。ユーザーが現地のスペース入りや先頭に0を付けて入力したものは、保存前に正規化します。

認証メッセージの大半はスペイン語で届きます。ただしボリビアでは、ケチュア語、アイマラ語、グアラニー語など多くの言語も公用語として認められています。プロダクトが先住民言語のUIを提供している場合は、自社のバックエンドが送るSMSテンプレートが正しく表示されるか確認してください。この経路は、サードパーティのアプリが送るものとは別だからです。

ボリビアを扱う主な理由は、アンデス諸国をまたぐ地域リリース、スペイン語フローのローカライズQA、海外在住中にボリビアの番号で登録した顧客へのサポートです。

コードを書かない人向けのダッシュボードの手順はありますか?

はい。同じチェックリストの考え方に沿っています。運用やサポートの担当者は次のように操作できます。

1. /signup でメールのコードまたはGoogleでサインインし、TOTP二要素認証を有効にします。
2. OTP Gateway を開き、サービス、次にボリビアを選びます。課金が行われる前に、最新の料金が表示されます。
3. 番号をアプリにコピーし、ダッシュボードのタブを開いたままにします。SMSが届くと、コードがそこに表示されます。

連携に触れることなく、本番のログイン画面を一度だけ確認するのに便利です。

ボリビアのコードが表示されない場合、何を確認すべき?

次の順に確認してください。

• 有効時間を待つ。 アクティベーションは20分間開いたままです。早く閉じると、その試行が無駄になります。
• アプリ側のルールを確認する。 仮想番号を一切拒否するサービスもあり、返金はまさにそのケースのために存在します。
• あとで再試行するか、別のルートを試す。 在庫は日中に変動するので、1時間後の2回目の試行では挙動が変わることがあります。
• 短時間にループで再注文しない。 1つのサービスに対する連続した再試行は、状況を悪化させ、ログを散らかしがちです。

有効時間内にSMSが届かなかった場合、全額が自動的にウォレットへ返金されます。さらなるパターンはOTP配信失敗を減らす方法にあります。

ボリビアの長期回線を維持できますか?課金の仕組みは?

セルフサービスで利用できるボリビアの長期番号はありません。OTP Route の専用仮想番号(Dedicated Virtual Numbers)は、アメリカとカナダでのみ販売しており、月額 $1.95 からです。継続して使えるボリビアの回線が必要な場合は [email protected] にメールでご連絡ください。チームが現地の規則で何か可能かをお知らせしますが、保証はありません。

課金は、前払い式のUSDウォレット1つで行われ、月額料金も選ぶプランもありません。カードまたはUSDT/USDCで入金でき、入金ごとにPDFの請求書がメールで届きます。連携作業にはサンドボックスモードを依頼してください。資金を使わずに、シミュレートされた番号とコードが返ります。詳しい料金は /pricing をご覧ください。

よくある質問

現地SIMなしで、自社アプリのボリビアのサインアップフローをテストできますか?

はい。OTP Gateway でサービス用の +591 番号を注文し、アプリに入力して、ダッシュボードまたはAPIでコードを読み取ってください。

OTP Route APIでのボリビアの国IDは何ですか?

料金のクエリとアクティベーションのボディの両方で bo を使用します。

ボリビアのSMSが届かなかった場合、支払いは発生しますか?

いいえ。20分以内に何も届かなかった場合、または先にキャンセルした場合は、金額が自動的にウォレットに戻ります。

ボリビアの認証メッセージは何語で届きますか?

通常はスペイン語ですが、文面は各アプリが決めるため、アカウントや端末の言語に従うこともあります。

QAパイプラインで、この +591 番号を毎晩のテストに使えますか?

各アクティベーションは1回のコード用なので、夜間ジョブでは実行ごとに新しい番号を注文します。パターンについてはCIパイプラインでのSMS OTPテストをご覧ください。

数か月後に再度ログインが必要なアカウントに、ボリビアの番号は向いていますか?

あまり向きません。ワンタイム番号は保持されないからです。長期間使うアカウントには、アメリカまたはカナダの専用番号(Dedicated Number)が適しています。

ボリビアの認証番号で認証できる対象に決まりはありますか?

はい。ご自身のプロダクトと正当な業務用アカウントにのみ使用し、各サービスの利用規約に従ってください。OTP Route の利用規定(Acceptable Use Policy)も適用されます。

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