API呼び出しでボツワナのSMSコードを受信する

ボツワナのアクティベーションはどのAPI呼び出しを通る?

すべては https://otproute.com/api/v1 配下にあり、or_live_ で始まるBearerキーで認証されます。キーはDeveloperコンソールで作成します。1アカウントに最大10個持て、上限は毎分300リクエストです。1回の実行でボツワナの番号を数個注文するテストスイートには、十分すぎるほどです。

典型的な流れは次のとおりです。

1. GET /api/v1/countries を一度呼び出してキャッシュし、bw がボツワナの識別子であることをコードに把握させます。
2. GET /api/v1/prices?country=bw&service=whatsapp で、必要な組み合わせのリアルタイムの価格と空き状況を問い合わせます。価格はサービスと国によって異なるため、ハードコードせず読み取ってください。
3. POST /api/v1/activations に、ボディ {"service": "whatsapp", "country": "bw"} を送ります。レスポンスには、+267番号とアクティベーションIDが含まれます。
4. その番号をテスト対象の登録フォームに入力し、GET /api/v1/activations/{id} をポーリングするか、Webhookを待ちます。
5. テストが中止された場合は、POST /api/v1/activations/{id}/cancel を呼び出し、資金をすぐにウォレットへ戻します。

同じ呼び出しをエラー処理を意識して順に解説したものが、OTP API連携ガイドです。

Webhook受信側は+267のイベントをどう扱うべき?

複数のテストを並列に実行するようになったら、Webhookのほうがすっきりします。エンドポイントを登録し(1アカウントにつき5つ)、activation.sms_received、activation.expired、activation.cancelled を待ち受けます。いずれも、注文時に得たアクティベーションIDで管理されます。

すべての配信には、t=<unix>,v1=<hex> 形式の X-OTPRoute-Signature ヘッダーが付いています。エンドポイントのシークレットで文字列 "<t>.<raw body>" のHMAC-SHA256を再構築し、v1 と定数時間で比較し、タイムスタンプが古いものは破棄してください。チェックを通過した後にのみJSONを解析してください。本文を再シリアライズするとバイト列が変わってしまうからです。

ハンドラーは冪等にしてください。コードが消費されたらアクティベーションIDを保存し、同じイベントの繰り返しは無視します。詳細はHMACでOTP Webhookを保護するにあります。

ボツワナの認証用番号は何に使える?

ボツワナの現在のスナップショットには、800を超えるサービスが掲載されています。人気のものには、WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、ChatGPT (OpenAI)、Microsoft & Outlook、Amazon、LinkedIn、Uber、Signal、Netflix、Airbnbがあります。

特定のルートの空き状況は、キャリアの容量の変化に伴って日中に変動します。価格エンドポイントが、今注文できるものも報告するのはそのためです。この一覧ではなく、その答えを正しい情報源として扱ってください。

エンジニアがボツワナの電話番号について知っておくべきことは?

ボツワナの国番号は+267で、トランクプレフィックスはないため、国内番号は書いたとおりにダイヤルされます。携帯番号は8桁で、7から始まります。E.164では、+267 に8桁が続く形になり、取り除くべき0はありません。

これらの番号を保存または検証する人のための、実用的なポイントをいくつか挙げます。

• 入力時にすべてE.164へ正規化します。ユーザーは 00267、スペース、先頭のプラス記号を入力することがあります。比較や重複排除の前に、すべてをひとつの正規形に揃えてください。
• 隣接する市場のトランクプレフィックスのルールを流用しないでください。先頭のゼロを取り除く国からコピーしたバリデーターは、ボツワナの有効な入力を拒否します。
• 主要言語は英語とツワナ語です。グローバルなアプリのコードは通常英語で届きますが、パーサーは固定の文言に頼らず、パターンで数字を抽出してください。

この市場をテストするのは、南部アフリカでプロダクトを公開するとき、南アフリカの国境を挟んだ向こう側にいる顧客のオンボーディングを確認するとき、あるいはテスト用に現地の+267番号が必要な地域運用を行うときです。

非開発者はダッシュボードからボツワナのコードを注文できる?

はい。メールアドレスと6桁のコード(またはGoogle)でサインアップし、ウォレットにチャージしたら、OTP Gatewayを開いてボツワナとサービスを選び、表示された価格を確認して注文します。番号をテスト対象のアプリに貼り付けると、SMSがルートに届き次第、ダッシュボードにコードが表示されます。

各アクティベーションは20分間有効です。その間にメッセージが届かない場合、またはその前にキャンセルした場合は、全額が自動的にウォレットへ戻ります。

ボツワナのコードが届かない場合は?

配信速度はサービスとルートによって異なるため、対処する前に有効時間の余裕を見てください。何も届かないまま終了した場合は、次のリストを順に確認してください。

• 少し時間を置いて再試行するか、プロダクトが対応していれば同じフローで別のサービスルートを選びます。
• 相手側のアプリが仮想回線にSMSを送るかを確認します。そうした番号を断るアプリも一部にあり、だからこそ未使用のアクティベーションは残高に戻ります。
• 1分後にキャンセルせず、20分の有効時間を最後まで待ちます。
• CIから短い間隔のループで再注文するのは避け、試行の間にバックオフを入れます。

その他のパターンは、OTP配信失敗を減らすにあります。何をテストする場合も、各サービスの利用規約を守ってください。OTP Routeの利用規定(Acceptable Use Policy)はすべての注文に適用されます。

+267の長期回線はある?課金の仕組みは?

セルフサービスの製品としてはありません。専用番号(Dedicated Numbers)がすぐに購入できるのは米国とカナダのみで、月額$1.95からです。ボツワナについては [email protected] にメールで問い合わせられ、提供の可否は現地の規制によります。米国とカナダの回線に含まれる内容は、仮想番号をご覧ください。

課金は、月額料金のない前払い式のUSDウォレット1つで、カードまたはUSDT/USDCでチャージでき、チャージごとにPDFの請求書がメールで届きます。連携の作業では、リクエストにより開発アカウントをサンドボックスに切り替えられ、フロー全体をシミュレートされた番号とコードで実行できます。現在の料金は料金ページにあります。

よくある質問

OTP Route APIでのボツワナの国IDは何ですか?

bw です。POST /api/v1/activations の country と、GET /api/v1/prices のクエリ文字列に指定します。

現地SIMなしで、自社アプリのボツワナ向け登録フローをテストできますか?

はい。OTP Gatewayで自社アプリのサービス用に+267番号を注文し、ダッシュボードまたはWebhookでコードを読み取ってください。SIMカードも端末も必要ありません。

ボツワナの番号は、保存時に先頭のゼロが必要ですか?

いいえ。ボツワナにトランクプレフィックスはないため、番号は +267 に8桁の携帯番号を続けた形で保存してください。

+267のコードが届かなかった場合も課金されますか?

いいえ。20分の有効時間内に何も届かない場合、またはキャンセルした場合は、全額が自動的にウォレットへ戻ります。

将来のログイン用に、ボツワナの番号を保持できますか?

ボツワナにはセルフサービスの長期番号はありません。長期回線は米国とカナダ向けの製品です。他の選択肢について尋ねたい場合は、[email protected] にメールしてください。

ウォレット資金を使わずに、CIでボツワナのテストを実行できますか?

開発アカウントをサンドボックスに切り替えるよう依頼してください。シミュレートされた番号とコードが返るので、APIとWebhookの経路全体を無料で試せます。

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