QA・ローンチチーム向けクウェート認証番号のステップガイド

クウェートのルートは、テストしたい内容に合っている?

まず次の質問に目を通してください。どれか一つでも「はい」なら、+965番号を使う十分な理由になります。

• プロダクトがクウェートの顧客にワンタイムコードを送っていて、実際のメッセージが届くところを確認する必要がある。
• 湾岸地域でのローンチを準備していて、サインアップ画面のアラビア語版と英語版を確認したい。
• 運用チームが、クウェートに紐づくビジネスプロフィールを管理していて、スタッフの個人の番号を渡したくない。
• QAスイートが、すでにカバーしているルートに加えて、OTPの国別ルーティングで説明しているような地域のケースを必要としている。

数か月にわたってメッセージを受信し続ける番号が必要な場合は、下の長期回線のセクションに進んでください。

+965連携の事前チェックリスト

• Developerコンソールで作成した、or_live_ プレフィックスのBearerキー。
• カードまたはUSDT/USDCで追加したウォレットの資金。1つのUSD残高で、すべての国をカバーします。
• 国ID kw と、GET /api/v1/services から取得した正確なサービスID。
• 署名シークレット付きのWebhook URL、またはポーリングのジョブのどちらか。
• 無関係なテスト間で番号を使い回さないよう、コードがどのアカウント向けかを、テスト計画に明記する。
• 対象サービスの利用規約と、OTP Routeの利用規定(Acceptable Use Policy)への同意。

クウェートの番号にコードを送れるサービスは?

クウェートのルートでは現在、1,700を超えるサービスが利用できます。今日のスナップショットで人気のものには、Snapchat、WhatsApp、TikTok、Instagram、X (Twitter)、Telegram、Google (Gmail & YouTube)、Microsoft & Outlook、Amazon、Uber、LinkedIn、Discord、Netflixがあります。

これらの名前は目安であり、保証ではありません。容量は一日の中で変わるため、APIは価格を照会するたびに、リアルタイムの利用可否を返します。

コードから `kw` のアクティベーションを実行するには?

すべての呼び出しは、Authorizationヘッダーにキーを付けて https://otproute.com/api/v1 に送ります。

1. GET /api/v1/prices?country=kw&service=snapchat で、現在の価格と利用可否を確認します。
2. {"service": "snapchat", "country": "kw"} を本文にして POST /api/v1/activations を送り、返されたアクティベーションIDを保持します。
3. テスト対象のアプリに+965番号を入力し、SMSをリクエストします。
4. Webhookで activation.sms_received を処理します。エンドポイントのシークレットで "<t>.<raw body>" のHMAC-SHA256を再計算して X-OTPRoute-Signature を検証し、タイムスタンプが古いリクエストは拒否します。
5. ポーリングを選ぶ場合は、コードが現れるか実行が終わるまで、一定の間隔で GET /api/v1/activations/{id} を読み取ります。
6. 早めに止めるには POST /api/v1/activations/{id}/cancel を呼びます。返金は自動です。

OTP API連携ガイドでは、同じループを再試行とログ付きで紹介しています。アカウントあたり毎分300リクエストの上限の範囲内に収めてください。

運用担当者向けの手動の経路は?

ダッシュボードでOTP Gatewayを開き、国をクウェートに設定し、サービスを選びます。確定する前に価格が表示され、確定した瞬間に番号が表示されます。アプリでそれを使ってSMSをリクエストすると、届いた時点で同じ行にコードが表示されます。アクティベーションは20分間オープンなので、慌てて更新する必要はありません。

+965番号の書式とアラビア語メッセージの扱い

クウェートの番号は8桁で、この国にはトランクプレフィックスがないため、現地の番号をE.164に変換するときに取り除くものはありません。+965 に8桁を続けた形で保存し、スペースと先頭の 00 を取り除き、国内のゼロを前提とした検証ロジックは避けてください。

公用語はアラビア語で、ビジネスや小売では英語も一般的なため、コードはアラビア語または英語のテンプレートの中に入って届くことがあります。アラビア語のテキストはUnicodeで送られるため、SMS 1通あたりの文字数が短くなり、左から右の数字の周りに右から左のテキストが置かれます。コードは、単語で分割するのではなく、数字のパターンで抽出してください。自社プロダクトがOTPメッセージをアラビア語にローカライズしている場合は、テンプレートが西アラビア数字と東アラビア数字のどちらを出力するかを確認し、オートフィルのロジックが送信するどちらにも対応するようにしてください。

クウェートには外国人労働者も多いため、多くのチームが、英語、アラビア語、さらに端末で選択した第三の言語でテストしています。

クウェートの専用回線はある?課金はどうなる?

セルフサービスの長期の+965番号は、現在ありません。Dedicated Numbersは米国とカナダの商品で、月額$1.95から、受信SMS、送信SMS、ブラウザ通話に対応します。恒久的なクウェートの回線については、[email protected] にご連絡ください。回答は現地の規制次第で、確実ではありません。

ウォレットはUSDの前払いで、月額料金もプランもありません。カードまたはUSDT/USDCでチャージでき、チャージのたびにPDFの請求書がメールで届きます。開発アカウントはサンドボックスモードをリクエストでき、番号とコードを模擬するため、CIの実行で費用がかかりません。CIパイプラインでのSMS OTPテストをご覧ください。

よくある質問

クウェートのアクティベーションがコードなしで終わったのはなぜ?

サービスが仮想番号を拒否したか、その時点でルートが混み合っていた可能性があります。時間をおくか別のルートで再試行し、短い間隔での再注文は避けてください。金額はすでにウォレットに戻っています。

クウェートに行かなくても、テスト用の+965番号を取得できる?

はい。OTP Gatewayが、1回のコード用にクウェートの番号をオンラインで発行し、そのコードをダッシュボードまたはAPIで読み取れます。

クウェートの認証番号の費用は?

クウェートのコードは$0.20/コードからで、金額はコードを送るサービスによって異なります。正確な金額は GET /api/v1/prices から取得でき、ダッシュボードでも注文前に表示されます。

クウェートにはどの国IDをコードから送るべき?

価格とアクティベーションのリクエストで kw を使います。

クウェートのフローをテストするサンドボックスはある?

リクエストにより、開発アカウントをサンドボックスに切り替えられ、ウォレットの資金を使わずにエンドツーエンドでテストできるよう、模擬の番号とコードが返されます。

アラビア語のSMSテンプレートはコードに影響する?

数字自体は同じですが、その周りのテキストは右から左のアラビア語になることがあります。単語の位置に頼らず、数字のパターンでコードを解析してください。

1つのクウェートの番号を複数のアカウントで共有してもよい?

各アクティベーションは、1つのアカウントでの1回のコード用です。OTP Routeはご自身のプロダクトと正当なビジネスアカウントにのみ使用し、各サービスの規約に従ってください。

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