プロダクトチームとQAチームのためのバヌアツ(+678)SMS認証

認証が1回だけか、継続する番号か:バヌアツのプロジェクトに合うのはどちらですか?

バヌアツに関する作業の多くは、下の最初の区分に当てはまります。

• 1回分のコード:サインアップを完了する、+678の入力がバリデーターを通ることを証明する、またはオンボーディングのSMSが太平洋のルートに届くことを確認する場合です。これがOTP Gatewayの役割です。
• 使い続けられる番号:繰り返しのログインやサポートデスク向けです。OTP Routeがこうした専用番号をセルフサービスで販売しているのは、アメリカとカナダのみで、月額$1.95からです。

バヌアツにセルフサービスの長期番号はありません。本当に必要なチームは [email protected] にメールできますが、可能かどうかは現地の規則によって決まり、事前にお約束できることはありません。

現在、+678の番号で動作するサービスはどれですか?

バヌアツは小さめのルートで、100を超えるサービスが一覧に載っています。ライブのスナップショットには、WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、Amazon、LinkedIn、AliExpress、Coinbase、Bumble、GitLabが含まれます。

この国の対応状況はよく変わるため、前日のリストを前提にせず、実行のたびに GET /api/v1/countries と GET /api/v1/services(またはダッシュボードの選択画面)を確認してください。サービスが+678で利用できない場合は、フィジーやニューカレドニアなど、近隣の太平洋のルートで同等のテストができるか確認する価値があります。

チームがテストに+678の番号を必要とするのはなぜですか?

バヌアツは、太平洋の島々のユーザー向けに作られたアプリ、訪問者や現地の事業者から予約を受け付ける旅行・ホスピタリティのプラットフォーム、そしてバヌアツ、オーストラリア、ニュージーランドの間を行き来する家族や労働者が使うサービスにとって重要です。こうした層のいずれかが+678番号でサインアップできるなら、認証ステップをそうした番号でテストしておく必要があります。

ビスラマ語、英語、フランス語はいずれも公用語です。グローバルなサービスは通常、アカウントや端末のロケールに従って英語またはフランス語でコードを送るため、ご自身が提供する言語で自社のテンプレートが正しく読めるか確認し、SMSのセグメント長を見積もるときは、アクセント付きのフランス語の文字も考慮してください。

バヌアツの電話番号はどう整形して保存しますか?

バヌアツの番号は、トランク接頭辞のない7桁なので、E.164形式は +678 に加入者番号をそのまま続けたものです。取り除くものは何もありませんが、短い番号は、より長い国内形式を想定したバリデーターでつまずき、+678なしで入力された7桁から誤った国を推測してしまうフォームライブラリもあります。1つの正規のE.164文字列を保存し、国番号は明示的に必須とするか推定し、検証テストには+678のフィクスチャを含めてください。

バヌアツ OTP APIを呼び出しごとにたどる

Developerコンソールでキー(Bearer、or_live_ で始まる)を生成し、リクエストを https://otproute.com/api/v1 に送ります。

1. GET /api/v1/prices?country=vu&service=gitlab は、その組み合わせのライブ価格を返します。
2. POST /api/v1/activations に {"service": "gitlab", "country": "vu"} を送ると、番号が確保され、アクティベーションidが返ります。
3. GET /api/v1/activations/{id} はステータスと、届いた後のコードを報告します。代わりに、Webhookエンドポイントが activation.sms_received を受け取ることもできます。
4. バヌアツのテストを中止する場合は、POST /api/v1/activations/{id}/cancel で番号を早めに返却します。

署名付きWebhookには t=<unix>,v1=<hex> の形で X-OTPRoute-Signature が付いています。エンドポイントのシークレットで <t>.<raw body> のHMAC-SHA256を検証し、古いタイムスタンプは破棄してください。コードでフォールバックのルートを選ぶ方法は、国別のOTPルーティングのノートで説明しています。1アカウントにつき、キー10個、Webhookエンドポイント5つ、1分あたり300リクエストを利用でき、詳しくは開発者ドキュメントにあります。

バヌアツの認証用番号をダッシュボードで使う

チーム全員がコードを書くわけではありません。ダッシュボードでは、バヌアツを選び、サービスを選び、料金を確認して注文し、対象のアプリに+678の番号を入力してSMSをリクエストします。コードは注文カードに表示されます。これらはすべて20分のウィンドウ内に行われ、その後に番号は解放されます。

バヌアツからまだコードが届かない場合は、何を試すべきですか?

まず、20分をフルに待ってください。注文が空のままなら、サービスが仮想番号を受け付けていないか、そのときルートがたまたま静かなだけかもしれません。時間をおいて再試行するか、別のサービスルートに切り替えてください。ループで素早く再注文するのはやめましょう。SMSが届かないままウィンドウが閉じた場合、またはキャンセルした場合は、全額が自動的にウォレットに戻ります。

ウォレットは月額料金のないUSDのプリペイドで、カードまたはUSDT/USDCでチャージすると、そのたびにPDFの請求書が届きます。開発用アカウントにリクエストに応じて提供されるサンドボックスモードでは、模擬のコードでフローをリハーサルできます。いつものとおり、各サービスの規約と当社の利用規定(Acceptable Use Policy)に従ってください。現在の料金は料金をご覧ください。

よくある質問

海外から、バヌアツの番号でテストアカウントを認証できますか?

はい。+678の番号はオンラインで注文され、コードはダッシュボードに表示されるかAPIに送られるため、現地のSIMは関係しません。

バヌアツのAPIリクエストには、どの国コードを入れますか?

countryフィールドには vu を使い、サービスid(gitlab や whatsapp など)を併せて指定します。

バヌアツは、0のようなトランク接頭辞を使いますか?

いいえ。番号はトランク接頭辞なしでダイヤルする7桁で、国際的には+678にその桁数を続けて書きます。

バヌアツは、大きな国より表示されるサービスが少ないのはなぜですか?

小さなルートは対応範囲が狭く、頻繁に変わります。APIやダッシュボードでライブのリストを確認し、サービスがない場合はフィジーなど近隣のルートを検討してください。

コードが届かなかった場合、課金されますか?

いいえ。届かなかったか、キャンセルしたアクティベーションは、ウォレットに自動で返金されます。

チームは、サポート通話用にバヌアツの番号を保持できますか?

セルフサービスのバヌアツの長期回線はありません。専用番号はアメリカとカナダ向けにのみ販売されており、それ以外のご要望は [email protected] へどうぞ。

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