テスト用Viber SMS認証:ワンタイム番号か、長期回線か

Viberのテストには、ワンタイム番号と保持する回線のどちらを使うべきですか?

アカウントをテストの後も使い続ける必要があるかどうかで決めてください。Viberはアカウントを1つの電話番号に紐づけており、後で新しい端末で再有効化するには、通常、同じ番号で別のコードを受け取る必要があります。テストが登録を1回完了するだけで済む場合(ローカライズ版の確認、地域別サインアップフローの動作確認、QAスクリプトの検証など)は、OTP Gatewayの番号で十分です。1つのコードを受け取ったあと、番号は解放されます。

アカウントを使い続ける必要がある場合、たとえばQAが毎スプリントで開くステージング用プロフィールや、チームで共有するサポート用のIDには、手元に残る番号のほうが適しています。それが専用バーチャル番号(Dedicated Virtual Numbers)の役割です。米国とカナダで即時に利用でき、月額$1.95から。受信SMSはダッシュボードに表示され、number.sms_receivedWebhookに転送されます。それ以外の市場でViberをテストする方には、その国向けのセルフサービスの長期オプションはありません。両者は一時番号と専用番号のガイドで詳しく比較しています。

Viberは電話番号を何に使いますか?

電話番号は、Viberアカウントの識別子です。モバイル端末でサインアップするとき、アプリは番号を尋ね、その番号を管理していることを証明するために有効化コードを送ります。同じ確認は、アプリを再インストールしたときや新しい電話に移行したときにも行われます。Viberのデスクトップアプリはプライマリのモバイルアカウントにリンクするもので、単独では登録しないため、ほとんどのテストで重要になるのはモバイルでの認証の手順です。

Viberはすべての有効化にテキストメッセージを使うわけではなく、番号によっては通話で認証する場合もあります。OTP Gatewayの番号が受け取れるのはSMSで送られたコードなので、アプリが選択肢を示したら、テキストメッセージを選んでください。

Viberのコードを受信できるのはどの国ですか?

viberサービスは現在197か国で提供されています。そのなかには、ウクライナ、ブルガリア、セルビア、ギリシャ、フィリピン、ベトナムのほか、ベラルーシ、モルドバ、ミャンマー、キプロス、クロアチア、イスラエル、ドイツ、イギリス、アメリカが含まれます。このアプリは東欧、バルカン半島、東南アジアの一部で根強い支持があり、多くのローカライズや立ち上げのテストがそこで行われます。

国は、最初に空いているところではなく、テストケースに合わせて選んでください。フィリピンのユーザー向けのプロフィールは、国のデフォルト設定、言語、連絡先の検出が実際の顧客と同じ動きになるよう、フィリピンの番号で登録します。全一覧は国別ページにあり、空き状況は一日の中で変わります。

APIでViberの認証コードをリクエストするにはどうしますか?

すべてのリクエストは、Bearerヘッダーにor_live_キーを付けてhttps://otproute.com/api/v1に送り、Viberについては次の手順で進めます。

1. GET /api/v1/prices?country=ua&service=viberで、選んだ市場の料金を確認します。ここでuaはウクライナです。他のIDはGET /api/v1/countriesで調べてください。
2. POST /api/v1/activationsに{"service": "viber", "country": "ua"}を送って注文します。アクティベーションIDと返された番号を保存します。
3. テスト端末のViber登録画面に番号を入力し、コードを要求します。
4. activation.sms_receivedWebhookでコードを受け取ります。ランナーが外部からの呼び出しを受けられない場合は、数秒おきにGET /api/v1/activations/{id}をポーリングします。
5. テストの経路が変わった場合は、POST /api/v1/activations/{id}/cancelでキャンセルします。

Webhookでは、エンドポイントのシークレットでタイムスタンプ、ドット、生のボディのHMAC-SHA256を計算してX-OTPRoute-Signature(t=<unix>,v1=<hex>)を検証し、古いタイムスタンプは拒否してください。ハンドラーは冪等にします。アクティベーションIDを記録し、処理済みのイベントはスキップします。アカウントの上限は1分あたり300リクエストです。

ダッシュボードからViberのコードを受け取る

手動で作業するQAテスターには、ダッシュボードがコードなしで同じことを実現します。OTP Gatewayを開き、Viberと国を選び、表示された価格を確認して注文します。Viberに番号を入力してコードを要求すると、配信された時点で注文カードに表示されます。20分のウィンドウは決済時に始まり、何も届かないまま終わった場合やキャンセルした場合は、料金がウォレットに戻ります。

Viberのコードが届かないのはなぜですか?

• Viberが番号を拒否した。 多くのメッセージングアプリと同様に、Viberはバーチャル番号を拒否することがあります。コードが届かなければ課金されません。
• 別の認証方法が使われた。 アプリが通話にフォールバックした場合、受け取れるSMSがありません。キャンセルして、テキストを選んでやり直してください。
• ルートが混雑している。 連続して注文し直さず、時間をおいて再試行するか、同じサービスで別のルートを選んでください。
• ウィンドウがまだ終わっていない。 あきらめる前に、アクティベーションを最後まで動かしてください。

再試行の戦略については、失敗するOTP配信を減らすでさらに詳しく説明しています。

責任ある利用、課金、サンドボックス

登録するすべてのアカウントにViberの規約が適用されます。OTP Routeは、自社のプロダクトと事業用プロフィールのテストと運用にのみ使用してください。アカウントは実在する1人または1事業者につき1つとし、大量登録や偽の登録、停止措置の回避は認められません。その他はOTP Routeの利用規定(Acceptable Use Policy)に従います。Viberはその権利者の商標であり、OTP Routeとは提携関係にありません。

支払いは前払いのUSDウォレットから行い、月額料金はありません。カードまたはUSDT/USDCでチャージでき、チャージごとにPDFの請求書が届きます。申請すれば開発アカウントをサンドボックスに切り替えられ、実際の資金を使う前に、テスト用のViber SMS認証を疑似的な番号とコードで実行できます。

よくある質問

アプリのオンボーディングをテストするために、Viber用のバーチャル番号を入手できますか?

はい。対象の国でviberサービスのOTP Gateway番号を注文し、APIまたはダッシュボードで有効化コードを確認します。Viberが一部のバーチャル番号を拒否する場合もありますが、その際は注文が返金されます。

来月も使うテストアカウントには、どのViber用電話番号を使うべきですか?

手元に残る番号を使ってください。専用バーチャル番号は米国とカナダで即時に利用できますが、単発のOTP Gateway番号は、1つのコードを受け取った後に解放されます。

APIでのViberのサービスIDは何ですか?

viberです。国IDと組み合わせて使います。たとえばフィリピンならGET /api/v1/prices?country=ph&service=viberです。

OTP Routeで、Viberのコードを受信できる国はいくつありますか?

このサービスは197か国で提供されていますが、実際の空き状況は一日の中で変わるため、注文前にAPIまたはダッシュボードで確認してください。

ViberがSMSを送ってこなければ、料金を支払う必要がありますか?

いいえ。コードが届かないまま20分のウィンドウが終了した場合や、キャンセルした場合は、全額が自動的にウォレットに戻ります。

ViberのOTP受信には、Webhookとポーリングのどちらを使うべきですか?

基本はWebhookがおすすめです。コードが届いた時点ですぐにシステムが反応できます。署名を検証し、アクティベーションIDで重複を排除してください。ファイアウォールの内側にあるランナーでは、GET /api/v1/activations/{id}のポーリングが確実なフォールバックになります。

OTP Routeで多数のViberアカウントを登録できますか?

Viberの規約と当社の利用規定(Acceptable Use Policy)の範囲内で、実在する個人または自社が代表する事業者のアカウントに限ります。大量登録は認められません。

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