チームの誰も+32のSIMを持たないときのベルギー向け登録テスト

リリース対象はベルギーなのに、テスト端末はすべて海外のもの

よくある場面です。プロダクトは本拠地の市場では動いていて、次のロードマップはベルギー。そこでQAリードは、テスト用の端末がすべて海外のSIMだったことに気づきます。ブリュッセルにいる同僚の携帯を借りれば一度は済みますが、その人の個人番号がステージングアカウントに残ってしまい、回帰テストスイートは相変わらず無人では動かせません。

OTP Routeは、OTP Gatewayでこのボトルネックを取り除きます。サービスとベルギーを選ぶと、ちょうど1回分の認証コードのための+32番号が得られ、コードはダッシュボードまたは自社のコードから読み取れます。誰かの私用の番号がテスト用ログインに紐づくことはなく、同じ手順を夜間のパイプラインでも実行できます。既存のテスト計画に組み込む方法は、QAテストガイドで紹介しています。

現在、+32番号にコードを配信できるサービスは?

ベルギーのルートは現在、1,700を超えるサービスを掲載しています。最新のスナップショットで人気のものには、WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、LinkedIn、Microsoft & Outlook、Amazon、Uber、Signal、Viber、Netflix、Airbnb、eBayがあります。

在庫は日中に変動するため、Webページ上の一覧はどれもスナップショットとして扱ってください。連携では、フィクスチャにサービス一覧をハードコードするのではなく、番号が必要になった時点で、利用可能なものをAPIに問い合わせるようにしてください。

ベルギーのOTPルーティングを自動テストに組み込むには?

すべては https://otproute.com/api/v1 に対し、Developerコンソールで生成した or_live_ で始まるBearerキーで行います。1アカウントに最大10個のキーを持てるため、ステージング、CI、ローカルのノートパソコンに別々の認証情報を割り当てやすく、レート制限は毎分300リクエストです。

1. GET /api/v1/services と GET /api/v1/countries を取得してキャッシュします。ベルギーのIDは be です。
2. 実行で費用が発生する前に、GET /api/v1/prices?country=be&service=linkedin で現在の価格を確認します。
3. POST /api/v1/activations に、ボディ {"service": "linkedin", "country": "be"} を送って注文を作成します。レスポンスには、アクティベーションIDと、登録フォームに入力する+32番号が含まれます。
4. ベルギー向けのテストを activation.sms_received イベントでブロックさせるか、負荷をかけすぎないように GET /api/v1/activations/{id} をポーリングします。
5. テストが中止された場合は、POST /api/v1/activations/{id}/cancel を呼び出し、資金をすぐに戻します。

Webhookの配信には X-OTPRoute-Signature: t=<unix>,v1=<hex> が付いています。エンドポイントのシークレットで "<t>.<raw body>" のHMAC-SHA256を計算し、定数時間で比較し、タイムスタンプが古いリクエストは破棄してください。すべてのフィールドはAPIリファレンスに載っています。

書式の違いでテストが壊れないよう、+32番号はどう保存すべき?

ベルギー国内では、携帯番号は先頭にトランクの 0 を付けて、通常04xxの後に6桁を続けて書かれ、人々はスペース、スラッシュ、ドットで区切ります。国際形式では 0 が消えて +32 に置き換わるため、04xxは+32 4xxになります。ヨーロッパから海外にダイヤルするための 0032 プレフィックスを入力するユーザーもいます。

区切り文字のない正規のE.164文字列をひとつ保存し、3種類の入力形式すべてを電話番号欄に与えて、同じ保存値になることを期待するテストを書いてください。この1つのチェックで、ベルギーの顧客の目に触れる前に、驚くほど多くのオンボーディングのバグを見つけられます。

言語も重要です。オランダ語、フランス語、ドイツ語が公用語で、SMSのコードは、送信するサービスが選んだ言語、多くはアプリや端末の設定に基づく言語で届くのが普通です。オランダ語のインターフェースで一度、フランス語で一度フローを実行すれば、パーサーが英語の文言に依存していないことを確認できます。

ベルギーのコードが届かなかった場合は?

各アクティベーションは20分間有効で、課金されるのはSMSが届いたときだけです。有効時間が空のまま終了した場合、またはその前にキャンセルした場合は、全額が自動的にウォレットへ戻り、Webhookに activation.expired または activation.cancelled が届きます。

コードが来ないとき:

• 数秒でキャンセルせず、有効時間を最後まで待ちます。送信が遅いサービスもあります。
• サービスが仮想番号をそもそも受け付けるか確認します。拒否するサービスもあり、まさにそのために返金があります。
• 後で再試行するか、テストケースに合う別のサービスルートを試します。
• 短い間隔のループで再注文せず、バックオフと再試行回数の上限を設けます。

リトライの設計については、OTP配信失敗を減らすの記事でさらに詳しく扱っています。

サポートや運用チームは、コードを書かずに+32番号を注文できる?

はい。APIに触れない人のために、ダッシュボードで同じフローを行えます。

1. メールアドレスと6桁のメールコード、またはGoogleサインインでサインアップし、TOTP二要素認証を有効にします。
2. ウォレットに資金を追加します。
3. ベルギーとサービスを選び、画面に表示された価格を確認して確定します。
4. 認証するアプリに+32番号を入力し、ダッシュボードでコードを待ちます。

これは、クライアントのベルギーのビジネスプロフィールを登録する代理店や、エンジニアリングにチケットを出さずに1回の認証が必要な運用リードに向いています。

ベルギーの永続的な回線はある?課金の仕組みは?

ベルギーにはセルフサービスの長期番号はありません。専用番号は米国とカナダ向けの製品で、月額$1.95からです。ベルギーの固定回線が必要な場合は [email protected] にメールで問い合わせてください。提供の可否は現地の規制によるため、保証はありません。

課金は、月額料金もプラン選択もない、前払い・従量課金のUSDウォレット1つです。ベルギーのテスト費用はカードまたはUSDT/USDCでチャージでき、チャージ後に経理チーム向けのPDF請求書がメールで届きます。連携の作業では、リクエストにより開発アカウントをサンドボックスに切り替えられ、シミュレートされた番号とコードで、ウォレット資金を使わずにコードを試せます。詳細は料金ページにあります。

ベルギーの番号は、自社の製品と正当なアカウントにのみ使用し、各サービスの利用規約を守り、OTP Routeの利用規定(Acceptable Use Policy)が適用されることにご留意ください。

よくある質問

現地SIMを買わずに、ベルギーのオンボーディングフローを確認できますか?

はい。テスト対象のサービス用に+32番号を注文し、登録フォームに入力して、ダッシュボードまたはAPIでコードを読み取ってください。

APIでベルギーに使う国IDは何ですか?

ベルギーは be なので、典型的なリクエストは、{"service": "whatsapp", "country": "be"} を付けた POST /api/v1/activations になります。

ベルギーの認証用番号はいくらかかりますか?

+32のコードは$0.20/コードからで、選ぶサービスによって金額が変わります。注文前に GET /api/v1/prices を呼び出すか、ダッシュボードで正確な金額を確認してください。

+32のコードが届かなかった場合も課金されますか?

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

データベースはベルギーの携帯番号の先頭の0を保持すべきですか?

代わりにE.164形式で保存してください。トランクの 0 が取り除かれ、+32 で始まります。ユーザーが入力したものは、保存前にその形式へ正規化してください。

後のログイン用に、同じベルギーの番号を保持できますか?

いいえ。OTP Gatewayの各番号は1回のコードに対応します。長期の専用番号は米国とカナダのみで提供されています。ベルギーについては [email protected] にメールで問い合わせてください。

ウォレット資金を使わずに連携を構築する方法はありますか?

開発アカウントをサンドボックスに切り替えるよう依頼してください。エンドツーエンドのテスト用に、シミュレートされた番号とコードが返ります。

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