日本語
グアドループ +590 番号で行うフランス領カリブのサインアップテスト
OTP Route は、OTP Gateway の一時的な番号でグアドループ（+590）の認証コードを受信し、各 SMS をダッシュボードと、API ポーリングまたは署名付き Webhook 経由の自社バックエンドに届けます。料金は 1 コード $0.20 からで、20 分以内に SMS が届かなかった注文は全額返金されます。
グアドループの認証番号が必要なのは誰か？
グアドループはフランスの海外地域・県で、EU の一部でもありますが、独自の国番号 +590 を持っています。フランス本土のフランスでローンチしたチームは、オンボーディングが海外のユーザーを不適切に扱っていることに、後になって気づくことがよくあります。+33 しか選べない国メニュー、その形式を拒否するバリデーター、そこへルーティングされない SMS の送信元などです。プロダクトチーム、フランス語の QA、アンティル諸島に対応するサポート運用は、+590 のテスト用番号を使って、顧客が気づく前にそうした穴を見つけます。
+590 番号は E.164 でどう書くか？
国内では、番号は 10 桁で、トランクプレフィックスの 0 で始まります。固定回線は 0590 で始まり、携帯は通常 0690 または 0691 で始まります。E.164 ではゼロが消え、結果が二重になったように見えます。固定回線は +590590XXXXXX、携帯は +590690XXXXXX になります。
+590 はサン・バルテルミー島とフランス領サン・マルタンも含むため、国番号だけでは地域が分からない点に注意してください。完全な E.164 文字列を保存し、プロダクトで必要なら地域を別のフィールドとして保持し、ユーザーが国内形式を入力した場合は、トランクの 0 を取り除いてください。
フランス語の QA は、+590 のフローで何を確認すべきか？
グアドループの認証番号は、アンティル諸島の顧客が実際に使うルートで、オンボーディングのフランス語版をエンドツーエンドで実行する、手軽な方法です。1 回の実行でカバーしておきたい項目は次のとおりです。
- 国選択がグアドループを名前で表示して +590 を事前入力し、ユーザーにフランスを選ばせていない。
- 電話番号欄が国内形式の
0690と国際形式の両方を受け付け、同じ値として保存する。 - コード入力画面、再送タイマー、エラーメッセージ周りのフランス語の文言が、レイアウトに収まり、アクセントも保たれている。
- コードの有効期限やレート制限のような、タイムゾーンに依存するロジックが、パリより数時間遅れているユーザーに対して正しく動く。
マルティニークにも対応しているチームは、両地域が言語と番号体系の多くを共有しているため、同じチェックリストを再利用できます。
グアドループにコードを送れるサービスは？
現在人気のあるルートには、WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、ChatGPT (OpenAI)、Claude、Microsoft & Outlook、Amazon、Snapchat、Signal、Viber、Airbnb があります。OTP Gateway は、ここで合計 800 を超えるサービスに対応しており、提供状況はライブなので、実行のたびに問い合わせてください。この地域のコードは、ほとんどがフランス語で書かれています。グアドループ・クレオール語も広く話されていますが、認証テキストで使われることはまれです。
グアドループの OTP API はどう呼び出すか？
https://otproute.com/api/v1 に対して、or_live_ で始まる Bearer キーを使います（キー最大 10 個、Webhook エンドポイント 5 個、1 分あたり 300 リクエスト）。国 ID は gp です。GET /api/v1/prices?country=gp&service=instagram でルートの価格を確認し、POST /api/v1/activations に {"service": "instagram", "country": "gp"} を送って注文を開き、activation.sms_received を待つか、GET /api/v1/activations/{id} をポーリングします。キャンセルは POST /api/v1/activations/{id}/cancel で行い、長いバッチの前には GET /api/v1/balance を確認して、スイートが途中で止まらないようにします。
X-OTPRoute-Signature（エンドポイントのシークレットを使った <t>.<raw body> の HMAC-SHA256）を検証し、古いタイムスタンプは拒否してください。詳細は、OTP Webhook の保護の記事で紹介しています。CI については、パイプラインでの SMS OTP テストをご覧ください。
ダッシュボードにコードが表示されなかったら？
開発者でない方も、ブラウザーで同じように注文できます。OTP Gateway を開き、グアドループとサービスを選び、価格を確認して、番号をコピーします。SMS は注文カードに表示されます。各注文は 20 分間有効で、コードは 1 件を扱います。何も届かない場合、またはキャンセルした場合は、全額がウォレットに戻ります。
配信にかかる時間はサービスとルートによるため、失敗と判断する前に、注文に時間を与えてください。ルートが沈黙したままなら、時間をおいて、または別のサービスルートで再試行し、サービスが仮想番号を受け付けるかを確認し（拒否するものもあり、それが自動返金の理由です）、テストランナーから短い間隔で再注文を繰り返すのは避けてください。さらに確認すべき点は、OTP 配信失敗を減らす方法の記事に挙げています。これらの番号は、自社のプロダクトとアカウントにのみ、各サービスの利用規約と OTP Route の利用規定（Acceptable Use Policy）に沿って使ってください。
長期回線、ウォレット、サンドボックス
グアドループには、セルフサービスの長期番号はありません。専用番号（Dedicated Numbers）は米国とカナダ向けのプロダクトで、月額 $1.95 からです。それ以外については [email protected] にメールしてください。提供可否は現地の規則によります。請求は、月額料金なしのプリペイド USD ウォレット 1 つで、カードまたは USDT/USDC でチャージし、PDF 請求書が発行されます。開発用アカウントはサンドボックスに切り替えて、シミュレートされた番号とコードを利用できます。詳細は料金ページをご覧ください。
よくある質問
島に行かなくても、アプリのグアドループ向けサインアップを確認できますか？
はい。OTP Gateway の +590 番号がコードを受信し、それをダッシュボードまたは Webhook で読み取ります。
OTP Route はグアドループにどの国 ID を使いますか？
gp を使います。たとえば POST /api/v1/activations に {"service": "whatsapp", "country": "gp"} を送ります。
グアドループの携帯番号に 590 が 2 回含まれるのはなぜですか？
通常は含まれません。携帯は +590690… のようになります。+590590… と二重になるのは固定回線で、国内の 0590 がトランクのゼロを取り除いた後も数字を保つためです。
+590 は、常にグアドループを意味しますか？
いいえ。サン・バルテルミー島とフランス領サン・マルタンも国番号を共有しているため、必要な場合は地域を別に記録してください。
グアドループの SMS OTP はいくらですか？
サービスにより 1 コード $0.20 からです。ライブ価格は GET /api/v1/prices から取得でき、注文前に表示されます。
認証テキストは何語ですか？
通常はフランス語ですが、アカウントの言語設定と送信元のテンプレートによって決まります。文章ではなく数字を解析してください。
+590 番号を、今後のログインのために保持できますか？
セルフサービスではできません。Gateway の番号は 1 件のコード用で、長期の専用番号は米国とカナダでのみ提供されています。
これは、プラットフォームに多数のアカウントを登録するためのものですか？
いいえ。OTP Route は、自社の認証フローのテストと、自社の正当なアカウントの運用のためのものです。各サービスの利用規約と当社の利用規定（Acceptable Use Policy）が適用されます。
サービス名はそれぞれの所有者の商標です。OTP Route はこれらの企業と提携していません。番号は合法的にご利用いただき、各サービスの利用規約および当社の利用規定に従ってください。