セネガル(+221)のOTP:まず適切なOTP Routeの製品を選ぶ

OTP GatewayとDedicated Numberのどちらがセネガルに向いていますか?

コードを書き始める前に、本当に必要なものを決めておきましょう。2つの製品は別々の問題を解決するものだからです。

• コード1回で完了。 サインアップのテスト、ログイン画面のQA確認、ビジネスプロフィールの一度きりの認証といった場合は、OTP Gatewayを使います。1回の認証用に+221の番号が割り当てられ、アクティベーションが終わると失効します。
• 使い続けられる番号。 来月もう一度ログインする必要があるステージングアカウントや、リカバリーが必要な共有チームログインには、Dedicated Numberが適しています。これは米国とカナダでのみ即時購入でき、月額$1.95からです。

セネガルにはセルフサービスの長期用番号がありません。+221の継続的な回線が重要な場合は、[email protected]までメールしてください。可能かどうかは現地の規則によります。トレードオフの詳細は一時番号と専用番号の比較ガイドで解説しています。

OTP Gatewayは+221で何をカバーしますか?

セネガルには現在、1,600を超えるサービスが登録されています。よく使われるものには、WhatsApp、Facebook、Instagram、TikTok、Telegram、Google (Gmail & YouTube)、ChatGPT (OpenAI)、Claude、Microsoft & Outlook、Amazon、Netflix、Snapchat、Viber、imoなどがあります。

これはライブカタログのスナップショットです。注文できる組み合わせは日中に変わるため、実行前にダッシュボードまたはAPIで在庫を確認してください。

国`sn`でのセネガルOTP APIのフローはどう動きますか?

or_live_で始まるBearerキー(アカウントあたり最大10個、毎分300リクエスト)で、https://otproute.com/api/v1に認証します。その後の手順は次のとおりです。

1. GET /api/v1/countriesとGET /api/v1/servicesでIDを確認します。セネガルはsnです。
2. GET /api/v1/prices?country=sn&service=facebookで現在の料金を読み取ります。
3. POST /api/v1/activationsに{"service": "facebook", "country": "sn"}を送って注文し、アクティベーションIDを保管します。
4. GET /api/v1/activations/{id}のポーリング、またはWebhookイベントactivation.sms_receivedでコードを受け取ります。
5. セネガルのテストを途中で中止する場合は、POST /api/v1/activations/{id}/cancelで番号を解放します。

Webhookでは、X-OTPRoute-Signatureヘッダーを検証してください。エンドポイントのシークレットで"<t>.<raw body>"のHMAC-SHA256を計算してv1と比較し、古いタイムスタンプは拒否します。activation.expiredとactivation.cancelledも処理し、各アクティベーションIDは一度だけ処理してください。パイプライン内での実行方法は、CIパイプラインでのSMS OTPテストで扱っています。

セネガルの番号とSMSには何か特徴がありますか?

セネガルの国番号は+221で、番号計画にトランクプレフィックスはありません。9桁の国内番号をそのまま全桁ダイヤルし、携帯電話は7で始まります。E.164形式は+221に9桁を続けただけなので、正規化の作業は主に、スペース、ドット、00の国際プレフィックスを取り除くことです。

公用語はフランス語で、ウォロフ語も非常に広く話されています。国際的なアプリの多くは、アカウントの言語設定に応じて、フランス語か英語でコードを送ります。数字の周囲にアクセント付き文字が含まれる場合も含め、フランス語のメッセージ文でパース処理をテストしてください。

企業がセネガルでテストするのは、フランス語圏西アフリカに進出するとき、フランス語話者向けにフローをローカライズするとき、ダカールとヨーロッパを行き来する顧客に対応するときです。この地域をカバーするチームは、コートジボワールでも同じチェックを行うことがよくあります。

APIを使わずにセネガルのSMS OTPを受信できますか?

はい。メールアドレスと6桁のコード、またはGoogleでサインアップし、お好みでTOTP二要素認証を有効にします。資金を追加してOTP Gatewayを開き、セネガルとサービスを選び、料金を確認して注文します。+221の番号をアプリにコピーすると、SMSが届いた時点でダッシュボードにコードが表示されます。

アクティベーションは20分間有効です。課金されるのはコードが届いたときだけです。何も届かないままウィンドウが閉じた場合、またはキャンセルした場合は、全額がウォレットに戻ります。

+221のコードが遅い、または届かないとき

所要時間はサービスとルートによって異なるので、まずは待つことが大切です。メッセージが届かないままアクティベーションが期限切れになった場合は、次のようにしてください。

• 少し待ってから再注文するか、プロダクトで可能なら同じフローに別のサービスルートを使います。
• サービスが仮想番号を受け付けるか確認します。拒否するサービスもあり、その場合は返金が適用されます。
• キャンセルして短時間で再注文を繰り返すのではなく、ウィンドウを最後まで走らせます。
• 自動化されたスイートでは、エンドポイントに連打するのではなく、試行の間隔を空けます。

番号は、ご自身が正当に運用しているプロダクトとアカウントにのみ使用し、各サービスの利用規約を守り、OTP Routeの利用規約(Acceptable Use Policy)の範囲内でご利用ください。

ウォレット、請求書、連携テスト用のサンドボックス

課金は、前払いのUSDウォレット1つで行われます。従量課金で、月額料金もプラン選択もありません。チャージはカードまたはUSDT/USDCのステーブルコインで、チャージのたびに経理担当者向けのPDF請求書がメールで届きます。まだ連携を組み立てている段階なら、開発アカウントのサンドボックスモードをリクエストしてください。模擬の番号とコードが返されるため、残高を使わずに一連の流れをテストできます。料金は料金ページに掲載しています。

よくある質問

セネガルにはどの国IDを送ればよいですか?

snを送ります。たとえばPOST /api/v1/activationsに{"service": "whatsapp", "country": "sn"}と指定します。

セネガルの番号から取り除くべきトランクプレフィックスはありますか?

いいえ。セネガルにトランクプレフィックスはないので、E.164形式は+221に9桁の国内番号を続けたものになります。

セネガル向けに、アプリのフランス語OTPメッセージを確認できますか?

はい。テストアカウントをフランス語に設定し、サービス用の+221番号を注文して、フランス語のメッセージからパーサーがコードを読み取れることを確認してください。

テスト用に、自分専用のまま使える+221番号は入手できますか?

セルフサービス製品としては提供していません。長期用のDedicated Numbersは米国とカナダのみです。セネガルについては[email protected]までお問い合わせください。

セネガルのコードが届かなかった場合、お金はどうなりますか?

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

OTP Routeでは、セネガルの利用にサブスクリプション料金がかかりますか?

いいえ。月額料金もプランもなく、前払いウォレットから、配信されたコードの分だけお支払いいただきます。

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