日本語
APIでルーティングする、QA・ローンチチーム向けのチリ認証コード
OTP Routeでは、OTP Gatewayでワンタイム番号を注文し、ダッシュボードでコードを読み取るか、REST APIと署名付きWebhookで取得することで、チリ(+56)のSMS認証コードを受信できます。料金は1コード$0.20 からで、サービスごとの最新の金額はAPIが返します。20分のウィンドウ内にSMSが届かなかった番号は、費用がかかりません。
Gateway番号とDedicated Number、チリのテストにはどちらが必要ですか?
選択のカギは1つの問いです。この+56番号で、あとからもう一度コードが必要になる人はいるでしょうか。登録テスト、1回限りのオンボーディング確認、ビジネスプロフィールの確認といった、チリ向けの作業の大半では、答えはノーで、OTP Gatewayが適しています。番号は1つ、受け取るコードは1通で、作業はそれで終わりです。
手元に残るチリの回線は別のプロダクトで、セルフサービスでは販売していません。OTP RouteのDedicated Numbersは米国とカナダにのみあり、月額$1.95/monthからです。長期にわたる+56回線がチームにどうしても必要な場合は、[email protected] に用途をメールでお知らせください。手配できるかどうかは現地の規制次第なので、答えがノーになりうるものとして計画してください。
- コードが1回だけ必要な場合は、OTP Gatewayを使います。サインアップのリグレッション、チリ向けリリース前のスモークテスト、単発のアカウント確認などです。
- 共有のステージングログインがコードを受け取り続ける必要があり、アカウントにチリの身元が不要な場合は、米国またはカナダのDedicated Numberを使います。
トレードオフについては、一時番号と専用番号の記事でさらに詳しく説明しています。
チリのOTP APIは、注文からコードの受信までどう動きますか?
SMS認証APIは、https://otproute.com/api/v1 配下のシンプルなRESTです。開発者コンソールで作成する、or_live_ で始まるBearerキーで認証します。チリの国IDは cl です。
GET /api/v1/servicesを呼び、テストで使うサービスID(たとえばwhatsappやuber)をキャッシュします。- 費用を決め打ちにせず、
GET /api/v1/prices?country=cl&service=<id>で現在の金額を読み取ります。 {"service": "whatsapp", "country": "cl"}のようなボディを付けて、POST /api/v1/activationsで注文します。レスポンスには、+56番号とアクティベーションIDが含まれます。- その番号を、テスト対象のフローに入力して、SMSを発生させます。
GET /api/v1/activations/{id}をポーリングするか、activation.sms_receivedのWebhookで通知を受けます。- 実行を中止する場合は、
POST /api/v1/activations/{id}/cancelを送り、すぐにウォレットへ返金されるようにします。
Webhookの配信には署名が付いています。X-OTPRoute-Signature ヘッダーには t=<unix>,v1=<hex> が入っており、これはエンドポイントのシークレットを鍵にした <t>.<raw body> のHMAC-SHA256です。手を加えていないリクエストのバイト列に対して再計算し、定数時間で比較して、古いタイムスタンプは破棄してください。また、アクティベーションIDを冪等性キーとして扱えば、繰り返されたイベントが何も変更しません。1アカウントにつき、APIキーは最大10個、Webhookエンドポイントは5つ、リクエストは毎分300回までです。OTP API連携ガイドでは、このループにリトライとエラー処理を加えています。
テスト用の+56番号にコードを送れるアプリは?
チリのルートは現在、1,800を超えるサービスに対応しています。QAチームが特によく使うのは、WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、Uber、Microsoft & Outlook、Amazon、LinkedIn、ChatGPT (OpenAI)、Discord、Netflixなどです。
在庫は一日の中で動くので、この一覧も含め、どの一覧もスナップショットとして扱ってください。スケジュール実行のジョブの前に、GET /api/v1/countries と価格エンドポイントで cl の現在の状況を確認しましょう。組み合わせが見つからないときは、テストスイートの途中でその穴に気づくのではなく、穏やかにスキップするようにします。
+56番号は、どのように保存・検証すべきですか?
チリの携帯番号は、国番号+56の後ろに9桁が続き、9で始まります。そのため、E.164形式の完全な携帯番号は、+569 に8桁を続けた形になります。現在のチリの番号は、国内でも+56の後ろに続くのと同じ9桁で表記されるため、正規化は簡単です。
それでもユーザーは、番号を3通りの方法で入力します。スペースとプラス記号付き、プラスなしで 56 に国内の数字を続けた形、あるいは国内の9桁だけ、です。正規のE.164文字列を1つ保存し、サポートチケット用に元の入力をその隣に残し、3つの形すべてのテストケースを追加してください。8桁の入力をフォームの段階で拒否すれば、届くはずのないSMSを送らずに済みます。
プロダクトチームが、チリのサインアップフローを検証するのはなぜですか?
チリは、中南米に展開するプロダクトが早い段階で立ち寄る市場の1つで、ユーザーは、スペイン向けにローカライズされた文面ではなく、この地域向けに書かれたスペイン語のコピーを期待します。+56番号に送られるコードは通常スペイン語で届きますが、多くのアプリはアカウントのロケールに従うので、周囲の文言にかかわらず、パーサーが数字を抽出できることを確認してください。
チームがチリのチェックを行うそのほかの理由には、地元の訪問者に対して電話番号欄が既定で+56になることの確認、チリの番号で全ルートが動くことの証明、サポートや運用のスタッフが個人のSIMを貸さずに業務用アカウントを確認できるようにすること、などがあります。チームがこれをリリースのチェックリストに組み込む方法は、QAテストのページで紹介しています。
チリのコードが届かないときは?
各アクティベーションは20分間開いたままです。課金されるのはコードが届いたときだけで、何も届かないままウィンドウが閉じた場合や、先にキャンセルした場合は、全額が自動的にウォレットへ戻ります。+56番号が沈黙したままのときは、次の点を試してください。
- テストを失敗とマークする前に、ウィンドウを最後まで待ちます。送信の遅い送信元もあるからです。
- 対象のアプリがそもそも仮想番号を受け付けるかを確認します。ポリシーで拒否するものもあり、返金ルールはまさにそのためにあります。
- 時間をおいて再試行するか、同じシナリオで別のサービスルートに切り替えます。
- 再試行の間隔を空けましょう。数秒おきに新しい注文を出しても、番号を消費するだけです。
さらなるトラブルシューティングのヒントは、OTP配信失敗を減らす方法の記事にあります。
課金とサンドボックステストは、どのように機能しますか?
OTP Routeは、前払い制のUSDウォレット1つで運用されます。従量課金で、月額料金も選ぶべきプランもありません。入金はカードまたはUSDT/USDCのステーブルコインで行え、チャージのたびに、経理にPDFの請求書がメールで届きます。
開発中は、開発用アカウントをサンドボックスに移すよう依頼してください。シミュレートされた番号とコードが返るので、ウォレットの資金に触れずに、チリのフロー全体を試せます。ターミナルを開かない同僚は、代わりにダッシュボードを使えます。チリを選び、サービスを選び、表示された価格を確認して、番号をコピーし、コードが表示されるのを見守ります。
利用は自社のプロダクトとアカウントに限り、各サービスの規約を尊重し、OTP Routeの利用規定(Acceptable Use Policy)が適用されることを忘れないでください。アカウントの作成は数分で済みます。
よくある質問
現地のSIMカードなしで、アプリのチリ向けサインアップをテストできますか?
はい。OTP Gatewayで+56番号を注文し、サインアップフォームに入力して、ダッシュボードまたはAPIでコードを読み取ります。各番号が対応するコードは1通です。
APIでは、チリの国IDは何を指定しますか?
cl を使います。たとえば GET /api/v1/prices?country=cl&service=telegram のようにします。
テスト用の+56番号の料金はいくらですか?
1コード$0.20 からで、正確な金額はサービスによって異なり、APIがリアルタイムで返します。課金されるのは、コードが届いたときだけです。
来四半期にもアカウントにログインできるよう、チリの番号を保持できますか?
セルフサービスではできません。Dedicated Numbersは米国とカナダ向けのプロダクトで、月額$1.95/monthからです。+56の回線については [email protected] にメールしてください。提供できるかどうかは現地の規制次第です。
チリの認証SMSは、何語で届きますか?
通常はスペイン語ですが、多くのアプリはアカウントで選択された言語で送信します。決まった文言に一致させるのではなく、数字を解析してください。
チリのテスト実行には、ポーリングとWebhookのどちらが向いていますか?
単発の手動チェックなら、ポーリングで十分です。複数の実行が並行するようになったら、アクティベーションIDを軸にした署名付きWebhookのほうが、スケールさせやすくなります。
経理部門は、ステーブルコインで支払えますか?
はい。ウォレットはカードとUSDT/USDCに対応しており、チャージのたびにPDFの請求書が届きます。
サービス名はそれぞれの所有者の商標です。OTP Route はこれらの企業と提携していません。番号は合法的にご利用いただき、各サービスの利用規約および当社の利用規定に従ってください。