開発者とQAチームのためのイタリア(+39)認証番号

イタリアの電話番号がバリデーターにとって厄介なのはなぜ?

イタリアは、多くの正規化ツールが暗黙に前提としているルールを破ります。ヨーロッパの他の国では国番号を付けるときに国内の先頭ゼロを落としますが、イタリアの固定電話はゼロを残します。ローマの番号は +39 06 …、ミラノの番号は +39 02 … と書きます。携帯番号は3から始まり、通常は+39の後ろが10桁で、先頭にゼロはありません。

そのため、国番号の後ろの先頭の0を取り除くライブラリはイタリアの固定電話を壊してしまい、固定長に固執するバリデーターは有効な番号を弾くことがあります。完全なE.164文字列は、+39 に国内番号をそのまま続けた形で保存し、電話番号パース処理のテストにイタリアのケースを加えてください。

イタリア向けQAの実用的なフィクスチャには、少なくとも携帯番号1つ、ローマの固定電話1つ、ミラノの固定電話1つを用意します。3つすべてをパーサー、データベースの往復、表示用フォーマッタに通し、保存された値が入力と同一であることを確認してください。

なぜチームは+39のルートで認証テストを実行するのか?

イタリアはEUでも大きな市場の一つで、プロダクトがヨーロッパの国から次の国へ展開する際によく立ち寄る国です。ローカライズのQAも重要です。この国では認証メッセージは通常イタリア語で届くため、自社テンプレートでアクセント付き文字、日付形式、文面の長さを確認する必要があります。マーケットプレイス、フィンテック、デリバリーアプリも、現地の決済や配送パートナーを有効にする前に、イタリアでのオンボーディングをテストします。このパターンはフィンテックのオンボーディングのメモで紹介しています。

運用チームにも独自の理由があります。イタリアのクライアントのソーシャルやマーケットプレイスのプロフィールを管理する代理店は、それらのビジネスアカウントを従業員の個人の携帯ではない番号で確認したいと考えます。共有ログインとの組み合わせ方は運用チーム向けのページで説明しています。

イタリアの一覧にあるサービスは?

現在、2,100を超えるサービスがイタリアのルートの番号にコードを送信できます。人気のものには、WhatsApp、Instagram、Facebook、Google (Gmail & YouTube)、Amazon、eBay、Airbnb、Uber、Telegram、Microsoft & Outlook、LinkedIn、Netflix、Discord、ChatGPT (OpenAI)があります。一覧はリアルタイムなので、長くキャッシュせず、その都度問い合わせてください。

APIでの `it` のフローはどう動く?

or_live_ で始まるBearerキーを付けて https://otproute.com/api/v1 にリクエストします。GET /api/v1/prices?country=it&service=<id> で料金を確認し、{"service": "<id>", "country": "it"} を本文にして POST /api/v1/activations で注文します。レスポンスにアクティベーションIDが含まれるので、GET /api/v1/activations/{id} をポーリングするか、activation.sms_received のWebhookを待ちます。残り2つの終了パターンである activation.expired と activation.cancelled も処理してください。

必ず X-OTPRoute-Signature("<t>.<raw body>" のHMAC-SHA256)を検証し、古いタイムスタンプは拒否してください。詳細はHMACガイドにあります。アカウントごとにキー10個、Webhookエンドポイント5つ、毎分300リクエストまで利用できます。

CIパイプラインでは、セットアップの手順で番号を注文し、SMSを発生させるブラウザテストを実行してから、Webhookが届くかウィンドウが閉じるまで、短命のリスナーで待機する構成がよく使われます。中断した実行で番号が開いたままにならないよう、ティアダウンの手順でキャンセルしてください。

ダッシュボードから注文する場合

開発者でなくても、Webアプリから同じことができます。OTP Gatewayを開き、サービスを選び、イタリアを選び、価格を確認して、+39番号をテスト中のアプリにコピーします。コードは届き次第、画面に表示されます。届かない場合は、ウィンドウが終わるまで待ち、そのサービスが仮想番号を受け付けるか確認してから、何度も注文し直すのではなく、時間をおくか別のルートで再試行してください。

各試行でどのサービスとルートを使ったかをメモしておくと、問題が特定のアプリだけのものか、その時間帯のイタリアのルート全体に及ぶものかを判断しやすくなります。

イタリアの固定番号はある?課金はどうなる?

イタリアにはセルフサービスの長期番号はありません。月額$1.95からのDedicated Numbersは米国とカナダのみです。イタリアの回線について問い合わせるには [email protected] にご連絡ください。提供の可否は現地の規制によります。課金は前払いのUSDウォレットで、カードまたはUSDT/USDCでチャージし、PDFの請求書が発行され、月額料金はありません。開始するには料金または新規登録をご覧のうえ、開発中はサンドボックスモードを依頼してください。

よくある質問

+39を付けるとき、イタリアの番号の0は取り除くべき?

固定電話では取り除きません。イタリアの固定電話は+39の後ろでも先頭の0を残します。携帯番号は3から始まり、もともとゼロはありません。

OTP Route APIでのイタリアの国IDは?

it です。価格のクエリとアクティベーションの本文の両方で使います。

イタリア国外から、イタリアのサインアップフローをテストできる?

はい。OTP Gatewayの+39番号は、チームがどこにいてもコードを受信でき、ダッシュボードまたはAPIで読み取れます。

イタリアのSMS OTPの費用は?

イタリアのコードは$0.20/コードからです。APIがサービスごとの現在のレートを返し、ダッシュボードでは確定前に表示されます。

イタリアのコードが届かない場合は?

20分後にアクティベーションが期限切れとなり、金額は自動的にウォレットへ返金されます。チケットの起票は不要です。

同じ+39番号を来月も再利用できる?

いいえ、ゲートウェイの番号は1回の認証専用です。長期回線は米国とカナダでのみ利用できます。

認証メッセージはイタリア語で届く?

多くの送信元が国ごとにローカライズするため、多くの場合はそうですが、アカウントの言語設定を使うものもあります。パーサーは文面ではなく数字を基準に作ってください。

知っておくべき利用制限はある?

各サービスの利用規約とOTP Routeの利用規定(Acceptable Use Policy)に従ってください。ゲートウェイは、自社の正当なプロダクトのテストと運用のためのもので、アカウントの大量作成には使えません。

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