コンゴ共和国(+242)の認証コードをテスト環境にルーティングする

+242のコードを取得するには、最初から最後までどのAPIを呼び出しますか?

すべてはhttps://otproute.com/api/v1の配下にあり、or_live_で始まるBearerキーで認証します。キーは開発者コンソールで作成します。1アカウントに最大10個まで保持できるので、ステージング、CI、チームメンバーのノートPCに別々の認証情報を割り当て、個別に失効させることができます。

ブラザビル市場向けの典型的なテスト実行は次のようになります。

1. GET /api/v1/servicesとGET /api/v1/countriesを呼び出し、IDをキャッシュします。コンゴ共和国はcgです(より大きな隣国とは別で、そちらには独自のIDとページがコンゴ民主共和国にあります)。
2. GET /api/v1/prices?country=cg&service=<id>で、テストするアプリのライブ価格と利用可否を確認します。
3. POST /api/v1/activationsに{"service": "telegram", "country": "cg"}のような本文を付けて、アクティベーションを作成します。アクティベーションIDと+242番号が返されます。
4. その番号を、自社プロダクトの登録画面またはログイン画面に入力します。
5. コンゴのコードは、Webhookの配信、またはGET /api/v1/activations/{id}のポーリングで取得します。テストを中止する場合はPOST /api/v1/activations/{id}/cancelで解放します。

スイートの開始前にGET /api/v1/balanceを実行しておけば、ウォレットが空のときにジョブが途中ではなく早い段階で失敗します。毎分300リクエストの制限は、数個の並列ワーカーには十分な余裕があります。リクエストとレスポンスの完全な形式は開発者向けドキュメントにあります。

コンゴの有効化に、署名付きWebhookを設定するには?

1人のエンジニアが画面を操作する程度ならポーリングで十分ですが、CIの大規模な環境にはWebhookのほうが負担が少なくて済みます。開発者コンソールでエンドポイントを追加し(1アカウントにつき5つまで)、activation.sms_received、activation.expired、activation.cancelledを購読します。

すべてのリクエストにはX-OTPRoute-Signature: t=<unix>,v1=<hex>が付きます。そのエンドポイントのシークレットを使って"<t>.<raw body>"のHMAC-SHA256を再構成し、定数時間のチェックでv1と比較して、タイムスタンプが古いものは破棄してください。再シリアライズしたJSONはバイト単位で一致することがほとんどないため、JSONをパースする前に生のバイト列でハッシュを計算します。

イベントは、アクティベーションIDをキーとして扱ってください。同じイベントが2回届いた場合、ハンドラーはそのIDがすでに処理済みであることに気づき、成功のステータスを返すだけにします。Webhookによるコード取得ガイドでは、処理の遅いテストランナーがタイムアウトしないようにするキューイングのパターンを紹介しています。

コンゴの認証番号でカバーできるサービスは何ですか?

現時点のcgのスナップショットには、WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、X (Twitter)、ChatGPT (OpenAI)、Claude、Microsoft & Outlook、LinkedIn、Signal、Viber、imoが含まれます。この国のOTP Gatewayは、合計で1,000を超えるサービスに対応しています。

この一覧はルートの開閉に応じて日中に変化するため、決して固定で書き込まないでください。テストハーネスには、必要な特定のサービスについて料金エンドポイントに問い合わせさせ、利用可能なものがない場合はスキップするか、うまく再スケジュールするようにします。コンゴではメッセージングアプリが中心になりがちですが、これは現地の顧客が新しいプロダクトに出会う経路、つまりアプリストアの検索ではなく、チャットグループで共有されたリンクという実態に合っています。

+242番号はどのように保存し、正規化すべきですか?

コンゴ共和国の番号は、国番号の後に9桁が続きます。多くの番号計画と異なり、先頭の0はトランクプレフィックスではなく、加入者番号の一部です。携帯回線は国内では06…や05…、国際形式では+242 06…と書かれるのが一般的です。ヨーロッパのコードベースからコピーした、先頭のゼロを取り除く正規化処理は、これらの番号を気づかないうちに壊してしまいます。そのため、APIが返したE.164文字列をそのまま保存し、桁数の検証は1つの世界共通ルールではなく国ごとに行ってください。

公用語はフランス語で、認証SMSでも通常使われる言語ですが、日常ではリンガラ語やキトゥバ語も広く話されています。テンプレートによってはアクセント付きの文字が含まれることがあるので、固定の英語の文言に頼らず、パターンで数字を抽出するパーサーにしてください。

チームがここでテストを行うのは、フランス語圏の中央アフリカへプロダクトを展開するとき、ブラザビルやポワントノワールの運用スタッフをサポートするとき、現地の番号で今も登録する海外在住のコンゴ人顧客に対応するときなどです。実際の+242ルートでフロー全体を確認すれば、シミュレーターでは見逃すフォーマットや文面の問題を見つけられます。

+242番号にコードが届かない場合はどうなりますか?

何も届かないのは、たいていルートや受け入れの問題であり、連携のバグではありません。無理のない対処手順は次のとおりです。

• 何か結論を出す前に、20分のウィンドウを最後まで待ちます。送信トラフィックをまとめて送る送信元もあります。
• 対象サービスが仮想番号を受け付けるか確認します。受け付けないサービスも多く、だからこそ届かなかったコードには料金がかかりません。
• 短い間隔で新しい注文を繰り返してレート制限を消費するのではなく、時間を置いて再試行するか、別のサービスルートに切り替えます。
• 不要になった番号はキャンセルします。そうすれば、期限切れを待たずに資金がすぐに戻ります。

バックオフと再試行の予算については、OTP配信失敗を減らすためのガイドの記事でより深く扱っています。

コンゴの長期回線を保持できますか?

コンゴ共和国向けのセルフサービスの長期番号はありません。OTP Gatewayは認証コード1回につき1つの番号を発行するもので、現時点でcg向けに提供している製品はこれだけです。

OTP RouteのDedicated Virtual Numbersは、アメリカとカナダ向けの製品で、月額$1.95からです。インバウンドとアウトバウンドのSMS、ブラウザ通話が利用できます。継続して使えるコンゴの回線が本当に必要な場合は、[email protected]にメールしてください。手配できるかどうかは現地の規制によるため、約束ではなく問い合わせとして考えてください。トレードオフは、一時番号と専用番号の比較にまとめています。

コンゴ向けOTPルーティングの設定は、どのように課金され、安全にテストできますか?

課金は、サブスクリプションもプランの階層もない、前払いのUSDウォレット1つで行われます。チャージはカード、またはUSDT/USDCのステーブルコインで行え、チャージのたびに経理チーム向けのPDF請求書がメールで届きます。

実際のお金をパイプラインに組み込む前に、サポートに依頼して開発用アカウントをサンドボックスモードに切り替えてください。シミュレートされた番号とコードが返されるため、費用をかけずにSMS認証APIの経路全体をエンドツーエンドで実行できます。OTP Routeは自社のプロダクトと、運用する権限のあるアカウントにのみ使用してください。各サービスの利用規約と当社の利用規定(Acceptable Use Policy)も引き続き適用されます。ウォレットで料金や返金がどう表示されるかは、料金をご覧ください。

よくある質問

OTP Route APIでのコンゴ共和国の国IDは何ですか?

cgです。コンゴ民主共和国は独自のIDを持つ別の国なので、設定がどちらを参照しているか、よく確認してください。

現地のSIMなしで、アプリのコンゴ向け登録フローをテストできますか?

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

+242番号を保存するとき、先頭のゼロは取り除きますか?

いいえ。コンゴ共和国では、0は9桁の加入者番号の一部なので、APIが返したE.164の値をそのまま保存してください。

コンゴの認証SMSは何語で届きますか?

ほとんどはフランス語で届き、国際的なアプリでは英語のこともあります。特定の単語に一致させるのではなく、パターンで数字を抽出してください。

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

いいえ。SMSが届かないままウィンドウが閉じた場合や、先にキャンセルした場合は、全額が自動的にウォレットに戻ります。

コンゴのSMS OTPを受信するにはいくらかかりますか?

1コード$0.20 からです。各アプリの+242の価格はライブで提示されるので、注文前に照会してください。

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

はい、ご依頼に応じて利用できます。サポートが開発用アカウントをサンドボックスモードにでき、ウォレットの資金に触れずに、シミュレートされた番号とコードが返されます。

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