アルメニア(+374)の認証コードに適したルートを選ぶ

アルメニアの認証業務には、どのOTP Routeの製品が適していますか?

コードを書く前に決めておきましょう。答えが連携全体の形を左右します。OTP Routeが販売するのは2つの製品で、アルメニアに対応するのはそのうち1つだけです。

• OTP Gateway:提携キャリアの番号を、1つのサービスと1つのコードのために確保します。登録テスト、ローカライズされたオンボーディング画面に対する回帰テスト、ビジネスプロフィールの単発の認証に向いています。+374にはこちらを使います。
• 専用仮想番号:更新される間は保持できる回線で、受信・送信SMSとブラウザ通話が付きます。即時販売は米国とカナダに限られ、月額$1.95からです。

セルフサービスのアルメニア長期番号はありません。プロジェクトで本当に必要な場合は、ユースケースを書いて [email protected] までご連絡ください。手配できるかどうかは現地の規制によるため、計画ではなく問い合わせとして扱ってください。最初のコードの後もログインし続ける必要があるアカウントには、米国またはカナダの専用回線が現実的な代替手段です。

OTP Gatewayでは、+374番号で何を認証できますか?

アルメニアのルートは現在、1,700を超えるサービスに対応しています。最新のスナップショットで人気のあるものには、WhatsApp、Telegram、Viber、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、Signal、LinkedIn、Microsoft & Outlook、Discord、ChatGPT (OpenAI)、Uberがあります。

メッセンジャーについて補足します。ViberとTelegramはどちらもアルメニアでなじみのある名前で、現地でチャットチャンネルへ利用者を誘導する製品には、これらのテストアカウントが必要になることがよくあります。サービスごとの利用可否は一日の中で変わるため、固定の一覧を載せる代わりに、APIがリアルタイムで返します。

アルメニアOTP APIの呼び出し手順はどう進みますか?

すべては https://otproute.com/api/v1 配下にあり、Developerコンソールで発行した or_live_ で始まるBearerキーを使います。アルメニアの国IDは am です。

1. GET /api/v1/services でサービスIDを一度だけ調べ、GET /api/v1/countries で am を確認します。
2. GET /api/v1/prices?country=am&service=<id> で、現在の価格とルートが開いているかを確認します。
3. POST /api/v1/activations に {"service": "telegram", "country": "am"} のような本文を送って注文します。返されたアクティベーションIDを保存します。
4. +374番号をテスト対象のフローに入力し、Webhookの activation.sms_received を待つか、GET /api/v1/activations/{id} をポーリングします。
5. 実行を中止する場合は、POST /api/v1/activations/{id}/cancel を呼び出すと、資金がすぐに戻ります。

Webhookリクエストには X-OTPRoute-Signature: t=<unix>,v1=<hex> が付きます。エンドポイントのシークレットで <t>.<raw body> のHMAC-SHA256を計算して比較し、古いタイムスタンプのものは破棄します。残りのイベントである activation.expired と activation.cancelled はAPIドキュメントにまとまっており、どちらも同じアクティベーションIDで管理されます。アカウントの上限は毎分300リクエストなので、ポーリングは控えめにしてください。

APIを使わない同僚も+374番号を注文できますか?

はい。運用担当者やサポート担当者は、ブラウザから同じことができます。

1. サインインしてOTP Gatewayを開き、アルメニアを選びます。
2. サービスを選びます。確定の前にリアルタイムの価格が表示されます。
3. 番号を、それを求めるアプリやサイトにコピーします。
4. アクティベーションを開いたままにします。コードが届くと、番号の横に表示されます。

ダッシュボードとAPIでは、ウォレットと注文履歴が共通なので、QAエンジニアとサポートリーダーが同じ残高から作業できます。

アルメニアの番号はどう保存すべきですか?コードはどの言語で届きますか?

アルメニア国内では、トランクプレフィックスとして先頭に0をダイヤルします。国際形式ではその0がなくなり、国コード+374の後に8桁の国内番号が続きます。保存する前にすべての入力をE.164に正規化してください。スペースとハイフンを取り除き、国内の0を外して、プラス記号と374を残します。国内形式を受け付けても未加工のまま保存するフォームは、後でテストハーネスが保持するE.164の値との照合に失敗します。

アルメニア語は独自の文字を持ち、ロシア語も広く通じるため、アルメニア語のUIは実際のローカライズ対象です。グローバルアプリからの認証メッセージは通常アプリの言語設定に従い、英語で届くことが多いものの、ローカライズされたテンプレートはアルメニア語やロシア語の文字で返ってくることがあります。周囲の単語を無視するパターンで数字を抽出し、ラテン文字以外のメッセージ本文が文字化けしないよう、ログとデータベースがUTF-8を扱えることを確認してください。

チームがここでテストする実務上の理由は、アルメニア向けローンチのためのローカライズされたオンボーディング、母国の番号で海外から登録する大規模なアルメニア系ディアスポラへのサポート、南コーカサス全域をカバーする地域運用などです。

アルメニアのコードが届かないときは、何を確認すべきですか?

有効時間内に反応がない場合の原因はいくつか決まっており、どれでも料金はかかりません。

• サービスが番号を拒否した。 仮想番号を一切拒否するプラットフォームもあります。使われなかったアクティベーションが返金されるのは、まさにそのためです。
• ルートが混んでいる。 20分の有効時間を最後まで待ってから、後でもう一度試すか、別のサービスルートを選びます。
• テストの再送が早すぎた。 短い間隔での再注文はほとんど効果がなく、サービス側のレート制限に引っかかることがあります。試行の間隔を空けてください。

ウィンドウが閉じるまでに何も届かない場合、またはキャンセルした場合は、全額がウォレットに自動的に戻ります。再試行のタイミングについては、OTP配信失敗を減らすのガイドでさらに詳しく解説しています。

アルメニアのアクティベーションの課金とテストはどうなりますか?

OTP Routeは、月額料金もプラン選択もない、前払い式のUSDウォレット1つで運営されています。カードまたはUSDT/USDCのステーブルコインでチャージでき、チャージごとにPDFの請求書がメールで届きます。最新の料金は料金ページにあり、価格エンドポイントからも取得できます。

実際の残高を使う前に、開発アカウントのサンドボックスモードを依頼してください。シミュレートされた番号とコードが返るので、CIジョブで am のフローをエンドツーエンドで検証できます。チームがこれをパイプラインに組み込む方法は、QAテストの概要で紹介しています。このサービスは自社の製品と正当なアカウントにのみ使用し、各プラットフォームの規約に従ってください。また、OTP Routeの利用規定(Acceptable Use Policy)が適用されます。

よくある質問

現地のSIMなしで、自社アプリのアルメニア向け登録フローをテストできますか?

はい。OTP Gatewayでサービス向けの+374番号を注文し、フローに入力して、国ID am のダッシュボードまたはAPIでコードを読み取ります。

テスト用の+374番号はいくらですか?

コードは$0.20/コードからで、正確な金額はサービスによって異なります。20分の有効時間内にSMSが届いたときだけ課金されます。

保存する番号に先頭の0を含めるべきですか?

いいえ。+374に8桁の国内番号を続け、国内のトランク0を除いたE.164形式で保存してください。

今後のログイン用に、アルメニアの認証番号を保持できますか?

セルフサービスではできません。OTP Gatewayの番号は1回分のコード用です。長期の専用回線は米国とカナダ向けの製品で、他の国については [email protected] にメールでお問い合わせください。

アルメニアのコードはアルメニア語の文字で届きますか?

届くこともあります。多くのサービスは英語で送りますが、ローカライズされたテンプレートではアルメニア語やロシア語が使われることがあるため、数字だけを解析し、メッセージはUTF-8で保存してください。

資金を使わずにアルメニアの連携をテストする方法はありますか?

はい。開発アカウントのサンドボックスモードを依頼すると、アクティベーションのフロー全体でシミュレートされた番号とコードが返ります。

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