現地SIMなしでアンゴラ(+244)の電話番号認証をテストする

+244番号をテストに使いたいのは誰か?

アンゴラの認証用番号を求めるのは、ルアンダに実際にはいないチームがほとんどです。ポルトガル語圏の市場へ展開するプロダクトチームは、ブラジル、ポルトガル、モザンビークと並べてアンゴラをテストすることが多く、それぞれ番号の形式もSMS送信元の挙動も異なります。QAエンジニアが確認したいのは、登録画面が9桁の+244モバイル番号を受け付けること、国選択の初期値が正しいこと、SMSのステップが最後まで完了することです。運用担当者が、社員の個人携帯を使わずにビジネスプロフィールを確認するために+244番号を必要とする場合もあります。

これが自分たちのバックログに当てはまるなら、QAテストのプレイブックで、OTPチェックを回帰テストスイートに組み込む方法を紹介しています。

アンゴラのルートで今使えるサービスは?

アンゴラの現在のスナップショットでは、おなじみの名前が先に並びます。WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、ChatGPT (OpenAI)、Microsoft & Outlook、LinkedIn、Uber、Signal、Viberです。国全体では1,600を超えるサービスに対応しています。

一覧にないサービス向けのアンゴラ認証番号が必要な場合は、まずカタログを検索してください。どの一覧も出発点であって保証ではありません。在庫は一日の中で変動するため、GET /api/v1/prices は価格と一緒に空き状況を返します。一晩キャッシュするのではなく、注文の直前に毎回取得してください。

コードからアンゴラの番号を注文するには?

クライアントを https://otproute.com/api/v1 に向け、or_live_ で始まるBearerキーを送信します。キーはDeveloperコンソールで発行します。手順は短く済みます。

1. GET /api/v1/countries と GET /api/v1/services でIDを調べます。アンゴラは ao です。
2. GET /api/v1/prices?country=ao&service=<id> で価格と在庫を確認します。
3. POST /api/v1/activations に {"service": "telegram", "country": "ao"} を送って注文します。
4. 返された+244番号を、テスト対象のアプリに入力します。
5. Webhookで activation.sms_received を待つか、GET /api/v1/activations/{id} をポーリングします。

Webhookは X-OTPRoute-Signature で署名されています。エンドポイントのシークレットで <t>.<raw body> のHMAC-SHA256を再計算し、古いタイムスタンプは拒否し、再送された配信で何も変わらないようにハンドラーをアクティベーションIDで管理してください。同じSMS認証APIが他のすべての国のOTPルーティングも担うため、アンゴラ用に作ったクライアントは後で再利用できます。構築の流れはAPI連携ガイドで解説しています。

+244番号の保存とポルトガル語メッセージの解析

アンゴラは国内トランクプレフィックスのない9桁のクローズド番号計画を採用しており、モバイル番号は9から始まります。そのため正規化は簡単です。スペースとハイフンを除去し、先頭の +244 を残し、加入者番号の前に0を挿入しないでください。正しいE.164形式は、プラス記号の後ろが12桁になります。

公用語はポルトガル語なので、周辺の文面をポルトガル語で書く送信元もあれば、英語を既定にしている送信元もあります。アクセント付き文字があるとメッセージがUnicodeエンコードになり、セグメントの分割方法が変わることがあります。ただし、固定フレーズに一致させるのではなく本文から数字のまとまりを抽出するパーサーであれば、そうした違いは問題になりません。これはポルトガル語圏の市場全般で、より安全な習慣です。

ルアンダでのテストが止まったら?

コードが来ない原因は、たいてい地味なものです。エスカレーションする前に次を順に確認してください。

• 20分の有効時間を最後まで待ちます。遅れて届いたコードも有効で、未使用の注文は自動で返金されます。
• アンゴラのアカウントで、そのサービスが仮想番号を受け付けるか確認します。拒否するプラットフォームもあり、そのために返金ルールがあります。
• 少し時間を置いて再試行するか、同じフローを別のサービスルートでテストします。
• 短い間隔で繰り返し注文するのは避けます。間隔を空けることで、ウォレットと送信元の評判の両方を守れます。

追加のチェック項目は、OTP配信失敗を減らすの記事にまとめています。

長期回線、ウォレット、サンドボックス

アンゴラにはセルフサービスの長期番号はありません。専用回線は、受信SMS、送信SMS、ブラウザ通話を備えた米国・カナダ向けの製品で、月額$1.95からです。+244の固定回線が必要な場合は [email protected] までメールしてください。実現できるかどうかは現地の規制によります。

課金は、月額料金もプラン選択もない、前払い式のUSDウォレット1つで行われます。カードまたはUSDT/USDCでチャージでき、チャージごとにPDFの請求書が届きます。連携開発にはサンドボックスアカウントを依頼してください。シミュレートされた番号とコードが返るので、CI実行に費用はかかりません。サービスごとの最新価格は料金ページをご覧ください。

よくある質問

アンゴラにいなくても、自社アプリのアンゴラ向け登録フローを検証できますか?

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

OTP Route APIでのアンゴラの国IDは何ですか?

アンゴラは ao です。POST /api/v1/activations の country フィールドと、GET /api/v1/prices の country クエリパラメータに指定します。

アンゴラの番号には先頭の0が必要ですか?

いいえ。アンゴラに国内トランクプレフィックスはないため、モバイル番号は+244の後に9から始まる9桁を続けて書きます。保存もその形式にしてください。

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

料金は$0.20/コードからで、サービスによって異なります。確定する前に、ダッシュボードと GET /api/v1/prices で正確な金額を確認できます。

SMSが届かなかった場合はどうなりますか?

20分の有効時間内に何も届かない場合、またはその前にキャンセルした場合は、全額がウォレットに自動で戻ります。実際に届いたコードの分だけお支払いいただきます。

繰り返しログインできるよう、アンゴラの番号を保持できますか?

セルフサービスではできません。長期の専用番号は米国とカナダ向けのみです。アンゴラの回線については [email protected] にメールしてください。現地の規制で可能かどうかをチームがお答えします。

お金をかけずに連携をテストする方法はありますか?

はい。リクエストにより開発アカウントをサンドボックスに切り替えられます。シミュレートされた番号とコードが返るので、フロー全体をエンドツーエンドで確認できます。

アンゴラの番号の使い方にルールはありますか?

自社の正当な製品やアカウントのテスト・運用にのみ使用し、各サービスの利用規約を守り、OTP Routeの利用規定(Acceptable Use Policy)の範囲内でご利用ください。

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