サントメ・プリンシペから+239の認証コードを受け取る方法

なぜサントメ・プリンシペでプロダクトチームがテストするのですか?

島々からなるこの国はアフリカでも最小級の市場ですが、ポルトガル語圏にサービスを提供するプロダクトにとっては重要です。ポルトガル語圏アフリカに展開するチームや、島とポルトガル、アンゴラを行き来する顧客をサポートするチームは、+239の番号がサインアップフォームを通過すること、そしてポルトガル語の文面が正しく表示されることを確認する必要があります。

公用語はポルトガル語で、国際的なアプリからの認証SMSは、アカウント設定によってポルトガル語か英語で届くのが一般的です。フォロ語などの現地クレオール語は広く話されていますが、自動送信のSMSに使われることはまずありません。

実務上の理由もあります。サントメ島やプリンシペ島にスタッフを置くNGO、開発支援機関、リモートファーストの雇用主は、オンボーディングが現地番号で動作するかを確認したがります。ポルトガルからの送金ルートを広げるフィンテックチームも、+239の顧客が登録を完了できる証拠を求めます。実際の島の番号でQAを走らせれば、戸惑ったユーザーからの問い合わせを待つよりも早く答えが出ます。

+239の番号はどう記述し、どう保存しますか?

国内番号は7桁で、携帯電話は9で始まるのが一般的です。E.164では+239に7桁を続けた形になります。このような短い番号は、最小8桁以上を想定するバリデーターで弾かれがちです。パース処理のテストに+239のケースを加え、保存前にスペースやハイフンを正規化してください。

データをきれいに保つためのポイントをいくつか挙げます。

• 正規の+239文字列を保存し、判定した国は別カラムに持たせます。
• 古い連絡先カードから貼り付けられた00239の国際プレフィックスは取り除きます。
• 7桁の番号を、固定長のデータベースフィールドに合わせてパディングしないでください。フィールドのほうを広げます。
• 単体テストに+239のフィクスチャを少なくとも1つ含め、将来バリデーターが変更されても気付かないうちに壊れることがないようにします。

OTP Gatewayはサントメ・プリンシペで何を提供しますか?

この国のライブカタログには、600を超えるサービスがあります。よく選ばれるのは、WhatsApp、Telegram、Facebook、Instagram、Google (Gmail & YouTube)、Microsoft & Outlook、Discord、LinkedIn、Signal、Viber、imo、Amazonなどです。

小規模な市場では、時間帯によってカバー範囲が薄くなることがあります。昨日の結果を信用せず、注文のたびにGET /api/v1/pricesを確認してください。ルートが空の場合は、カーボベルデのような近隣のポルトガル語圏のルートや、アンゴラのようなより大きなルートと比べてみてください。

国ID stでのAPIフローはどうなりますか?

1. GET /api/v1/prices?country=st&service=<id>で、リアルタイムの価格と在庫状況を取得します。
2. POST /api/v1/activationsに{"service": "<id>", "country": "st"}を送って、番号を確保します。
3. その番号をアプリで使い、Webhookでactivation.sms_receivedを待つか、GET /api/v1/activations/{id}をポーリングします。
4. 不要になった試行は、POST /api/v1/activations/{id}/cancelで終了します。

呼び出し先はhttps://otproute.com/api/v1で、Bearerのor_live_キーを使います。X-OTPRoute-Signature("<t>.<raw body>"のHMAC-SHA256)を検証し、古いタイムスタンプは破棄してください。やり方はHMACによるOTP Webhookの保護で解説しています。

コードを書けない人でも使えますか?

はい。メールコードまたはGoogleでサインアップしたら、OTP Gatewayを開き、サービスを選び、サントメ・プリンシペを選択して、表示された価格を確認します。番号はすぐに表示され、SMSが届くと同じ画面にコードが現れます。

島のお客様からの苦情を再現したいサポート担当者や、リリース前にポルトガル語のオンボーディング画面を一度確認したいプロダクトマネージャーに向いています。ダッシュボードにはウォレットと受信したコードの両方があるため、アカウントでTOTP二要素認証を有効にしておきましょう。

長期用の番号、課金、サンドボックスについては?

セルフサービスの長期用+239番号はありません。Dedicated Virtual Numbersは米国とカナダ向けの製品で、月額$1.95からです。島の継続的な回線が必要な場合は[email protected]までメールしてください。ただし、実現できるかどうかは現地の規則次第です。

支払いは、月額料金のない前払いUSDウォレットから行い、カードまたはUSDT/USDCでチャージできます。チャージごとにPDFの請求書が発行されます。サンドボックスアカウントでは、連携テスト用に模擬の番号とコードが返されます。詳細は/pricingをご覧ください。

ウォレットは全ての国で共通なので、ポルトガルやブラジルと並行して島々をテストするチームは、すべてのアクティベーションを1つの残高と1組の請求書で確認できます。経理の月末照合も簡単になります。

よくある質問

島を訪れなくても、アプリのサントメ・プリンシペ向けサインアップを確認できますか?

はい。OTP RouteのOTP Gatewayで+239の番号を注文してアプリに入力し、コードはダッシュボードまたはAPIで確認します。

+239のコードが届かない場合はどうすればよいですか?

アクティベーションを20分間フルに待ってから、時間を置くか別のサービスルートで再試行してください。数秒おきに繰り返し注文するのは避けましょう。

サントメ・プリンシペのアクティベーションが失敗した場合、請求されますか?

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

なぜアプリがサントメ・プリンシペの認証番号を拒否するのですか?

一部のサービスは仮想番号を受け付けません。これはOTP Routeでは制御できないため、未使用のアクティベーションが返金されます。

認証SMSはポルトガル語で届きますか?

公用語がポルトガル語なので、そうなることが多いです。ただし文面は各アプリが決めており、英語の場合もあります。

サントメ・プリンシペのOTP APIにレート制限はありますか?

各アカウントは毎分300リクエストまで可能で、APIキーは最大10個、Webhookエンドポイントは最大5つです。

CIジョブで実行できますか?

はい。実行ごとにアクティベーションを1つ注文してください。チームでの構成例はQAテストのページで紹介しています。

OTP Routeでは、どのような用途が許可されていますか?

ご自身のプロダクトのテストと、正当なビジネスアカウントの運用です。各サービスの利用規約とOTP Routeの利用規約(Acceptable Use Policy)の範囲内でご利用ください。

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