現地SIMなしでブルンジの電話番号認証をテストする方法

海外から+257のサインアップフローを確認するのが難しいのはなぜですか?

東アフリカ展開にブルンジを加えるプロダクトチームを想像してください。登録画面は電話番号を求め、バックエンドがワンタイムコードを送信しますが、チームの誰もブルンジのSIMを持っていません。出張先で買ったローミングSIMはいずれ期限切れになります。ブジュンブラの同僚にコードを読み上げてもらう方法では、個人の番号を晒すことになり、夜間に回すテストスイートにも組み込めません。

OTPルーティングなら、このボトルネックを解消できます。物理的な端末の代わりに、特定のサービス向けのブルンジ認証番号を依頼すると、コードはOTP Routeが受け取り、テストハーネスは他のイベントと同じようにそれを読み取ります。ブルンジのルートでビジネスプロフィールを管理していて、自分の携帯を関与させたくない運用担当者にも、同じ方法が使えます。

現在、ブルンジの番号で認証できるサービスは?

ブルンジのライブスナップショットには、おなじみのメッセージング、検索、コマース系アプリが並んでいます。WhatsApp、Viber、imo、Telegram、Signal、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、LinkedIn、Microsoft & Outlook、ChatGPT (OpenAI)、Uber、Amazonなどです。このルート全体では1,000を超えるサービスに対応しています。

在庫は一日の中で変動するため、この一覧は約束ではなく出発点として捉えてください。最新の状況はコードから GET /api/v1/services と GET /api/v1/countries で確認でき、全体のディレクトリは国一覧から閲覧できます。

ブルンジのOTP APIは、テスト実行にどう組み込めますか?

開発者コンソールでキーを作成します。本番キーは or_live_ で始まり、https://otproute.com/api/v1 に対してBearerヘッダーで送信します。自動チェックの典型的な流れは次のとおりです。

1. GET /api/v1/prices?country=bi&service=whatsapp を呼び、その組み合わせの現在価格を取得します。
2. ボディ {"service": "whatsapp", "country": "bi"} を付けて POST /api/v1/activations を送ります。レスポンスには、アクティベーションIDと、テスト対象のアプリに入力する+257番号が含まれます。
3. activation.sms_received のWebhookを待つか、適切な間隔で GET /api/v1/activations/{id} をポーリングします。
4. コードを検証してテストを終了します。

Webhookリクエストには X-OTPRoute-Signature: t=<unix>,v1=<hex> が含まれます。これはエンドポイントのシークレットを鍵にした、<t>.<raw body> のHMAC-SHA256です。自分で再計算し、定数時間で比較し、古いタイムスタンプのものは破棄してください。詳細はこちらの解説にまとめています。1アカウントで保持できるのは最大10個のキーと5つのWebhookエンドポイントで、上限は毎分300リクエストです。完全なリファレンスはドキュメントをご覧ください。

ブルンジの番号に対して、バリデーターは何を想定すべきですか?

ブルンジはクローズド・ナンバリング・プランを採用しており、国番号の後ろの加入者番号は8桁で、取り除くべき国内トランクプレフィックスはありません。E.164形式では、+257 に8桁を続け、スペースなしで保存します。フォームでは2桁ずつ区切って表示されることが多いので、保存前に入力からスペース、ハイフン、先頭の 00 を取り除いて正規化してください。

よくあるバグは、9桁や10桁の国内番号を前提に書かれたバリデーターが、有効な+257の入力を黙って弾いてしまうことです。単体テストに、この桁数のフィクスチャを加えておきましょう。

公用語はキルンジ語、フランス語、英語で、商取引ではスワヒリ語も広く使われています。グローバルアプリの認証SMSは、送信元自身のロケール判定に応じて、英語かフランス語で届くのが一般的です。文面の一致に頼らず、数字を解析してコードを取り出してください。

コードが届かないときは、どうすればよいですか?

各アクティベーションは20分間開いたままです。その間にSMSが番号に届かなかった場合、または POST /api/v1/activations/{id}/cancel でキャンセルした場合は、全額が自動的にウォレットへ戻ります。

• 失敗と判断する前に、ウィンドウを最後まで待ちましょう。メッセージをキューに溜める送信元もあります。
• 対象のサービスが仮想番号を受け付けるかどうかを確認します。ポリシーとして拒否するサービスもあります。
• 時間をおいて再試行するか、別のサービスルートで同じフローを試してください。
• 短い間隔での再注文は避け、試行の間にバックオフを入れましょう。

ダッシュボードを使いたい場合は、サインインしてブルンジとサービスを選び、番号をアプリにコピーして、画面にコードが表示されるのを待ちます。ほかの対処法はOTP配信失敗を減らす方法で紹介しています。

繰り返しログインするアカウント用に、ブルンジの回線を保持できますか?

セルフサービスの商品としては提供していません。OTP Routeでは長期利用のブルンジ番号は販売しておらず、OTP Gatewayは認証1回につき1つの番号を発行します。そこで恒常的な回線が本当に必要な場合は、[email protected] までメールで用途をお知らせください。提供できるかどうかは現地の規制次第で、お約束はできません。

Dedicated Virtual Numbersは米国とカナダのみの提供で、月額$1.95/monthからです。SMS受信、Webhook転送、ブラウザ通話に対応しています。米国またはカナダの回線がステージングアカウントに合うなら、仮想番号をご覧ください。

ブルンジでの利用料金は、どのように課金されますか?

前払い制のUSDウォレットが1つあるだけで、月額料金も選ぶべきプランもありません。入金はカードまたはUSDT/USDCのステーブルコインで行え、経理にはチャージのたびにPDFの請求書がメールで届きます。決済をCIに組み込む前に、開発用アカウントをサンドボックスに切り替えるよう依頼してください。サンドボックスでは、ウォレットの資金に触れずに、シミュレートされた番号とコードが返ります。

番号は自社プロダクトまたは正当な業務用アカウントのためにのみ使用し、各サービスの規約を守ってください。OTP Routeの利用規定(Acceptable Use Policy)も適用されます。最新の料金は料金ページに掲載しています。

よくある質問

現地のSIMなしで、アプリのブルンジ向けサインアップフローをテストできますか?

はい。OTP Gatewayで対象サービス用の+257番号を注文し、アプリに入力して、ダッシュボード、API、またはWebhookでコードを読み取ります。

APIでは、ブルンジの国IDは何を使いますか?

country の値として bi を渡します。たとえば POST /api/v1/activations で、telegram などのサービスIDと一緒に指定します。

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

いいえ。20分のウィンドウ内に何も届かなかった場合、またはキャンセルした場合は、全額が自動的にウォレットへ返金されます。

ブルンジの番号には、取り除くべき先頭のゼロがありますか?

いいえ。ブルンジにはトランクプレフィックスがないため、E.164形式は +257 に8桁を続けたものになります。

ブルンジの認証SMSは、何語で届きますか?

送信元のサービスによりますが、英語かフランス語が一般的です。メッセージ本文に頼らず、数字のコードを抽出してください。

同じブルンジの番号を、来月も再利用できますか?

いいえ。Gatewayの番号は1回の認証専用です。繰り返しログインする用途には、米国とカナダに限りDedicated Numberをご利用いただけます。

ブルンジの認証番号の料金はいくらですか?

ブルンジの料金は1コード$0.20 からで、正確な金額はサービスごとに決まります。GET /api/v1/prices で取得でき、注文前にも表示されます。

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