ニジェール(+227)の認証コードをQAワークフローに取り込む

なぜプロダクトチームに+227番号が必要なのですか?

ニジェールはフランス語圏の西アフリカに位置し、西アフリカ経済通貨同盟に加盟しているため、近隣の複数市場をまとめて展開する際によく含まれます。現地で認証を行う典型的な理由は、登録フォームがニジェールの番号を受け付けることの確認、フランス語のオンボーディング文言のチェック、ニアメの顧客から報告された問題の再現などです。チームの進め方はQAテストのページをご覧ください。

ニジェールのルートはどのアプリに対応していますか?

このルートでは現在、900を超えるサービスを利用できます。よく選ばれるのは、WhatsApp、imo、Facebook、Telegram、Google (Gmail & YouTube)、TikTok、Instagram、Viber、Signal、LinkedIn、Microsoft & Outlook、ChatGPT (OpenAI)です。

規模の小さいルートでは、一日の中での提供状況の変化がより目立ちます。サービスが見つからない場合は、時間をおいて再試行するか、ブルキナファソやベナンなどの近隣国で同じ地域テストを実行してください。

ニジェールのOTP APIはどのように呼び出しますか?

or_live_ で始まるBearerキーで認証し、リクエストを https://otproute.com/api/v1 に送信します。ニジェールの国IDは ne です。

• GET /api/v1/prices?country=ne&service=<id> は、リアルタイムの価格と、そのルートが現在利用可能かどうかを返します。
• POST /api/v1/activations に {"service": "whatsapp", "country": "ne"} を送ると、+227番号を確保し、アクティベーションIDが返されます。
• GET /api/v1/activations/{id} はステータスを返し、配信後にはコードも返します。activation.sms_received のWebhookを使えばポーリングは不要です。
• POST /api/v1/activations/{id}/cancel は不要になった番号を解放し、返金します。

Webhookの配信には X-OTPRoute-Signature ヘッダーが付きます。HMACを検証し、同じアクティベーションIDが再度届いた場合は何もしない扱いにしてください。リクエストとレスポンスの詳細は開発者ドキュメントにあります。

ニジェールの番号はどのような形式ですか?

ニジェールはクローズドな番号計画で、国内番号は8桁、トランクプレフィックスはないため、取り除くべき先頭の0はありません。E.164形式では +227 に8桁を続けて保存し、バリデーターが余分な1桁や0を誤って要求しないようにしてください。

ビジネスや公的な場ではフランス語が広く使われ、日常会話ではハウサ語、ザルマ語などの国語が一般的です。国際的なアプリからの認証SMSは、アカウントの言語設定に応じて、通常フランス語か英語で届きます。

ニジェールの認証テスト計画には何を含めるべきですか?

短いチェックリストがあれば、+227のテスト実行を予測しやすく、低コストに保てます。

• 入力処理:プラス記号あり・なし、スペース入りの番号を貼り付け、フォームが3つとも同じE.164の値に正規化することを確認します。
• 国選択:ニジェールがフランス語名と英語名の両方で表示され、選択すると +227 が事前入力されることを確認します。
• 文言レビュー:ニジェールのユーザーが目にするフランス語のオンボーディング文言とエラーメッセージを読みます。
• タイムアウト:自社アプリの再送タイマーと20分のアクティベーション有効時間が衝突しないようにし、1件の結果を待ってから次を要求します。
• フォールバック:そのサービスについてニジェールに空きがない日に、パイプラインがどの近隣ルートを試すかを、あらかじめ決めておきます。

再試行の側面については、OTP配信失敗の低減の記事で詳しく解説しています。

コードを書かずにコードを注文できますか?

はい、ダッシュボードから可能です。ニジェールとサービスを選び、確定する前に価格を確認し、+227番号をアプリに貼り付けて、コードが表示されるまでアクティベーションを開いたままにします。ここでも20分の有効時間が適用され、使われなかった分は自動的にウォレットに戻ります。

ニジェールの長期番号は利用できますか?課金はどうなりますか?

ニジェール向けのセルフサービスの長期番号はありません。専用バーチャル番号は米国とカナダ向けの製品で、月額$1.95からです。+227の長期回線が必要な場合は [email protected] までご連絡ください。可否は現地の規則次第で、対応できない場合もあります。

課金は、カードまたはUSDT/USDCでチャージする1つのプリペイドUSDウォレットで行われ、プランも月額料金もなく、チャージごとにPDF請求書が発行されます。料金は料金ページに掲載しています。開発用アカウント向けのサンドボックスモードでは、連携を先に試したいときにシミュレートされた番号とコードが返されます。

よくある質問

現地オペレーターのSIMがなくても、アプリのニジェール向けオンボーディングを確認できますか?

はい。OTP Gatewayで対象サービス用の+227番号をリクエストし、自社のオンボーディング画面に入力して、コードをダッシュボードまたはAPIで受け取ってください。

ニジェールの番号は0で始まりますか?

いいえ。ニジェールにはトランクプレフィックスがありません。番号は+227の後に8桁が続くため、正規化は簡単です。

ニジェールの認証メッセージは何語で届きますか?

通常はフランス語か英語で、送信元のアプリとアカウントの言語で決まります。この市場向けにローカライズする場合は、フランス語の文言のレビューを計画してください。

+227番号にコードが届きませんでした。どうすればよいですか?

20分の有効時間が終わって返金が適用されるのを待ち、その後、時間をおいて再試行するか、別のサービスルートでテストしてください。サービスが仮想番号を拒否している可能性があり、短時間に繰り返し注文しても効果はほとんどありません。

ニジェールの価格は他の国と同じですか?

同じとは限りません。料金は$0.20/コードからで、サービスと国によって異なるため、注文前に GET /api/v1/prices を呼び出すか、ダッシュボードで確認してください。

同じニジェール番号で、後から2つ目のコードを受信できますか?

いいえ。OTP Gatewayの番号で処理できるのは認証コード1回分です。繰り返しサインインが必要なアカウントには、米国またはカナダの専用番号が向いています。

西アフリカ全体のテストでは、どの近隣ルートを使えますか?

ブルキナファソ、ベナン、マリ、ナイジェリアにはそれぞれ独自のルートがあります。現在利用できるものは GET /api/v1/countries で確認してください。

+227番号を使うときのルールはありますか?

ご自身または自社のアカウントの認証にのみ使い、各サービスの規約を守り、OTP Routeの利用規定(Acceptable Use Policy)に従ってください。大量登録やプロモーションの不正取得は認められません。

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