ソマリアのユーザーを認証する:QAと市場投入のための+252番号

ソマリアのテストで特に注意すべき点は何ですか?

公用語はソマリ語とアラビア語で、アカウントの言語設定によって、アプリはどちらか、あるいは英語でコードを送信する場合があります。アラビア語のテキストはUnicode SMSとして送信されるため、周囲の文章が右から左に書かれていても、パーサーが数字を正しく抽出できるかを確認する価値があります。

チームが+252を対象にする理由は、たいてい次の3つのいずれかです。アフリカの角でモバイルファーストのプロダクトを立ち上げる、北米・ヨーロッパ・湾岸諸国にいる大規模なソマリア系ディアスポラに向けてサービスを提供する、あるいは、ビジネスアカウントに現地の番号が必要な地域オペレーションを運営する、といったケースです。QA面についてはモバイルアプリ認証のページで解説しています。

ディアスポラ向けのプロダクトには特に注意が必要です。ミネアポリスやロンドンで作られた送金アプリやメッセージングアプリが、ソマリアの親族を+252番号でオンボーディングすることがあり、そのサインアップは国内ユーザーのものと全く同じ挙動、つまり同じ画面、同じリトライロジック、同じエラーメッセージである必要があります。実際のソマリアの認証番号でテストするのが、その流れをエンドツーエンドで確認する最も簡単な方法です。

+252番号はデータベースにどう保持すべきですか?

E.164形式、つまり+252に国内有効番号を続けた形で保持します。ユーザーが先頭にゼロが付いた国内形式で入力した場合は、国番号を付ける前にそのゼロを取り除いてください。正規化した値を一度だけ保存し、入力時に検証し、表示用のフォーマットは末端でのみ行います。こうすることで、同じ顧客が海外から登録した場合でも、検索と重複排除が確実に機能します。

電話番号入力のエッジケースもテストしておくと便利です。スペース入りで貼り付けられた番号、国際プレフィックス00252付きの番号、プラス記号付きで入力された番号です。いずれも同じ保存値に統一されるべきで、OTPルーティングのロジックは、ユーザーのIPアドレスではなくその値からソマリアのルートを選ぶ必要があります。

ソマリアの番号にコードを送信できるサービスは?

ソマリアのルートでは900を超えるサービスを利用できます。人気のあるものには、WhatsApp、Telegram、Google(Gmail & YouTube)、Facebook、Instagram、TikTok、imo、Viber、Signal、Snapchat、Microsoft & Outlookなどがあります。在庫は一日の中で変動するため、いま利用できるものはAPIで確認してください。

ソマリアのOTP APIの呼び出しフローは、実際にはどうなりますか?

https://otproute.com/api/v1に対し、or_live_で始まるBearerキーを使います。

1. GET /api/v1/servicesとGET /api/v1/countriesでIDを取得します。ソマリアはsoです。
2. GET /api/v1/prices?country=so&service=<id>で価格を確認します。
3. 注文を開始します:POST /api/v1/activations に {"service": "<id>", "country": "so"} を送信します。
4. ソマリアの注文に対するactivation.sms_receivedコールバックを受け取るか、GET /api/v1/activations/{id}をポーリングして状態を確認します。
5. 不要な注文はPOST /api/v1/activations/{id}/cancelで解放します。

X-OTPRoute-Signature(<t>.<raw body>のHMAC-SHA256)を検証し、古いタイムスタンプのリクエストは拒否してください。アカウントでは、最大10個のキー、5個のWebhookエンドポイント、1分あたり300リクエストまで利用できます。詳しくはドキュメントをご覧ください。

運用担当の同僚はダッシュボードから実行できますか?

はい。OTP Gatewayを開き、ソマリアとサービスを選択して、価格を確認し、注文します。+252番号はすぐに表示され、コードが届くとその横に表示されます。この方法ではコードもAPIキーも不要なので、単一のビジネスプロフィールを設定する地域マネージャーや、顧客のサインアップの問題を再現するサポート担当者に向いています。

ソマリアのコードが届かない場合は?

ルートの状況はさまざまで、仮想番号を拒否するサービスもあります。20分のウィンドウが終わるまで待ってください。期限切れまたはキャンセルの場合は全額が返金されます。その後、短時間に連続で再注文するのではなく、時間をおいて再試行するか、別のサービスルートを試してください。どのサービスと時間帯で試行したかを簡単に記録しておくと、記憶に頼るよりもパターンが見つけやすくなります。ソマリアは大きな市場に比べてカバレッジが薄いことがあるため、東アフリカの番号があればよいテストなら、ケニア、エチオピア、ジブチなど近隣のルートを確認する価値があります。

ソマリアの長期回線は取得できますか。課金の仕組みは?

ソマリアにはセルフサービスの長期番号はありません。専用回線は米国とカナダのみで、月額$1.95からです。継続的に使えるソマリアの回線が必要なチームは、[email protected]までご連絡ください。提供可否は現地の規則次第で、お約束はできません。当面は、ソマリアの一度きりの認証にはゲートウェイを使い、繰り返しのログインには他の国で登録したアカウントを使ってください。

支払いは、1つのプリペイドUSDウォレットからの従量課金で、カードまたはUSDT/USDCでチャージし、チャージごとにPDFの請求書がメールで届きます。連携テスト用に、リクエストに応じてサンドボックスモードも利用でき、実際の注文を始める前にWebhookハンドラーとパーサーを検証できます。最新の料金は料金ページをご覧ください。

よくある質問

現地のSIMカードなしでソマリアのオンボーディングフローを確認できますか?

はい。OTP Gatewayで+252番号を注文すれば、ダッシュボードまたはWebhookでコードを確認できます。

ソマリアのAPI国IDは何ですか?

soで、価格照会とPOST /api/v1/activationsのボディで使います。

コードはソマリ語とアラビア語のどちらで届きますか?

サービスとアカウントの言語によります。OTP Routeはメッセージ本文をそのまま配信するため、両方の文字でパーサーをテストしてください。

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

1コード$0.20からです。サービスごとのライブ価格はGET /api/v1/pricesで返され、確定前に表示されます。

後のログインのために、同じソマリアの番号を保持できますか?

いいえ。ゲートウェイの番号は1回のコード受信用で、セルフサービスの長期番号は米国とカナダでのみ提供しています。

OTP Routeは、認証するアプリと提携していますか?

いいえ。サービス名はそれぞれの所有者に帰属し、OTP Routeの利用規定(Acceptable Use Policy)に加えて、各サービスの利用規約も守る必要があります。

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