コモロ(+269)の認証コードを受信するためのチェックリスト

現地のSIMを持たずにコモロのSMSコードを受信できますか?

できます。テスターが1つのコードを読み取るためだけにモロニへSIMカードを送るのは時間がかかるうえ再現も難しく、リリースのスケジュールが電話を持つ人に左右されてしまいます。OTP Routeなら、選んだサービス用の+269番号をリクエストし、テスト対象のアプリでコードをトリガーして、ソフトウェアから受け取れます。ダッシュボードを操作するプロダクトマネージャーにも、ブラウザを一切使わないCIジョブにも、同じルートが使えます。

このページの残りは、チェックリスト、具体的な手順、メッセージが届かない場合の対処法の順に構成されています。

+269番号を注文する前の事前チェックリスト

プロジェクトごとに一度これらの項目を確認しておけば、失敗の多くは起こる前に防げます。

• APIキーは、開発者コンソールで作成するor_live_で始まるものです。最大10個まで保持できるので、CIには専用のキーを割り当て、個別に失効させられるようにしてください。
• Webhookエンドポイント(1アカウントにつき最大5つ)でX-OTPRoute-Signatureヘッダーを検証します。公開URLを用意できない場合は、ポーリングのループで代用します。
• ウォレットの資金はUSDで用意します。連携の動作確認だけで費用をかけたくない場合は、サンドボックスアカウントを使います。
• 正規化処理をコードに組み込み、コモロの番号をE.164形式で保存します(詳細は後述)。
• 対象サービスが仮想番号を受け付けるかの確認。仮想番号を拒否するプラットフォームもありますが、それは先方のポリシーであり、返金ルールはまさにこのケースのためにあります。
• レート予算。APIは1アカウントにつき毎分300リクエストまで許可するため、ステータスエンドポイントを連打せず、適切な間隔でポーリングしてください。

現在、コモロのルートにコードを送信できるアプリは何ですか?

コモロのライブスナップショットには、800を超えるサービスが載っています。よく使われるものには、WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、Microsoft & Outlook、ChatGPT (OpenAI)、Claude、Amazon、Discord、LinkedIn、Signal、Viberなどがあります。

在庫は日中でも変動するため、APIは固定のカタログを公開するのではなく、利用可能な状況をライブで返します。この一覧は出発点と考え、特定の組み合わせに依存するテストを実行する前に、GET /api/v1/countriesとGET /api/v1/servicesで確認してください。

ステップ別:コモロOTP APIの手順

ベースURLはhttps://otproute.com/api/v1で、すべてのリクエストにAuthorization: Bearer <key>を付けます。

1. GET /api/v1/prices?country=km&service=<id>で現在の価格を取得します。kmはコモロの国IDで、サービスIDはサービス一覧から取得します。
2. POST /api/v1/activationsに本文{"service": "<id>", "country": "km"}を付けて送信し、アクティベーションを作成します。レスポンスには+269番号とアクティベーションIDが含まれます。
3. その番号を、テスト中の登録フォームまたはログインフォームに入力します。
4. Webhookでactivation.sms_receivedを待つか、数秒ごとにGET /api/v1/activations/{id}を呼び出します。
5. テストを中止する場合はPOST /api/v1/activations/{id}/cancelを呼び出し、残高に確保されていた金額を解放します。

署名の検証では、エンドポイントのシークレットで"<t>.<raw body>"のHMAC-SHA256を計算してv1の値と比較し、タイムスタンプが古いリクエストは拒否します。完全なリファレンスはAPIドキュメントにあります。

コードを書かずに同じことをするには

サポート担当者や代理店のアカウントマネージャーは、すべてブラウザから行えます。サインインしてOTP Gatewayを開き、コモロを選び、サービスを選んで、確定する前に表示される価格を確認します。番号はすぐに表示されるので、アプリに貼り付けて、ページを開いたままにしておきます。SMSが届くとアクティベーションの横にコードが表示されるので、そのまま認証フィールドにコピーできます。

+269のコードが届かないときのトラブルシューティング

何も届かないのは、たいていクライアントのバグではなく、ルーティングや受け入れの問題です。次の順に確認してください。

• ウィンドウに時間を与える。アクティベーションは20分間有効です。その間にアプリからコードを再送するのは問題ありません。
• 短い間隔で再注文しない。数秒ごとに新しいアクティベーションを発行しても、レート予算を消費するだけで、ほとんど効果はありません。
• 時間を置くか、別のルートを試す。別のサービスの組み合わせや、マダガスカルのような近隣の国では、その日の状況が異なる場合があります。
• 受け入れを確認する。アプリが仮想番号を拒否する場合は、何度再試行しても変わりません。

コードが配信された場合にのみ料金が発生します。ウィンドウが空のまま閉じた場合やキャンセルした場合は、全額が自動的に返金されます。さらに詳しくは、OTP配信失敗を減らすためのガイドをご覧ください。

+269番号はどのように保存すべきですか?また、コードは何語で届きますか?

コモロの番号は短く、国番号+269の後に7桁の国内番号が続き、取り除くべきトランクプレフィックスはありません。E.164形式、つまり+269に7桁を続けてスペースなしで保存し、他国の習慣でコピーされた先頭のゼロが付いた入力は拒否してください。

公用語はコモロ語、フランス語、アラビア語です。グローバルアプリは通常、アカウントのロケールに応じて英語かフランス語でコードを送るため、パーサーは決まった文言ではなく数字の並びを探すようにしてください。海外のコモロ人コミュニティ向けにサービスを提供する場合、フランス語のローカライズQAを行う場合、東アフリカやインド洋地域への展開を準備する場合などに、この国でテストが行われます。

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

課金は前払いのUSDウォレット1つにまとまっており、月額料金もプランの選択もありません。チャージはカードまたはUSDT/USDCで行え、チャージのたびにPDF請求書がメールで届きます。最新の料金は料金ページにあります。連携を組み込む間は、開発用アカウントにサンドボックスモードを依頼すれば、シミュレートされた番号とコードを受け取れます。

OTP Routeには、コモロ向けのセルフサービスの長期番号はありません。Dedicated Numbersはアメリカとカナダ向けの製品で、月額$1.95からです。継続して使える+269回線が必要な場合は、[email protected]までメールしてください。現地の規制で可能かどうかをチームがお知らせしますが、提供をお約束するものではありません。

よくある質問

現地のSIMなしで、アプリのコモロ向け登録フローをテストできますか?

はい。OTP Gatewayで+269番号を注文し、登録フォームに入力して、ダッシュボードまたはWebhookからコードを読み取ります。

OTP Route APIでのコモロの国IDは何ですか?

kmです。料金の取得やアクティベーションの作成時に、countryの値として渡します。

コモロの認証コードの料金はいくらですか?

コモロのアクティベーションは1コード$0.20 からで、選ぶサービスによって金額が変わります。正確な金額はGET /api/v1/pricesで返され、確定前にダッシュボードにも表示されます。

コードが一度も届かなかった場合はどうなりますか?

20分後にアクティベーションが期限切れとなり、全額がウォレットに戻ります。それより前にキャンセルした場合も、同様に返金されます。

コモロの番号から先頭のゼロを取り除く必要がありますか?

コモロではトランクプレフィックスが使われないため、保存する形は+269に7桁の番号を続けたものになります。

知っておくべき利用ポリシーはありますか?

コモロの番号は、自社の正当なアカウントやプロダクトのテストと運用にのみ使い、各サービスの利用規約を守ってください。OTP Routeの利用規定(Acceptable Use Policy)も適用されます。準備ができたらアカウントを作成してください。

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