テスト、ローンチ、運用のためのカナダ認証コード

チームは現在、カナダのルートで何ができますか?

カナダには2つのプロダクトが対応しています。OTP Gatewayは、認証コード1回分の一時的な+1番号を発行し、サインアップのテスト、リグレッションの実行、1回限りのアカウント設定に向いています。Dedicated Numbersは、更新している間は保持できるカナダの回線で、SMS受信、SMS送信、ブラウザ通話に対応しています。

QA作業の多くはGatewayから始まり、長期にわたるステージング用ログインやサポート回線は、たいてい専用回線に落ち着きます。このトレードオフについては、一時番号と専用番号のガイドで解説しています。

なぜカナダなのか。米国から国境を越えるプロダクトは、カナダ向けの展開に独自のチェックが必要だと気づくことがよくあります。フランス語の画面、州ごとの価格設定、ユーザーが登録した番号に地域のリスクルールを適用するサービスなどです。実際のカナダの認証番号があれば、トロントやモントリオールの顧客に届く前に、電話番号欄からウェルカム画面までの全経路をQAで確認できます。

カナダのゲートウェイ番号にコードを送るアプリは?

カナダのライブリストは現在、3,600を超えるサービスに対応しています。人気のものには、WhatsApp、Telegram、Google (Gmail & YouTube)、Instagram、Uber、Amazon、LinkedIn、Microsoft & Outlook、Discord、Signal、Airbnb、eBay、ChatGPT (OpenAI)などがあります。

利用可否は一日の中で変わります。どの一覧もスナップショットとして扱い、特定のサービスを軸にテストマトリクスを組む前に、APIで最新の選択肢を確認してください。

カナダのOTP APIは、最初から最後までどう動きますか?

リクエストは https://otproute.com/api/v1 に送り、開発者コンソールで作成した or_live_ で始まるBearerキーを付けます。典型的なカナダ向けの実行は、5つの呼び出しで構成されます。

1. GET /api/v1/services と GET /api/v1/countries でIDを解決します。カナダは ca です。
2. GET /api/v1/prices?country=ca&service=<id> で、現在の価格を確認します。
3. {"service": "<id>", "country": "ca"} を付けて POST /api/v1/activations を呼びます。
4. カナダからの activation.sms_received イベントを自社のエンドポイントで待ち受けます。公開URLを持たないスクリプトは、代わりに GET /api/v1/activations/{id} をポーリングできます。
5. テストを早めに中断する場合は、POST /api/v1/activations/{id}/cancel を呼びます。

自社のエンドポイントへの各リクエストには X-OTPRoute-Signature が付くので、HMAC-SHA256を検証し、古いタイムスタンプは破棄してください。より詳しい解説はOTP API連携ガイドにあります。

技術に詳しくない同僚でも、+1のコードを手作業で注文できますか?

はい。サインインしてOTP Gatewayを開き、カナダとサービスを選び、表示された価格を確認して注文します。+1番号がすぐに表示されるので、認証したいアプリに入力すると、コードが同じ画面に届きます。サポート担当やグロース担当のマーケターは、パイプラインではなく1つのアカウントを設定したいときに、この方法を使います。アプリの送信が遅い場合は、キャンセルして再注文するのではなく、ウィンドウが閉じるまで注文を開いたままにしてください。時間をおいてやり直すか、別のサービスルートで試すほうが、たいていは多くの手がかりが得られます。

カナダの+1番号は、どのように保存すべきですか?

カナダは米国と北米番号計画(NANP)を共有しているため、すべての番号は3桁の市外局番と7桁の加入者番号で構成されます。国内では長距離通話の前に先頭の 1 をダイヤルするのが一般的ですが、この数字は国番号と同じです。そのため、E.164形式では +1 に10桁を続けるだけです。

実務上のヒントが2つあります。

• E.164形式で保存し、ローカルの書式はUIでのみ適用します。
• +1 だけから国を推定しないでください。プロダクトがカナダと米国のユーザーを区別して扱うなら、市外局番か、ユーザーが選んだ国を使います。

カナダは公式にバイリンガルなので、多くのサービスはアカウントの言語に応じて、英語かフランス語でコードを送ります。ケベック向けに提供する場合は、両方のテンプレートをテストしてください。

カナダのDedicated Numberが適しているのは、どんなときですか?

同じログインを使い続ける必要があるときは、Dedicated Numberを選びましょう。たとえば、再認証が発生するステージングアカウント、SMSによる復旧を設定した共有チームログイン、カナダのサポート回線などです。ダッシュボードから即時に購入でき、月額$1.95/monthからです。受信メッセージはダッシュボードに表示され、number.sms_received がWebhookに送られます。利用期間は前払い制で、ウォレットから更新され、いつでも解約できます。

カナダのコードは、どのように課金されますか?

月額料金も選ぶべきプランもない、前払い制のUSDウォレット1つですべてをまかなえます。カードまたはUSDT/USDCでチャージでき、チャージや番号購入のたびに、PDFの請求書がメールで届きます。Gatewayの注文はコードが届いたときにのみ課金されるため、失敗した試行でかかるのは時間だけです。Dedicated Numbersも同じ残高から更新されるので、QAの支出とカナダのサポート回線を1つの明細にまとめられます。本番前には、開発用アカウントをサンドボックスに切り替えるよう依頼でき、シミュレートされた番号とコードが返ります。詳細は料金ページをご覧ください。

よくある質問

カナダのSIMなしで、アプリのカナダ向けサインアップフローをテストできますか?

はい。OTP Gatewayで国 ca の+1番号を注文してアプリに入力し、ダッシュボードまたはWebhookでコードを読み取ります。

カナダのアクティベーションは、どのくらいの間開いたままですか?

20分です。そのウィンドウ内にSMSが届かなかった場合、またはキャンセルした場合は、全額が自動的にウォレットへ戻ります。

コードが届かないときは、どうすればよいですか?

ウィンドウが終わるまで待ち、その後、時間をおいてやり直すか、別のサービスルートを試してください。仮想番号を拒否するサービスもあり、短い間隔での再注文はほとんど効果がありません。

カナダの番号を数か月間保持できますか?

はい。月額$1.95/monthからのDedicated Numberなら、ウォレットから更新されて保持できます。Gatewayの番号は、コード1回分専用です。

カナダのDedicated Numberは、発信通話に対応していますか?

ブラウザからの発信通話に加え、SMSの受信と送信に対応しており、アプリやSIMは不要です。

フランス語のコードは、扱いが異なりますか?

いいえ。OTP Routeは、送信されたままのSMSを渡します。サービスが使う言語は、そのまま表示されます。

チームで作成できるAPIキーはいくつですか?

1アカウントにつきキーは最大10個、Webhookエンドポイントは最大5つで、上限は毎分300リクエストです。

番号の使い方には、どのようなルールが適用されますか?

各サービス自身の規約と、OTP Routeの利用規定(Acceptable Use Policy)です。番号は、自社の正当なプロダクトとアカウントのテストや運用に使用してください。

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