QAチームと市場参入のためのケニア(+254)認証番号

なぜプロダクトチームはケニア市場に対してテストするのか?

ナイロビは東アフリカで最も活気のあるテクノロジー拠点の一つで、ケニアのユーザーは徹底したモバイルファーストです。多くの人にとって、電話番号はメッセージング、配車、Eコマース、とりわけモバイルマネーの中核となるIDであり、+254番号を正しく扱えないサインアップフローは、初日から顧客を失います。

英語とスワヒリ語はどちらも公用語です。グローバルなアプリの多くは英語でコードを送りますが、この地域向けにローカライズしたプロダクトはスワヒリ語に切り替えることがあります。自社のテンプレートを翻訳している場合は、確認する価値があります。ここでテストを行う主な理由は次のとおりです。

• 東アフリカでフィンテック、配送、マーケットプレイスのプロダクトをローンチする。
• SMSテンプレートとオンボーディング画面のスワヒリ語の文面を検証する。
• スタッフの番号を明かさずに、ケニアの顧客向けのサポートや運用アカウントを運営する。

より広いパターンについては、フィンテックのオンボーディングのページで解説しています。

ケニアの携帯番号はE.164でどう書く?

現地では、携帯番号はトランクプレフィックス 0 付きで、07XX XXX XXX や 01XX XXX XXX のように書きます。国際形式ではゼロが取り除かれ、+254 に9桁の加入者番号が続きます。

典型的な不具合は、国番号の後ろにそのゼロを残してしまい、送信側が分かりにくいエラーなしで拒否する、無効な +2540... という文字列になることです。データベースに入る前に、すべての入力を正規化してください。

1. スペース、ハイフン、かっこを取り除く。
2. 値が 0 で始まる場合は、それを取り除いて +254 を前置する。
3. プラスなしで 254 から始まる場合は、プラスを付ける。
4. 結果をE.164文字列として保存し、正規化後に桁数を検証する。

テスト用の+254番号があれば、実際の受信SMSで、そのロジックの各分岐を簡単に確認できます。

ケニアのルートで今利用できるサービスは?

ケニアは、カタログが最も充実した国の一つで、リアルタイムのスナップショットでは2,800を超えるサービスがあります。よくリクエストされるものには、WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、X (Twitter)、ChatGPT (OpenAI)、Microsoft & Outlook、Uber、LinkedIn、Signal、Netflixがあります。

利用可否は時間ごとに変わることがあるため、APIは固定の一覧ではなく、リアルタイムで返します。

ケニアのOTP APIをテストスイートに組み込むには?

Developerコンソールで発行した or_live_ で始まるBearerキーで、https://otproute.com/api/v1 に対して認証します。ケニアの国IDは ke です。

典型的なCIのステップでは、まず GET /api/v1/balance を呼び、ウォレットが空なら実行がすぐに失敗するようにします。次に GET /api/v1/prices?country=ke&service=<id> を確認し、{"service": "uber", "country": "ke"} のような本文で POST /api/v1/activations を使って注文し、返された+254番号をテスト対象のアプリに入力します。コードは、activation.sms_received のWebhook、または数秒おきの GET /api/v1/activations/{id} のポーリングで返ってきます。毎分300リクエストの上限には十分な余裕があります。

Webhookでは、最大5つのエンドポイントを登録し、エンドポイントのシークレットで <t>.<raw body> のHMAC-SHA256を計算して X-OTPRoute-Signature を検証し、古いタイムスタンプは拒否します。再試行された配信が無害になるよう、ハンドラーはアクティベーションIDをキーにしてください。パイプラインへの組み込み方はCIテストガイドに、完全なリファレンスはドキュメントにあります。

コードを書かずに+254番号を注文できる?

はい。ダッシュボードでOTP Gatewayを開き、ケニアを選び、サービスを選んで、表示された価格を確認します。番号はすぐに表示されます。それをサインアップやログインのフォームに貼り付けると、受信した時点でコードがアクティベーションの隣に表示されます。サポート担当者やアカウントマネージャーはこの方法で作業でき、エンジニアは同じウォレットでAPIを使えます。

ケニアのコードが遅い、または届かないときに役立つことは?

各アクティベーションには20分のウィンドウがあります。課金されるのはコードが届いたときだけです。ウィンドウが空のまま終わった場合、または POST /api/v1/activations/{id}/cancel でキャンセルした場合は、チケットなしで金額がウォレットに戻ります。

再試行する前に、ウィンドウに時間を与えてください。送信元によってはメッセージをキューに入れます。それでも失敗する場合は、時間をおくか別のサービスルートで再試行し、アプリが仮想番号を受け付けるかも確認してください。受け付けないものもあります。注文エンドポイントを短い間隔で連打するのは避けてください。多くの送信元は、同じフローへの繰り返しのリクエストを制限します。その他の対処法は、OTP配信失敗を減らすにはの記事にまとめています。すべてのテストは対象サービスの規約の範囲内で行い、OTP Routeの利用規定(Acceptable Use Policy)も適用されます。

ケニア案件向けの長期回線、ウォレット、サンドボックス

OTP Routeは、セルフサービスのケニアの長期番号を販売していません。専用回線は米国とカナダのみで、月額$1.95から、受信SMS、送信SMS、ブラウザ通話に対応します。+254の継続的な回線が必要なチームは、[email protected] にメールで問い合わせできますが、提供の可否は現地の規制によります。

支払いは単一のUSDウォレットによる従量課金で、カードまたはUSDTやUSDCのステーブルコインでチャージでき、チャージのたびにPDFの請求書が発行されます。月額料金はありません。費用の表示方法は料金をご覧ください。開発アカウントはリクエストによりサンドボックスに切り替えられ、ウォレットの費用なしで、エンドツーエンドのインテグレーションテスト用に模擬の番号とコードが返されます。

よくある質問

ケニア国外から、アプリのケニア向けサインアップフローをテストできる?

はい。チームがどこにいても、OTP Gatewayで+254番号を注文し、受信したコードをダッシュボードまたはAPIで読み取れます。

ケニアにはどの国IDを送る?

価格のクエリとアクティベーションの本文で ke を送ります。たとえば {"service": "whatsapp", "country": "ke"} のようにします。

ケニアの番号は先頭のゼロ付きで保存すべき?

いいえ。トランクプレフィックスの0を取り除き、+254に9桁を続けた形で保存します。

ケニアの認証テキストはスワヒリ語で届く?

通常は英語で届きますが、ケニア向けにローカライズされたアプリはスワヒリ語を送ることがあります。テンプレートを翻訳している場合は、両方を確認してください。

コードが届かなかった場合、お金はどうなる?

SMSが届かないまま20分のウィンドウが閉じると自動的に、またはキャンセルするとすぐに、ウォレットへ戻ります。

+254のコードには、Webhookとポーリングのどちらがよい?

並列のテストジョブにはWebhookのほうが拡張しやすく、単一のスクリプトには GET /api/v1/activations/{id} のポーリングのほうがシンプルです。どちらも同じアクティベーションを読み取ります。

毎月保持できるケニアの番号は取得できる?

セルフサービスではできません。専用番号は米国とカナダに限られます。ケニアの回線が必要な場合は、[email protected] にメールしてください。

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