ローンチ前にマケドニア(+389)のサインアップコードをテストする

ローンチのチェックリストに「+389のサインアップを確認」とあります。QAはどこから始めればよいですか?

よくある状況です。プロダクトが西バルカンへ展開し、サインアップフローはすでに十数市場に対応しています。そこで、北マケドニアの番号を受け付けること、そしてアプリが送るSMSが実際に届くことを、誰かが証明しなければなりません。同僚の携帯を借りる方法は規模が大きくなると続きませんし、現地SIMをCIランナー内で維持するのも面倒です。

OTP Gatewayなら、その依存をなくせます。APIまたはダッシュボードから北マケドニアの認証用番号をリクエストし、自社のフローに入力して、届いたコードを受け取るだけです。1つの番号で認証は1回きりなので、回帰テストスイートは実行のたびに新しい+389のテスト用番号を取得できます。チームがこれをリリースプロセスに組み込む方法は、QAテストの概要で紹介しています。

+389の番号はどう表記され、バリデータは何を受け付けるべきですか?

北マケドニアの国番号は+389、国内トランクプレフィックスは0です。携帯番号は国内では07X XXX XXXと書き、国際形式では0が取れて+389 7X XXX XXXとなり、国内番号は8桁です。E.164形式(+3897…)で保存し、国内形式は入力フォーマットとしてのみ扱ってください。

スイートに残しておく価値のあるテストケースは次のとおりです。

• ユーザーが+389を選択したうえで0も入力した場合、フォームは入力を拒否せず0を取り除くこと。
• スペース、スラッシュ、ダッシュを含む貼り付け番号が、1つの保存値に正規化されること。
• 範囲チェックは、固定のプレフィックスではなく、メンテナンスされている電話番号ライブラリで行うこと。事業者の番号帯は時間とともに変わるためです。

キリル文字のSMSテンプレートには、なぜ専用のテストが必要ですか?

マケドニア語は国全体の公用語でキリル文字で書かれ、アルバニア語も公用語として認められ広く話されています。アプリが認証メッセージをマケドニア語で送る場合、キリル文字によりUCS-2エンコードが必要になり、SMS 1通あたりの文字数は160文字から70文字に減ります。英語なら余裕で収まるテンプレートが複数セグメントに分割されたり、送信元が長さを制限していれば途中で切れたりすることがあります。

+389番号で実際のメッセージを受信すれば、ユーザーに見えるとおりの状態を確認できます。通知プレビューで読めるくらい早い位置にコードがあるか、ラテン文字へのフォールバックが働くか、オートフィルのヒントが引き続き機能するか、といった点です。サードパーティのサービスは独自の文面と言語を選ぶため、パーサーは固定フレーズではなく数字にマッチさせてください。

北マケドニアの番号をプログラムで取得するには、どの呼び出しを使いますか?

すべてのフィールドは開発者向けドキュメントにまとまっていますが、このSMS認証APIの流れは短く説明できます。https://otproute.com/api/v1 に対して、or_live_ で始まるBearerキーで認証し、次の順に進めます。

1. GET /api/v1/countries で国の一覧を取得します。北マケドニアのIDは mk です。
2. GET /api/v1/prices?country=mk&service=<id> で、現在の価格と空き状況を確認します。
3. POST /api/v1/activations に {"service": "viber", "country": "mk"} のようなボディを渡して、アクティベーションを作成します。
4. GET /api/v1/activations/{id} をポーリングするか、Webhookの activation.sms_received を待ちます。
5. テストが早く終わった場合は、POST /api/v1/activations/{id}/cancel でキャンセルします。

Webhookの呼び出しには X-OTPRoute-Signature: t=<unix>,v1=<hex> が付きます。エンドポイントのシークレットで "<t>.<raw body>" に対するHMAC-SHA256を再構築し、定数時間で比較し、古いタイムスタンプは拒否し、再配信しても影響が出ないようアクティベーションIDをキーに処理してください。アカウントごとに、キーは最大10個、Webhookエンドポイントは最大5つ、リクエストは毎分300件まで利用できます。

現在、+389ルートで利用できるサービスは何ですか?

北マケドニアには現在、OTP Gatewayで900を超えるサービスがあります。最新のスナップショットには、Viber、WhatsApp、Facebook、Instagram、Telegram、Google(Gmail & YouTube)、TikTok、Microsoft & Outlook、Signal、LinkedIn、Uber、ChatGPT(OpenAI)が含まれます。

すべてのサービスが一日中いつでも利用できるわけではありません。これはSMS在庫では普通のことで、だからこそ価格と空き状況はAPIで提供しています。コードを書かない同僚も、ダッシュボードで同じ手順を実行できます。アカウントを作成してチャージし、北マケドニアとサービスを選ぶと、コードが届き次第アクティベーションページに表示されます。

コードが届きません。どうすればよいですか?

各アクティベーションは20分間有効で、課金されるのはSMSが届いた場合のみです。キャンセルした場合や、何も届かないままウィンドウが閉じた場合は、全額が自動的にウォレットへ戻ります。

もう一度注文する前に、次の点を確認してください。

• ウィンドウが終わるまで待つこと。メッセージの紛失よりも、送信側の遅延のほうがずっとよくあります。
• そのサービスが仮想番号を受け付けるか確認すること。ポリシーとして拒否するサービスもあり、まさにその場合のために返金があります。
• 時間をおいて再試行するか、別のサービスのルートを使うこと。
• 不安定なテストが+389ルートに次々と注文を出さないよう、試行の間に間隔を置くこと。

市場をまたいだフォールバックの計画方法は、国別ルーティングガイドで解説しています。利用はご自身のプロダクトとアカウントに限り、各サービスの規約を守り、OTP Routeの利用規定(Acceptable Use Policy)が適用されることを忘れないでください。

マケドニアの固定回線、課金、サンドボックスはどうなっていますか?

OTP Routeでは、北マケドニアでセルフサービスの長期番号は提供していません。専用番号(Dedicated Numbers)はアメリカとカナダ向けの製品で、月額$1.95からすぐに購入できます。+389の長期回線が必要な場合は[email protected]までメールしてください。現地の規制で可能かどうかをチームがお答えしますが、提供できるとは約束できません。

支払いは従量課金で、カードまたはUSDT/USDCでチャージする前払いのUSDウォレットから行われます。月額料金はなく、チャージごとにPDFの請求書が発行されます。開発用アカウントは依頼によりサンドボックスに切り替えられ、連携をシミュレーションされた番号とコードに対して実行できます。

よくある質問

SIMカードなしで、アプリのマケドニア向けサインアップSMSを確認できますか?

はい。国 mk でOTP Gatewayの番号をリクエストし、自社のサインアップ画面で使って、メッセージをダッシュボードまたはWebhookから読み取ってください。

+389の認証コードはいくらですか?

1コード$0.20〜です。正確な金額はサービスによって異なり、ダッシュボードに表示されるほか、GET /api/v1/prices からも取得できます。SMSが届かないまま20分のウィンドウが閉じた場合は、全額が戻ります。

北マケドニアの番号に届く認証メッセージはキリル文字ですか?

送信元によります。自社アプリならテンプレートは自分で制御できますが、サードパーティのサービスはアカウントや端末の設定から言語を選ぶため、数字を解析するようにしてください。

マケドニアの携帯番号の先頭の0は、データベースに残すべきですか?

E.164形式で保存してください。+389に8桁の国内番号が続く形で、トランクの0もスペースも含めません。

北マケドニアの番号を、繰り返しのログインのために保持できますか?

セルフサービスでは不可です。長期の専用番号(Dedicated Numbers)はアメリカとカナダにしかありません。+389についてはサポートにメールしてください。回答は現地の規制によります。

クレジットを使わずに、北マケドニア向けのCIを実行する方法はありますか?

開発用アカウントでサンドボックスを依頼してください。番号とコードがシミュレーションされるので、ウォレットへの課金なしで連携全体をエンドツーエンドで実行できます。

サービスが私の+389番号を拒否するのはなぜですか?

仮想番号を拒否するプラットフォームがあります。その場合、アクティベーションは期限切れになるか、キャンセルでき、料金は自動的にウォレットへ戻ります。

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