プロダクト・QAチームのためのアイルランド(+353)SMS認証

なぜ多くのチームがテストにアイルランドの番号を必要とするのか?

ダブリンには多数のソフトウェア企業の欧州本社が置かれているため、EU向けのプロダクトの多くがアイルランドで開発・サポート・運用されています。そのため、EU全域への展開前に、ヨーロッパ向けのサインアップフロー、ユーロ建ての決済、英語のオンボーディングを確認するのに適した国です。

英語とアイルランド語はどちらも公用語ですが、認証用のSMSはほぼ必ず英語で届きます。アプリがアイルランド語のインターフェースを提供している場合でも、SMSの送信元が実際にどのテンプレートを使うかは確認しておく価値があります。

もう一つ、この島ならではの注意点があります。北アイルランドの利用者はアイルランドの番号ではなく英国の番号を使います。島全体にサービスを提供するプロダクトなら、+353に加えて英国(+44)のルートもテストしてください。

アイルランドの携帯番号はE.164でどう表記される?

アイルランドの国内番号は先頭にトランクプレフィックス 0 が付き、携帯番号は 08 で始まります。たとえば国内表記の 087 123 4567 は、国際形式では +353871234567 になります。正規化のルールは単純で、先頭のゼロを取り除き、+353 を付け、スペースとハイフンを削除します。

保存するのはE.164形式にし、ユーザーが入力した書式は表示用にのみ残してください。087… と +353 87… の両方を入力して同じ保存値になることを確認するユニットテストを1本書いておくと、アイルランドのユーザーで起こりがちな重複アカウントのバグの大半を防げます。

アイルランドのルートで利用できるサービスは?

アイルランドでは現在、OTP Gatewayを通じて1,700を超えるサービスが利用できます。今回のスナップショットで人気のものには、WhatsApp、Instagram、Facebook、Google (Gmail & YouTube)、Microsoft & Outlook、LinkedIn、Uber、Amazon、eBay、Airbnb、Netflix、Discord、Snapchat、Signal、ChatGPT (OpenAI)があります。

これはあくまで現時点の状況です。サービスごとの利用可否は一日の中で変わるため、APIはリアルタイムで返しており、スクリプトも注文前に確認する必要があります。

テストスイートからアイルランドのOTP APIを呼び出すには?

https://otproute.com/api/v1 に対して、Developerコンソールで発行した or_live_ で始まるBearerキーで認証します。アイルランドの国IDは ie です。

典型的な流れは次のとおりです。まず GET /api/v1/services からサービスIDを一度だけ取得し、GET /api/v1/prices?country=ie&service=<id> で料金を確認します。次に {"service": "<id>", "country": "ie"} を本文にして POST /api/v1/activations で注文します。返された番号をUIテストに渡し、コードは GET /api/v1/activations/{id} のポーリング、またはWebhookの activation.sms_received で受け取ります。

Webhookでは、X-OTPRoute-Signature(エンドポイントのシークレットによる "<t>.<raw body>" のHMAC-SHA256)を検証し、古いタイムスタンプは拒否し、ハンドラーはアクティベーションIDで冪等にしてください。夜間ジョブへの組み込み方はCIパイプラインガイドで解説しています。1アカウントにつきWebhookエンドポイントは5つ、リクエストは毎分300回まで利用できます。

サポートやグロース担当者は、APIなしでも使える?

はい、ダッシュボードで同じ流れを実行できます。OTP Gatewayでアイルランドとサービスを選び、表示された価格を確認して確定し、+353番号をサインアップフォームにコピーします。送信元がSMSを送ると、コードが注文の横に表示されます。グロースチームがエンジニアにスクリプトを頼まなくても、新しいアイルランド向けランディングページをすぐに動作確認できます。

アイルランドのコードが遅い、または届かないときの対処は?

各アクティベーションは最大20分待機します。その間にSMSが届かない場合、またはその前にキャンセルした場合は、全額が自動的にウォレットへ返金されるため、失敗した試行にコストはかかりません。

再試行する前に、そのサービスが仮想番号を受け付けているか確認してください。ポリシーとして拒否するサービスもあります。受け付けるはずなのに届かないなら、少し待ってからやり直すか、同じサービスで別のルートに切り替えます。注文エンドポイントを連打せず、再試行の間隔をあけて、パターンを把握できるようアクティベーションIDをログに残してください。さらに詳しくはOTP配信失敗を減らすにはをご覧ください。各サービスの利用規約とOTP Routeの利用規定(Acceptable Use Policy)は必ず守ってください。

アイルランドの番号を長期間保持できる?課金はどうなる?

セルフサービスではできません。長期利用のDedicated Numbersは米国とカナダのみで、月額$1.95から、受信SMS、送信SMS、ブラウザ通話に対応します。アイルランドの回線を継続的に必要とするチームは [email protected] までメールしてください。ただし現地の規制次第で、確約はできません。

課金は前払いのUSDウォレットで、従量課金、サブスクリプションなし、チャージはカードまたはUSDT/USDCで、チャージのたびにPDFの請求書がメールで届きます。開発アカウントにはサンドボックスモードを依頼でき、模擬の番号でインテグレーションをエンドツーエンドで試せます。料金の見え方は料金ページをご覧ください。

よくある質問

アイルランド国外から、アイルランド向けサインアップフローを確認できる?

チームがどこにいても、OTP Gatewayで+353番号を注文し、コードをダッシュボードまたはAPIで読み取れます。

アイルランドのOTP Route国IDは?

ie です。アイルランドの価格照会とアクティベーションのリクエスト本文で、country フィールドにこの値を指定します。

アイルランドの携帯番号を保存するとき、先頭の0は残す?

いいえ。トランクプレフィックスを取り除き、+353 に続けて残りの桁を保存します。087… は +35387… になります。

北アイルランドの番号はアイルランドのルートに含まれる?

いいえ。北アイルランドは英国(+44)の番号です。両方に対応するプロダクトなら、英国のルートで注文してください。

アイルランドのSMS OTPを受信する費用は?

$0.20/コードからです。正確な価格はサービスによって異なり、購入前にリアルタイムで返されます。

費用をかけずにアイルランド向けの連携をテストする方法は?

あります。開発アカウントはリクエストによりサンドボックスに切り替えられ、エンドツーエンドのテスト用に模擬の番号とコードが返されます。

GDPRを意識したアイルランドのサインアップフローのテストにも使える?

QA担当者が自分の携帯番号を使わずにアイルランドの電話番号の手順を検証できるため、テストデータと従業員のデータを分けられます。テスト対象のアプリ自体のプライバシー上の義務は、引き続きお客様に適用されます。

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