チームに中央アフリカのSIMがなくても行える、+236サインアップフローのテスト

海外から+236の認証ステップを再現するのが難しいのはなぜですか?

よくある状況は、次のようなものです。プロダクトがフランス語圏の中央アフリカで提供され、バンギのユーザーにワンタイムコードが届かないというバグ報告が上がります。ところが担当エンジニアには、フォームに中央アフリカの番号を入れる手段がありません。ローミングSIMの入手には時間がかかり、現地の同僚は本来の業務で手一杯で、エミュレーターでは本物のキャリアSMSを生成できません。

OTP Routeのようなルーティングサービスなら、このギャップを埋められます。中央アフリカ共和国向けのOTP APIも、ほかの国と同じものです。ハードウェアを送り回す代わりに、API呼び出しで+236の回線を依頼し、自社のサインアップ画面に入力して、コードをプログラムで読み戻します。同じリクエストは、ノートPCのセッションでも、夜間のリグレッションジョブでも、サポートエンジニアのブラウザのタブでも動くため、到達しにくい市場も、テストマトリクスのほかの行と同じように扱えます。

現在、中央アフリカ共和国のSMSコードを受信できるサービスは?

cf のライブスナップショットには、900を超えるサービスが掲載されています。人気のルートには、WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、Viber、imo、Signal、Microsoft & Outlook、LinkedIn、ChatGPT (OpenAI)、Uberなどがあります。

提携キャリアが在庫を入れ替えるため、利用可否は一日の中で変わります。ウェブページ上のどの一覧も、約束ではなく出発点として捉えてください。各実行の前に、GET /api/v1/prices?country=cf&service=<id> で現在の価格と、ルートが開いているかを確認しましょう。カタログ内のアプリには、仮想回線を完全に拒否するものもあります。それはネットワークではなくアプリ側の判断であり、応答のなかった注文が返金されるのは、まさにそのためです。

バックエンドは、テスト用の+236番号をどのように依頼しますか?

すべては https://otproute.com/api/v1 配下にあり、開発者コンソールで発行した or_live_ で始まるBearerキーで認証します。最小限のSMS認証APIのセッションは、次のように進みます。

1. GET /api/v1/services と GET /api/v1/countries で識別子を一度だけ調べます。中央アフリカ共和国は cf です。
2. GET /api/v1/prices で、価格と利用可否を確認します。
3. {"service": "viber", "country": "cf"} のようなボディを付けて POST /api/v1/activations で注文を作成します。
4. 返された+236番号を、テスト対象の画面に入力します。
5. activation.sms_received のWebhookでコードを受け取るか、数秒おきに GET /api/v1/activations/{id} をポーリングします。
6. テストを中断する場合は、POST /api/v1/activations/{id}/cancel で回線を解放します。

Webhookの呼び出しには X-OTPRoute-Signature: t=<unix>,v1=<hex> が付きます。受信側は、そのエンドポイントのシークレットで <t>.<raw body> のHMAC-SHA256を再構成し、定数時間で v1 と照合して、タイムスタンプが古い配信は破棄してください。完全なハンドラーはWebhookによるコード取得ガイドで解説しており、リファレンスはAPIドキュメントにあります。

中央アフリカの電話番号とメッセージの言語について、知っておくべきことは?

中央アフリカ共和国の番号は、トランクプレフィックスのない8桁のクローズド・プランに従うため、国内形式と国際形式の違いは国番号だけです。すべての値をE.164形式で、たとえば +236 に8桁の国内番号を続けて保存し、入力時にスペースやハイフンを取り除いてください。先頭のゼロや10桁を必須とするバリデーションは、実在するユーザーを黙って弾いてしまいます。

公用語はフランス語とサンゴ語です。国際的なアプリの多くは、アカウントのロケールに応じて、フランス語か英語で認証メッセージを送ります。そのため、特定の文面ではなく、数字を探すようにパーサーを作ってください。チームがここでテストを行うのは、西アフリカや中央アフリカへの展開を広げるとき、NGOや現地活動向けのツールを運用するとき、この地域に家族を持つ顧客をサポートするときなどが一般的です。

開発者でなくても、中央アフリカ共和国の認証番号を取得できますか?

はい。プロダクトマネージャー、サポートリード、代理店のスタッフは、すべてブラウザから行えます。

• メールコードまたはGoogleサインインでアカウントを作成し、TOTPの二要素認証を有効にします。
• OTP Gatewayを開き、サービスを選んで、中央アフリカ共和国を選びます。
• 注文する前に表示された最新の価格を確認して、確定します。
• +236番号をアプリに貼り付け、画面にコードが表示されるのを待ちます。

アクティベーションは20分間開いたままです。課金されるのはコードが届いた場合のみで、キャンセルした場合やウィンドウが閉じた場合は、全額がウォレットに戻ります。

+236の回線にコードが届かないときは?

番号が沈黙する原因は、たいてい、アプリがリクエストを制限した、仮想回線を拒否した、ルートが混み合っていた、のいずれかです。落ち着いて順に確認しましょう。

• 失敗と判断する前に、ウィンドウを最後まで待ちます。メッセージをキューに溜める送信元もあります。
• キャンセルして時間をおいてやり直すか、同じサービスに別のルートが用意されていれば切り替えます。
• そのサービスが仮想番号を拒否することで知られていないかを確認します。拒否するなら、再試行しても無駄です。
• 短い間隔での再注文は避けてください。繰り返しの試行は、アプリ側にも当社側にもレート制限を発動させる可能性があります(1アカウントあたり毎分300リクエスト)。

ほかのパターンは、OTP配信失敗を減らす方法にまとめています。

長期利用の+236回線はありますか?利用料金はどう課金されますか?

ありません。セルフサービスのDedicated Numbersは米国とカナダにのみあり、月額$1.95/monthからです。そのため、ダッシュボードで購入できる恒常的な中央アフリカの回線はありません。プロジェクトにどうしても必要な場合は、[email protected] にメールしてください。手配できるかどうかは現地の規制次第で、お約束できるものではありません。

OTP Gatewayの課金は、月額料金のない前払い制のUSDウォレット1つから行われます。入金はカードまたはUSDT/USDCのステーブルコインで行え、チャージのたびにPDFの請求書がメールで届きます。費用をかけずに連携の予行演習をしたい開発者は、サンドボックスモードを依頼できます。シミュレートされた番号とコードが返ります。すべての料金は料金ページに掲載しています。各アプリの規約を守ってください。OTP Routeの利用規定(Acceptable Use Policy)は、すべての注文に適用されます。

よくある質問

現地のSIMなしで、中央アフリカ共和国のSMS OTPコードを受信するには?

OTP Gatewayで+236番号を注文してアプリに入力し、ダッシュボード、Webhook、またはアクティベーションのエンドポイントからコードを読み取れます。

APIでの、中央アフリカ共和国の国IDは何ですか?

cf です。価格のクエリと、アクティベーションのボディで使います。

テスト用の+236番号の料金はいくらですか?

コードは1つ$0.20 からで、正確な金額はサービスによって異なります。+236ルートの現在の金額は、注文前にダッシュボードと価格エンドポイントで確認できます。

認証SMSが届かなかった場合でも、+236の注文は課金されますか?

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

中央アフリカの番号は、先頭のゼロを付けて保存すべきですか?

いいえ。このプランにはトランクプレフィックスがないため、E.164形式の +236 に8桁の国内番号を続けた形で保存してください。

同じ+236番号を、あとのログインのために保持できますか?

セルフサービスではできません。OTP Gatewayの番号はコード1回分で、長期利用の回線は米国とカナダ向けのプロダクトです。ほかの選択肢については、サポートにメールで問い合わせることができます。

お金をかけずに連携をテストする方法はありますか?

はい。依頼に応じて、開発用アカウントをサンドボックスに切り替えられ、番号とコードがエンドツーエンドでシミュレートされます。

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