ギニア（+224）の認証コードをテストやツールに取り込む方法

なぜテスト用に+224番号が必要になるのですか？

ギニアは西アフリカのフランス語圏に位置しており、この地域へ展開するプロダクトでは、マーケティング費用を投じる前にギニアの加入者でサインアップが問題なく動くことを確認しておく必要があるケースがよくあります。ほかにも、フランスなど各地のギニア系ディアスポラ向けアプリ、フランス語圏市場向けのフィンテックのオンボーディングフローの検証、コナクリで共有ビジネスアカウントを管理する現場・運用チームなどが典型的な場面です。いずれも、チームの誰も携帯電話を持ち歩かずに使える+224のテスト用番号を必要としています。

OTP Routeなら、現地SIMの手配なしでこのニーズに対応できます。リリースチェックリストに組み込む方法は、QAテストのページで紹介しています。

ギニアの認証番号に届くサービスは何ですか？

現在のギニアのスナップショットで利用できる主なサービスは、WhatsApp、imo、Telegram、Viber、Facebook、Instagram、TikTok、Snapchat、Signal、Google（Gmail & YouTube）、Microsoft & Outlook、ChatGPT（OpenAI）などです。全カテゴリーを合わせると、このルートでは1,700を超えるサービスに対応しています。

このルートの空き状況は一日の中で変動するため、一覧を何週間もキャッシュせず、APIからリアルタイムで取得してください。選ぶサービスは、テストケースが本当に依存しているものにしましょう。たとえば、オンボーディングがギニアのユーザーに人気のメッセージングアプリ経由でコードを送るなら、一覧の先頭にあるものではなく、そのアプリを検証する価値があります。

ギニアOTP APIのシーケンスはどうなっていますか？

https://otproute.com/api/v1 に対して、Bearerキー（接頭辞 or_live_）で認証します。まず GET /api/v1/prices?country=gn&service=<id> で、そのサービスがギニアで利用可能かを確認します。次に POST /api/v1/activations に {"service": "<id>", "country": "gn"} を送ってアクティベーションIDを控え、テスト対象のアプリに番号を入力します。

コードは、登録済みWebhookへの activation.sms_received として届くほか、GET /api/v1/activations/{id} をポーリングして取得することもできます。X-OTPRoute-Signature ヘッダー（エンドポイントのシークレットで <t>.<raw body> に対して計算したHMAC-SHA256）を検証し、古いタイムスタンプは拒否し、処理済みのアクティベーションの重複イベントは無視してください。実行を途中でやめる場合は POST /api/v1/activations/{id}/cancel を使います。さらに詳しくは、連携ガイドとドキュメントをご覧ください。

技術者以外のスタッフ向けのブラウザ操作はどうなりますか？

OTP Gatewayを開いてギニアを選び、サービスを検索して価格を確認し、注文します。表示された番号をテスト対象の認証画面に貼り付けると、届いたSMSがダッシュボードのアクティベーションカードに表示されます。ギニアのクライアントアカウントを扱う代理店は、共有ウォレット1つで全員分をまかなえ、APIキーをエンジニアリングチームの外に出す必要もないため、この方法を選ぶことが多いようです。サインアップはメールアドレスと6桁のメール確認コードだけで、アカウント自体には認証アプリによる二要素認証も使えます。

+224番号はどう保存すべきで、コードは何語で届きますか？

ギニアにはトランクプレフィックスがなく、国内番号は9桁で、携帯番号は通常6から始まります。入力値は +224 に続けてこの9桁を付けた形に正規化し、データベースにはその単一のE.164形式だけを保存してください。8桁で書かれた古いレコードは、データクレンジングの際にフラグを付けておくとよいでしょう。

公用語はフランス語で、プラール語、マニンカ語、スス語も広く話されています。グローバルなサービスは、アカウントの言語設定に応じてフランス語か英語で認証SMSを送るのが一般的なので、コードの抽出は文面ではなく数字に基づいて行ってください。

ギニアのコードが届かないときは何を確認すればよいですか？

• 20分のウィンドウが終わるまで待ちましょう。料金が発生するのはコードが届いた場合のみです。
• そのサービスが仮想番号を受け付けているか確認してください。拒否するサービスもあり、自動返金はまさにそのケースのための仕組みです。
• 時間をおいて再試行するか、別のサービスルートを試してください。どの国でも、OTPルーティングの状況は一日の中で変わります。
• 短い間隔で繰り返し注文を出すのは避けましょう。少し間隔を空ければ、リクエストの上限枠を無駄にしません。

地域での比較には、近隣のフランス語圏であるセネガルのルートで同じテストケースを試すのも一案です。

ギニアの番号を長期間保持できますか？

ダッシュボードからはできません。ギニアにはセルフサービスの長期番号がなく、アクティベーション用の番号は1コード限りです。専用の仮想番号（Dedicated Virtual Numbers）は米国とカナダのみで、月額$1.95からご利用いただけます。ダッシュボードでのSMS受信、Webhookへの転送、送信SMS、ブラウザからの発信にも対応しています。ギニアで長期利用できる回線が必要な場合は、[email protected] までメールでお問い合わせください。提供可否は現地の規制によって決まり、手配できない場合はチームが率直にお伝えします。

よくある質問

現地SIMなしで、ギニアのサインアップをテストできますか？

はい。OTP Gatewayで+224番号を注文し、サインアップフォームに入力すれば、コードをダッシュボードまたはWebhook経由で読み取れます。

OTP Routeはギニアにどの国IDを使いますか？

IDは gn です。アクティベーションのリクエストボディと、価格取得クエリに指定してください。

ギニアのSMS OTPを受信するといくらかかりますか？

1コードあたり$0.20 からで、正確な金額はサービスによって異なり、注文前に表示されます。

コードが届かなかったアクティベーションにも料金はかかりますか？

いいえ。SMSが届かないまま20分のウィンドウが終了した場合、またはキャンセルした場合は、全額がウォレットに自動で返金されます。

ギニアのコードにはWebhookが必須ですか？ポーリングでもよいですか？

どちらでも構いません。並列実行するテストスイートにはWebhookが向いており、簡単なスクリプトなら GET /api/v1/activations/{id} のポーリングで十分です（1分あたり300リクエストの上限内で）。

すべてのサービスが+224のOTP Route番号を受け付けますか？

いいえ。仮想番号を拒否するサービスもあり、そのため未使用のアクティベーションは返金されます。各サービスの利用規約と、当社の利用規定（Acceptable Use Policy）を必ず守ってください。

支払い方法は？請求書はもらえますか？

プリペイドのUSDウォレット1つに、カードまたはUSDT/USDCでチャージします。プランや月額料金はありません。チャージのたびにPDFの請求書がメールで届きます。料金ページもご覧ください。

ギニア向けの連携を開発するためのサンドボックスはありますか？

はい、リクエストに応じてご用意します。開発用アカウントをサンドボックスに切り替えると、模擬の番号とコードが返されるため、ウォレットの残高を使わずに、SMS認証APIのフローを最初から最後まで実行できます。

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