ブラジルのSMS認証に使う+55ルートの選び方

ブラジルのテストには、OTP Gateway と長期回線のどちらを使うべき?

まず作業の形から考えましょう。それがプロダクトを決めます。ブラジルでの認証テストは、通常、一度に1コードで足ります。ポルトガル語のサインアップ画面、ログインチャレンジ、電話番号の変更ステップなどです。まさにOTP Gatewayが想定している用途です。サービスとブラジルを選ぶと、1コード用の+55番号が届き、アクティベーションは20分後、またはSMSが届いた時点で閉じます。

長期回線は話が別です。専用番号(Dedicated Numbers)はアメリカとカナダ向けの製品で、ダッシュボードから即時に購入でき、月額 $1.95 から。着信SMS、発信SMS、ブラウザ通話が利用できます。セルフサービスの長期+55番号はありません。 チームが保持できるブラジルの回線が本当に必要な場合は、[email protected] に用途を添えてご連絡ください。可能かどうかは現地の規則によるため、何も約束はできません。

簡単な目安は次のとおりです。

• テストケースごとに1コード、実行のたびに新しい状態:br を指定した OTP Gateway。
• 来月再びログインが必要なステージングアカウント:サービスが受け付けるなら、アメリカまたはカナダの専用番号。
• 迷ったとき:何かを購入する前に一時番号と専用番号の比較を読んでください。

現在、ブラジルの番号にコードを送信できるアプリは?

ブラジルのルートは現在2,900を超えるサービスに対応しており、最新のスナップショットで人気のものには WhatsApp、Telegram、Google (Gmail & YouTube)、Instagram、Facebook、TikTok、Uber、Discord、Microsoft & Outlook、LinkedIn、Netflix、Airbnb、Shopee、AliExpress が含まれます。

このリストは契約ではなくスナップショットとして扱ってください。キャリアパートナーがルートを追加したり入れ替えたりするため、提供状況は日中に変動します。パイプラインはハードコードしたリストを信用せず、APIに問い合わせましょう。ブラウザを好む方には、国ディレクトリで同じ最新データを確認できます。

ブラジルのOTP APIのシーケンスは、実際にはどうなる?

すべての呼び出しは、Developerコンソールで生成した or_live_ 接頭辞のBearerキーを付けて https://otproute.com/api/v1 に送ります。ブラジルの国IDは br です。

1. GET /api/v1/services でサービスIDを一度だけ取得し、設定に保存します。
2. 注文の前に GET /api/v1/prices?country=br&service=whatsapp(または自分のサービスID)を呼び出します。レスポンスには、その組み合わせの最新の料金と提供状況が含まれます。
3. POST /api/v1/activations に {"service": "whatsapp", "country": "br"} のボディを送ってアクティベーションを作成します。アクティベーションIDをテスト実行と対応付けて保存します。
4. テストするフローに+55番号を入力します。
5. Webhookで activation.sms_received イベントを待ちます。フォールバックとして、数秒おきに GET /api/v1/activations/{id} を確認します。
6. テストが中断した場合は POST /api/v1/activations/{id}/cancel で番号を解放し、資金をすぐに戻します。

Webhookの配信は X-OTPRoute-Signature に t=<unix>,v1=<hex> として署名されます。これはエンドポイントのシークレットを使った <t>.<raw body> のHMAC-SHA256です。検証し、古いタイムスタンプは破棄し、ハンドラはアクティベーションIDに対して冪等にしてください。完全なリファレンスはAPIドキュメントにあります。

グロースチームの担当者が、コードなしでこれを行えますか?

はい。ダッシュボードなら、スクリプトなしで同じOTPルーティングを実行できます。

1. メールと6桁のメールコード、またはGoogleサインインでアカウントを作成します。
2. USDウォレットに資金を追加します。
3. ブラジルとサービスを選び、表示された料金を確認して注文します。
4. +55番号をアプリに貼り付け、アクティベーションカードにコードが表示されるのを確認します。

マーケティング、サポート、ローカライズのレビュー担当者は、リリース前にポルトガル語のオンボーディング画面が正しく動作することを確認するためにこの方法をよく使い、エンジニアは自動実行のためにAPIを使っています。

+55番号はどのように保存・正規化すべき?

ブラジルの番号は、2桁の市外局番(DDD)の後に加入者番号が続き、携帯番号は9で始まる9桁です。ブラジル国内では、長距離通話の際に先頭の0とキャリア選択コードをダイヤルするため、ユーザーの入力には、保存すべきでない余分な数字が含まれていることがよくあります。

すべてE.164で保存してください。+55、市外局番、加入者番号の順で、スペース、先頭の0、キャリアコードは含めません。入力時に正規化し、正規化した値で比較し、整形は表示時だけにします。ブラジルの送信元からのコードは通常ポルトガル語、ときには英語で届くため、固定の文章に合致させるのではなく、数字を解析してください。

このマーケットをテストするチームの目的は、ブラジル向けのリリース、ポルトガル語のローカライズQA、そしてブラジルの個人情報保護法(LGPD)に基づく義務と並行して進むオンボーディングフローです。認証の側面については、フィンテックのオンボーディングのページで取り上げています。

ブラジルのコードが届かない場合は?

まず、20分の有効時間が終わるまで待ちましょう。送信が遅い送信元もあり、配信はサービスとルートに依存します。期限が切れると請求は自動的に取り消され、少し時間を置いて、またはAPIが提示する別のルートで再試行できます。

• そのサービスが仮想番号を受け付けるか確認してください。受け付けないサービスもあり、それこそが返金ルールの存在理由です。
• 短時間にループで再注文しないでください。試行の間隔を空け、各アクティベーションIDをログに残します。
• アプリが、トランクの数字を含む現地形式ではなく、完全な国際形式で番号を送信したか確認してください。

OTP配信失敗を減らす方法のガイドに、さらに多くの診断方法があります。

ウォレット、請求書、サンドボックスはどう組み合わさる?

OTP Route は、前払い式のUSDウォレット1つで課金します。従量課金で、月額料金も選ぶプランもありません。カードまたはUSDTかUSDCで入金でき、入金のたびにPDFの請求書がメールで届きます。詳しい料金は料金ページとAPIにあります。

連携作業では、サポートに開発用アカウントのサンドボックスへの切り替えを依頼してください。シミュレートされた番号とコードが返るので、ウォレットの資金に触れずに、アクティベーションとWebhookの経路をエンドツーエンドで検証できます。ご自身のプロダクトにのみ使用し、各サービスの利用規約を守り、利用規定(Acceptable Use Policy)がすべてのアカウントに適用されることにご留意ください。

よくある質問

現地SIMなしで、自社アプリのブラジルのサインアップフローをテストできますか?

はい。ご自身のアプリまたは対応サービス向けに OTP Gateway から +55 番号を注文し、フローに入力して、ダッシュボードまたはAPIでコードを読み取ってください。

OTP Route APIでのブラジルの国IDは何ですか?

br です。アクティベーションを作成するときは country フィールドとして、料金エンドポイントでは country クエリパラメータとして渡します。

WhatsAppが +55 番号にコードを送らなかった場合、課金されますか?

いいえ。20分以内にSMSが番号に届かなかった場合、または先にキャンセルした場合は、全額が自動的にウォレットに戻ります。

ブラジルの番号を購入して、数か月間保持できますか?

セルフサービスの製品としては提供していません。長期の専用番号(Dedicated Numbers)はアメリカとカナダのみです。ブラジルについては [email protected] にメールでお問い合わせいただけますが、提供の保証はありません。

ブラジルの番号の先頭のゼロは保存すべきですか?

いいえ。トランクの0とキャリア選択コードを取り除き、+55と2桁の市外局番で始まるE.164形式で番号を保存してください。

ブラジルの認証メッセージは何語ですか?

ほとんどはポルトガル語で届き、グローバルなサービスの一部は英語の文面を送ります。文面に頼らず、数字のコードを抽出してください。

ウォレットに入金する前にAPIを試せますか?

開発用アカウントでサンドボックスモードを依頼してください。番号とコードがシミュレートされるので、ウォレットの資金を使わずに連携全体をテストできます。

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