QAと地域展開のためにジョージアの+995 SMSコードを受信する

国としてのジョージアは、なぜテスト計画でつまずきやすい?

最初の驚きは名前です。国としてのジョージアは、米国の州と同じ名前なので、フォームのライブラリ、分析のフィルター、さらにはチームメイトまでもが両者を取り違えます。APIでの国IDはISOコードのGEに対応する ge、国番号は+995です。誰かが検索ボックスに「Georgia」と入力したせいで、テストが黙って米国の+1番号を選んでしまうようなバグは、早期に見つける価値があります。

2つ目は文字です。ジョージア語は独自のアルファベットであるムヘドルリ文字を使い、GSM 7ビットの文字セットの外にあります。ジョージア語の文字を含むSMSはすべてUnicodeで送信されるため、1セグメントに入る文字数が減り、長いメッセージはより早く分割されます。自社プロダクトがジョージア語のメッセージを送る場合は、まさにそれがローカライズのQAで確認すべき点です。

正しく保存された+995番号はどのような形?

国内では、加入者番号の前にトランクプレフィックスの0を付けてダイヤルしますが、国際形式ではその0は消えます。携帯番号は9桁で5から始まるため、E.164形式は +995 に、5で始まる9桁を続けたものです。

ジョージアの入力を正規化する実践的な手順は次のとおりです。

• ユーザーが習慣で入力するスペース、ドット、ハイフンを取り除きます。
• 値が0で始まり10桁の場合は、0を取り除いて +995 を付けます。
• 995 で始まりプラス記号がない場合は、プラスを付けます。
• プラスの後ろが12桁にならないものは拒否します。

保存する形式を1つの正規形に統一すれば、テストが入力した番号と、バックエンドが後で照合する番号が一致します。

ジョージアのどの認証フローを検証できる?

ジョージアの現在のスナップショットには、WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、X (Twitter)、ChatGPT (OpenAI)、Claude、Microsoft & Outlook、Discord、LinkedIn、Viberが表示されており、カタログ全体では1,500を超えるサービスに及びます。

ここでテストするチームには、いくつかのよくある理由があります。南コーカサスに進出するプロダクト、トビリシのリモートチームが地域のビジネスアカウントを認証する場合、あるいはジョージア語のテキストが登録画面で正しく表示されるかを確認するローカライズの確認です。利用可否は一日の中で動くため、テスト用に+995番号を確保する前に、昨日の一覧を信用せず、APIに問い合わせてください。OTPルーティングは、その時点で利用できるものから選びます。

ジョージアのOTP APIの呼び出し順序はどうなる?

すべての呼び出しは https://otproute.com/api/v1 に対し、or_live_ で始まる Bearer キーで行います。1アカウントにつき最大10個のキーを持てるので、ステージングと本番を分けておけます。

1. GET /api/v1/countries を一度取得して、ID ge を確認します。
2. GET /api/v1/prices?country=ge&service=<id> を呼んで、今日の価格と利用可否を読み取ります。
3. {"service": "whatsapp", "country": "ge"} のような本文で、POST /api/v1/activations を送って注文します。
4. テスト対象のアプリに+995番号を入力し、SMSのステップをトリガーします。
5. GET /api/v1/activations/{id} からコードを読み取るか、Webhookに配信させます。
6. シナリオが中止された場合は、POST /api/v1/activations/{id}/cancel で注文を解放します。

毎分300リクエストという上限は、複数の並列ジョブで数秒ごとにポーリングするのに十分な余裕があります。

+995のコードは、ポーリングとWebhookのどちらで受け取るべき?

どちらも同じSMS認証APIを使い、ノートPCからジョージアのSMS OTPを受信したい開発者1人なら、ポーリングで十分です。CIではWebhookのほうが穏やかです。Developerコンソールで最大5つのエンドポイントを登録し、activation.sms_received、activation.expired、activation.cancelled を購読してください。

すべてのリクエストを検証します。X-OTPRoute-Signature ヘッダーには t=<unix>,v1=<hex> が入っています。エンドポイントのシークレットで <t>.<raw body> のHMAC-SHA256を計算し、定数時間で比較して、タイムスタンプが古いリクエストは破棄してください。結果はアクティベーションIDをキーに保存し、再配信されても影響が出ないようにします。実際のパターンは、Webhookによるコード取得の解説にあります。

ジョージアのコードが届きません。何を試すべき?

まず、20分の有効時間を最後まで待ってください。何も届かなければ、注文は自動的に返金されます。次に、そのサービスがジョージアのアカウントで仮想番号を受け付けるかを検討してください。受け付けないサービスもあります。後で再試行するか、同じテストを別のサービスルートで実行すると、一時的な落ち込みが解消されることがよくあります。避けるべきなのは、短い間隔で新しい注文を繰り返すことです。時間を浪費するうえ、受信側のプラットフォームに不審に見えます。

長期番号、課金、サンドボックス

OTP Routeは、セルフサービスの長期ジョージア番号を販売していません。専用回線は米国とカナダのみで、月額$1.95からです。継続的な+995回線について問い合わせるには、[email protected] に書いてください。回答は現地の規制次第です。

ウォレットはUSDの前払いで、サブスクリプションはありません。カードまたはUSDT/USDCで入金すると、そのたびにPDFの請求書が届きます。ご依頼により利用できるサンドボックスアカウントは、連携テスト用にシミュレートされた番号とコードを返します。開始するには、料金をご覧になるか、アカウントを作成してください。

よくある質問

米国の州ではなく、国としてのジョージアの番号を確実に取得するには?

API呼び出しでは国ID ge を使い、ダッシュボードでは国番号+995を確認してください。米国の州に、独自の国IDはありません。

現地のSIMカードなしで、ジョージアの登録フローをテストできますか?

はい。+995プレフィックスのOTP Gateway番号がコードを受信し、ダッシュボードまたはAPIで読み取れます。

ジョージアの携帯番号を保存するとき、先頭の0は残しますか?

いいえ。0は国内のトランクプレフィックスです。番号は、+995に5で始まる9桁を続けた形で保存してください。

ジョージア語のSMSメッセージは、1セグメントあたりの文字数が少なく見えるのはなぜですか?

ジョージア語の文字はGSM 7ビットのアルファベットの外にあるため、メッセージはUnicodeエンコードを使い、1セグメントに入る文字数が減ります。

ジョージアの認証用番号の価格はいくらですか?

1コード$0.20からで、サービスによって異なります。リアルタイムの価格は GET /api/v1/prices から得られ、注文前にダッシュボードにも表示されます。

プラットフォームが番号を拒否した場合、課金されますか?

いいえ。20分の有効時間内にSMSが届かなかった場合、またはキャンセルした場合は、全額がウォレットに戻ります。

+995の番号には、どのような使い方が認められていますか?

自社プロダクトのテスト、QAの自動化、自社のビジネスアカウントの運用です。各サービスの利用規約とOTP RouteのAcceptable Use Policyに従ってください。

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