+237番号でカメルーンのサインアップフローをテスト・運用する

カメルーンがSMS認証で特別なケースになるのはなぜですか?

カメルーンは公式にバイリンガルの国です。フランス語と英語がどちらも公用語で、大半の地域はフランス語圏ですが、北西部と南西部は英語圏です。プロダクトチームにとって、この事実だけでQA作業の多くが決まります。1つの国に2つのインターフェース言語があり、ユーザーがそれらを行き来することもあるからです。

チームがカメルーンの認証番号を使う実務上の理由は、主に次のようなものです。

• 中部アフリカへの展開。 カメルーンは最初の対象市場の1つになることが多く、独自のエンドツーエンドのサインアップテストが必要です。
• フランス語圏・英語圏のローカライズQA。 オンボーディング画面、エラーメッセージ、OTP入力欄が、両方の言語で正しく表示されるかを確認します。
• ディアスポラの顧客。 海外でサインアップしていても、+237番号を主な連絡先として保持している人たちです。
• 現地の運用業務。 担当者が個人の携帯を晒さずに、業務用アカウントを認証する必要がある場合です。

どのケースでも目的は同じです。自社の認証フローが実在するカメルーンの番号を受け付けること、そしてコードが待っている人やシステムに届くことを証明することです。

+237番号はどのように表記・保存・正規化しますか?

カメルーンにはトランクプレフィックスがないため、取り除くべき先頭のゼロはありません。国内番号は9桁で、携帯電話は6で始まります。E.164形式では、+237 に9桁の国内番号を続けた形になり、スペースや記号は入りません。

データをきれいに保つための習慣をいくつか挙げます。

• E.164の文字列を正規の値として保存し、表示用の整形は描画時にだけ行います。
• 数字を2桁や3桁ずつ区切って入力する人が多いので、入力時にスペース、ドット、ハイフンを取り除きます。
• 古いCRMレコードには、国が9桁に移行する前の8桁の番号が残っている場合があります。足りない桁を推測せず、確認対象としてフラグを立ててください。
• 国選択のUIが CM を+237に対応づけており、近隣の国番号に黙ってフォールバックしないことを確認します。

正しい形式の+237番号をバリデーションライブラリが拒否するなら、ローンチ前に見つけるべきバグです。それを最も早く見つけられるのは、実際のテスト用番号です。

カメルーンの認証SMSは、何語で届きますか?

それは番号ではなく、送信元のサービスと、アカウントや端末に設定された言語によって決まります。グローバルアプリは通常、カメルーンのユーザーにフランス語か英語でメッセージを送り、設定にかかわらず英語にフォールバックするものもあります。

コード自体はほとんどの場合、数字です。そのためパーサーは、周囲の文言に一致させるのではなく、数字のコードを抽出するようにしてください。ローカライズをテストするときは、同じサインアップをインターフェースをフランス語にして1回、英語にして1回実行し、そのたびに自社アプリがコード入力欄の周囲に正しい文言を表示することを確認しましょう。

カメルーンのルートでコードを配信できるサービスは?

OTP Gatewayには現在、カメルーン向けに2,000を超えるサービスが掲載されています。ライブスナップショットにある人気のサービスには、WhatsApp、Facebook、imo、Telegram、TikTok、Google (Gmail & YouTube)、Microsoft & Outlook、ChatGPT (OpenAI)、Signal、Viber、LinkedIn、Uber、Amazonなどがあります。

在庫は一日の中で動くので、この一覧は出発点として捉えてください。APIは、サービスと国の組み合わせごとに、最新の利用可否と現在価格を返します。スクリプトがそれをキャッシュせず、実行のたびに問い合わせるべきなのは、そのためです。

テストスイートからカメルーンのOTP APIを呼ぶには?

すべてのリクエストは、or_live_ で始まるBearerキーを付けて https://otproute.com/api/v1 に送ります。開発者コンソールでキーを最大10個作成できるため、ステージング、CI、本番のツールに別々の認証情報を割り当てるのが簡単です。カメルーンの国IDは cm です。

1. GET /api/v1/services と GET /api/v1/countries を読み、IDを解決します。
2. GET /api/v1/prices?country=cm&service=<id> を呼び、現在の価格と、そのルートがいま利用可能かどうかを確認します。
3. {"service": "whatsapp", "country": "cm"} のようなボディを付けて POST /api/v1/activations で注文を作成します。レスポンスには、アクティベーションIDと+237番号が含まれます。
4. その番号を、自社アプリのサインアップ画面またはログイン画面に入力します。
5. Webhookでコードを受け取るか、数秒おきに GET /api/v1/activations/{id} をポーリングします。テストを中断する場合は POST /api/v1/activations/{id}/cancel を呼びます。

Webhookでは、activation.sms_received、activation.expired、activation.cancelled を購読し、X-OTPRoute-Signature ヘッダーを検証します。エンドポイントのシークレットで <t>.<raw body> のHMAC-SHA256を計算して v1 と比較し、古いタイムスタンプは拒否してください。手順はWebhook署名ガイドで解説しており、完全なリファレンスはAPIドキュメントにあります。ウォレットの資金を使わずに組み込みたい場合は、開発用アカウントのサンドボックスモードを依頼してください。シミュレートされた番号とコードが返ります。

開発者でなくても、ダッシュボードから+237のコードを受け取れますか?

はい。サインインしてOTP Gatewayを開き、カメルーンとサービスを選んで、表示された価格を確認し、番号を注文します。認証したいアプリに貼り付けて、コードが表示されるまでアクティベーションのページで待ちます。

アクティベーションは20分間開いたままです。それが閉じるまでにSMSが届かなかった場合や、先にキャンセルした場合は、全額が自動的にウォレットへ戻ります。コードが表示されないときは、次の手順を順番に試してください。

• ウィンドウが終わるまで待ちましょう。送信が遅れるサービスもあります。
• 短い間隔で再注文するのではなく、時間をおいて再注文するか、別のサービスルートを試してください。
• そのサービスが仮想番号を受け付けるか確認します。拒否するものもあり、返金はまさにそのためにあります。

チームがこれをリリースのチェックリストに組み込む方法は、QAテストガイドで紹介しています。

カメルーンの番号を長期間保持できますか?課金の仕組みは?

OTP Routeには、セルフサービスで使える長期利用のカメルーン番号はありません。チームに必要な場合は、[email protected] にメールで問い合わせてください。実現できるかどうかは現地の規制次第で、お約束できるものではありません。更新している間は保持できる専用回線は、米国とカナダ向けのプロダクトで月額$1.95/monthからです。詳しくは仮想番号のページをご覧ください。

カメルーンのアクティベーションも、ほかのルートと同じく、月額料金もプランもない前払い制のUSDウォレット1つから課金されます。入金はカードまたはUSDT/USDCのステーブルコインで行え、チャージのたびにPDFの請求書が受信トレイに届きます。メールコードまたはGoogleサインインでアカウントを作成し、あとからTOTPの二要素認証を有効にできます。番号は、自社の正当なプロダクトとアカウントにのみ使用してください。各サービスの規約を守り、OTP Routeの利用規定(Acceptable Use Policy)が適用されることも忘れないでください。

よくある質問

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

はい。OTP Gatewayで+237番号を注文してアプリに入力し、ダッシュボード、または国ID cm を指定したAPIでコードを読み取ります。

カメルーンの番号は、保存時に先頭のゼロが必要ですか?

いいえ。カメルーンにはトランクプレフィックスがないため、E.164形式は +237 に9桁の国内番号を続けたものになります。

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

OTP Gatewayは1コード$0.20 からです。正確な金額はサービスによって異なり、注文前にダッシュボードで確認でき、GET /api/v1/prices でも取得できます。

認証SMSは、フランス語と英語のどちらで届きますか?

送信元のサービスと、アカウントの言語設定によります。コードは通常、数字なので、文言ではなく数字を解析してください。

カメルーンのアクティベーションがコードなしで期限切れになったら、どうなりますか?

課金はありません。20分のウィンドウがSMSなしで閉じた場合、全額がウォレットに戻り、Webhookを使っていれば activation.expired イベントが発火します。

連携を構築するためのサンドボックスはありますか?

はい、依頼に応じて提供します。開発用アカウントをサンドボックスモードに切り替えると、シミュレートされた番号とコードが返り、資金を使わずにエンドツーエンドでテストできます。

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