日本語
ガンビア向け +220 認証番号の実践ガイド
OTP Route では、OTP Gateway から番号を注文することでガンビア（+220）の認証コードを受信でき、SMS はダッシュボード、または API と署名付き Webhook で読み取れます。料金は 1 コード $0.20 からです。各アクティベーションは 20 分間有効で、コードが実際に届いたときだけ課金されます。
エンジニアが知っておくべきガンビアの番号体系は？
ガンビアの国番号は +220 で、トランクプレフィックスはなく、国内形式と国際形式の違いは国番号の有無だけです。加入者番号は 7 桁 なので、完全な E.164 文字列は +220 に 7 桁を続けたものになります。
データをきれいに保つための習慣をいくつか挙げます。
- ユーザーテーブルには、正規化した E.164 形式だけを保存する。
- 入力時にスペースとハイフンは取り除くが、先頭の数字は削らない。取り除くべき 0 がないためです。
- 国選択を、"Gambia" でも "The Gambia" でも検索できるようにする。ユーザーはどちらでも入力するため、片方しか一致しない選択肢は、サポートへの問い合わせの種になります。
国のほぼ全域がセネガルに囲まれているため、ジオロケーションや IP ベースの既定値が、ガンビアの訪問者に +221 を事前選択していないか確認してください。
ガンビアの OTP メッセージは何語で届くのか。エンコーディングが重要なのはなぜか？
公用語は英語なので、グローバルなアプリからの認証テキストの多くは英語で届きます。日常ではウォロフ語、マンディンカ語、フラ語が広く話されています。自社プロダクトで SMS テンプレートをウォロフ語にローカライズする場合は、エンコーディングに注意してください。ë のような文字は GSM-7 のアルファベットに含まれず、メッセージ全体が UCS-2 になって、1 セグメントが 160 文字から 70 文字に減ります。ローカライズしたテンプレートが長いと複数に分割されるため、切り詰められても残るよう、コードはメッセージの先頭近くに置いてください。
プロダクトチームがガンビアでテストや運用をするのはなぜか？
市場は小さくても、ユースケースは具体的です。送金やフィンテックのアプリは、英国、米国、欧州大陸に多くのディアスポラを抱えており、海外の送金者が +220 番号の受取人をオンボーディングできることを示す必要があります。大西洋岸の観光事業者は、ゲストやスタッフを認証します。西アフリカ全体に展開するプロダクトは、利用者の重なりが大きいため、ガンビアをセネガルと一緒にテストすることが多くあります。
+220 のテスト用番号があれば、フォームが番号を受け付けるか、プロバイダーがそこへルーティングするか、受け取る側の人がコードを読めるかという全経路を確認できます。チームがこれをリリース確認に組み込む方法は、QA テストのページで紹介しています。
現在、+220 番号にコードをルーティングするサービスは？
ガンビアのルートには 1,000 を超えるサービス が掲載されています。ライブのスナップショットで人気のあるものは、WhatsApp、Facebook、Telegram、Google (Gmail & YouTube)、Instagram、TikTok、X (Twitter)、ChatGPT (OpenAI)、Microsoft & Outlook、Amazon、Discord、Snapchat、LinkedIn、Signal、imo です。
提供状況は一日の中で変わるため、このリストは目安として扱い、テストスイートに前提を固定で書き込まず、実行の前に gm のルートを確認してください。
API でガンビアの SMS OTP コードを受信するには？
or_live_ で始まる Bearer キーで https://otproute.com/api/v1 に対して認証します。まず GET /api/v1/prices?country=gm&service=whatsapp を呼んで、その組み合わせが開いているか、いくらかを確認します。次に POST /api/v1/activations に {"service": "whatsapp", "country": "gm"} を送ってアクティベーションを作成します。レスポンスには番号とアクティベーション ID が含まれるので、テストケースに紐づけて記録してください。
フローが SMS を送信すると、activation.sms_received Webhook がエンドポイントに届きます。X-OTPRoute-Signature ヘッダー（タイムスタンプ、ドット、生のボディをエンドポイントのシークレットで署名した HMAC-SHA256）を検証し、古いタイムスタンプのリクエストは破棄してください。エンドポイントを公開したくない場合は、GET /api/v1/activations/{id} をポーリングします。未使用のアクティベーションは POST /api/v1/activations/{id}/cancel でキャンセルします。上限は、1 アカウントあたり 1 分 300 リクエスト、キー 10 個、Webhook エンドポイント 5 個です。このガンビア OTP API のフローについては、開発者ページと Webhook でのキャプチャガイドに詳しい説明があります。
開発者以外の方も、ダッシュボードから同じことができます。OTP Gateway を開き、ガンビアとサービスを選び、価格を確認して注文し、アクティベーションにコードが表示されるのを待ちます。
コードが +220 番号に届かなかったら？
アクティベーションの有効期間は 20 分 です。その間に SMS が届かない場合、またはキャンセルした場合は、全額が自動的にウォレットに戻るので、コードを受け取れなくても費用はかかりません。
コードが遅れているときは、行動する前に有効期間いっぱいまで待ってください。そのサービスが仮想番号を受け付けるかも確認してください。受け付けないサービスもあります。そのうえで、時間をおいて、または別のサービスルートで再試行します。スクリプトでは、新規注文を矢継ぎ早に出すのではなく、試行の間にバックオフを入れてください。連続で注文しても、在庫を消費するだけで配信は改善しません。
ガンビアの長期回線は取得できるか。支払いはどうなっているか？
OTP Route には、ガンビアのセルフサービスの長期番号はありません。更新されている間保持できる専用番号（Dedicated Numbers）は、米国とカナダのみで、月額 $1.95 からです。+220 の長期回線が必要な場合は [email protected] にメールしてください。可否は現地の規則によります。
アカウントはプリペイドの USD ウォレット 1 つで動きます。従量課金でサブスクリプションはなく、チャージはカードまたは USDT/USDC、チャージのたびに PDF 請求書がメールで届きます。開発者はサンドボックスモードを依頼でき、シミュレートされた番号とコードで、エンドツーエンドの OTP ルーティングのテストができます。番号は、自社の正当なアカウントとプロダクトにのみ使い、各サービスの利用規約を守ってください。また、OTP Route の利用規定（Acceptable Use Policy）が適用されることをご留意ください。
よくある質問
バンジュールに行かなくても、フィンテックアプリの +220 オンボーディングを確認できますか？
はい。OTP Gateway でガンビアの認証番号を注文し、オンボーディングを実行して、ダッシュボードまたは API でコードを読み取ります。
API リクエストでガンビアの国コードの値は何ですか？
gm で、GET /api/v1/prices と POST /api/v1/activations の両方で使います。
ガンビアの電話番号は何桁ですか？
+220 の国番号の後に 7 桁です。追加も削除も必要なトランクプレフィックスはありません。
ガンビアの SMS 認証にはいくらかかりますか？
1 コード $0.20 からです。サービスごとのライブ価格は API が返し、注文前にダッシュボードにも表示されます。
WhatsApp のコードは、必ずガンビアの番号に届きますか？
いいえ。サービスが特定の番号に送信するかどうかを決めるため、どのルートでも約束はできません。20 分以内に何も届かなければ、料金は返金されます。
ステーブルコインで OTP Route の支払いはできますか？
はい。ウォレットはカード払いのほか USDT と USDC に対応しており、チャージごとに PDF 請求書がメールで届きます。
サービス名はそれぞれの所有者の商標です。OTP Route はこれらの企業と提携していません。番号は合法的にご利用いただき、各サービスの利用規約および当社の利用規定に従ってください。