日本語
キンシャサのSIMなしで、コンゴ民主共和国の+243登録フローをテストする
はい。OTP Routeでは、コンゴ民主共和国の+243認証コードを受信できます。OTP Gatewayで使い切りの番号を注文し、コードはダッシュボードで確認するか、REST APIと署名付きWebhookで取得します。料金は1コード$0.20 からで、20分のウィンドウ内に何も届かなかったコンゴ民主共和国向けの注文は、費用がかかりません。
チームがコンゴ民主共和国に展開するのに、+243のSIMを持つ人がいません。どうすればよいですか?
プロダクトやQAのチームにはよくある状況です。ロードマップにはコンゴ民主共和国とあり、リリース候補も準備できているのに、電話認証のステップを承認すべき人が別の国にいます。物理SIMカードをテスト用のラボに送り、残高を維持し、端末をオフィスで回して使うのは時間がかかりますし、すべてのテストがその日に端末を持っている人に左右されてしまいます。
OTP Gatewayは、このボトルネックを解消します。特定の1つのサービス用に+243番号をリクエストし、自社の登録画面やログイン画面で1回だけ使えば、コードはツールが読み取れる場所に届きます。これにより、コンゴ民主共和国の認証番号は、他のフィクスチャと同じように、テストスクリプトがオンデマンドでリクエストできるものになります。
チームがこのチェックを行う典型的な理由は次のとおりです。
- フランス語のオンボーディング画面が、コンゴの番号を正しく受け付けてフォーマットすることを確認する
- 中央アフリカ向けの地域リリースの前に、モバイルアプリの回帰テストを行う
- 担当者個人の電話番号を明かさずに、運用チームが会社所有の事業用アカウントを認証できるようにする
現在、+243番号で認証できるサービスは何ですか?
コンゴ民主共和国向けの対応サービスは現在、1,000を超えます。ライブスナップショットで目立つものには、WhatsApp、Telegram、Facebook、Instagram、TikTok、imo、Viber、Signal、Google (Gmail & YouTube)、Microsoft & Outlook、Uber、Amazon、ChatGPT (OpenAI)などがあります。
imo、Viber、WhatsAppといったメッセージングアプリは特に注目に値します。この地域では、多くのプロダクトがサポートや通知をこれらのアプリに任せており、QAでは実際のユーザーと同じ番号帯でアカウントが必要になることが多いためです。
在庫は1日を通して変動するため、どんな一覧も出発点と考えてください。信頼できるのはライブの情報です。GET /api/v1/countriesとGET /api/v1/pricesは、今この瞬間に注文できるものを返し、ダッシュボードでも支払い前に同じデータが表示されます。全カタログはすべての国にあります。
コンゴ民主共和国のOTP APIは、テスト実行にどう組み込めますか?
すべての操作はhttps://otproute.com/api/v1に対して、開発者コンソールで作成したor_live_で始まるBearerキーを使って行います。1アカウントにつき、キーは最大10個、Webhookエンドポイントは5つまで保持でき、レート制限は毎分300リクエストです。
GET /api/v1/prices?country=cd&service=whatsappで料金を確認します(サービスはテストするものに置き換えてください)。コンゴ民主共和国の国IDはcdです。POST /api/v1/activationsに{"service": "whatsapp", "country": "cd"}のようなJSON本文を付けて注文します。アクティベーションIDと+243番号が返されます。- その番号を、アプリの認証ステップに入力します。
- Webhookで
activation.sms_receivedを待つか、数秒ごとにGET /api/v1/activations/{id}をポーリングします。 - 使わなかった注文は
POST /api/v1/activations/{id}/cancelで解放します。
Webhookの呼び出しにはX-OTPRoute-Signature: t=<unix>,v1=<hex>が付きます。エンドポイントのシークレットで"<t>.<raw body>"のHMAC-SHA256を再計算し、定数時間で比較して、古いタイムスタンプは破棄してください。このSMS認証APIの詳細は、Webhookによるコード取得ガイドとAPIリファレンスにあります。
+243番号はどのように保存すべきですか?また、SMSは何語で届きますか?
コンゴの番号は、国内ではトランクプレフィックス0に9桁を続けて表記します。国際形式では0がなくなり、+243に続けてその9桁になります。E.164形式で保存し、入力時にはスペースと先頭のゼロを取り除いてください。また、ユーザーは直近に目にした方で入力するため、国内形式と国際形式のどちらの表記もフォームが受け付けることをテストしましょう。
公用語はフランス語で、リンガラ語、スワヒリ語、キコンゴ語、チルバ語が国語です。グローバルサービスからの認証SMSは、アプリやアカウントの設定に応じて、フランス語か英語で届くのが一般的です。前後の文言で解析するのではなく、本文から数字のまとまりを抽出し、テンプレートの言語が何であっても同じパーサーが動くようにしてください。
ローカライズの確認では、抽出したコードと一緒にSMSの全文も記録しておくと役立ちます。コンゴのユーザーが実際に読む内容を、翻訳者やQAが確認できる記録になります。
認証コードが届かない場合はどうなりますか?
各注文は20分間有効です。コードが届いた場合にのみ料金が発生します。SMSが届かないままウィンドウが閉じた場合や、キャンセルした場合は、全額が自動的にウォレットに戻ります。つまり、反応のない番号で失うのは時間であって、お金ではありません。
その場合は、次のようにします。
- 遅れて送信するサービスもあるため、失敗と判断する前にウィンドウの終わりまで待つ
- 利用状況は時間ごとに変わるので、時間を置いて再試行するか、別のサービスルートを試す
- サービスによっては拒否するため、そもそも仮想番号を受け付けるか確認する
- 短い間隔で再注文しない(レート制限を消費するだけで、結果は良くなりません)
OTPルーティングの再試行設計については、OTP配信失敗を減らす方法の記事でさらに詳しく解説しています。
保持するアカウント用の、+243の長期回線はありますか?
ありません。OTP Routeでは、コンゴ民主共和国向けのセルフサービスの長期番号は提供していません。Gatewayの番号はコード1回分のために作られているため、登録テストには向いていますが、半年後に再びログインが必要になるアカウントには向きません。
更新している間保持できるDedicated Numbersは、アメリカとカナダ向けの製品で、月額$1.95からです。コンゴの長期回線が必要な場合は、[email protected]に用途を添えてメールしてください。提供の可否は現地の規制によるため、お約束はできません。
コンゴ民主共和国のテスト通信の課金はどうなっていますか?
前払いのUSDウォレットが1つあり、月額料金もプランの選択もありません。チャージはカード、またはUSDT/USDCで行え、チャージのたびにPDFの請求書がメールで届くため、QAの支出も照合しやすくなります。各注文の前にライブ価格がどう表示されるかは、料金をご覧ください。
連携作業では、ご依頼に応じて開発用アカウントをサンドボックスに切り替えられます。シミュレートされた番号とコードが返されるため、ウォレットの資金を使わずにパイプラインをエンドツーエンドで実行できます。
これらの番号は自社のプロダクトとアカウントにのみ使い、各サービスの利用規約を守ってください。また、OTP Routeの利用規定(Acceptable Use Policy)はすべての注文に適用されます。
よくある質問
現地のSIMなしで、アプリのコンゴ民主共和国向け登録フローをテストできますか?
はい。テストするサービス用の+243番号をOTP Gatewayで注文し、アプリに入力して、ダッシュボードまたはAPIでコードを読み取ります。
コンゴ民主共和国のAPIの国IDは何ですか?
料金の照会とアクティベーションの本文の両方でcdを使います。たとえば{"service": "telegram", "country": "cd"}のようにします。
+243のコードが届かなかった場合、課金されますか?
いいえ。20分間何も届かなかった+243の注文や、早めにキャンセルした注文は、チケットを起こさなくても、全額がウォレットに返金されます。
コンゴの番号は、先頭のゼロを付けて保存すべきですか?
E.164形式、つまり+243にトランクのゼロを除いた9桁を続けた形で保存してください。ユーザーが期待する場合に限り、国内形式は表示用にのみ残します。
スタッフが来月、同じ+243番号で再度ログインできますか?
確実にはできません。Gatewayの番号はコード1回限りのためです。長期のDedicated Numbersがセルフサービスで利用できるのはアメリカとカナダのみで、コンゴ民主共和国については[email protected]にメールでお問い合わせいただけます。
お金をかけずに、APIに対してCIを実行する方法はありますか?
はい。開発用アカウントをサンドボックスに切り替えるよう依頼すると、シミュレートされた番号とコードが返されます。
注文した+243番号を、サービスが拒否したのはなぜですか?
仮想番号を拒否したり、特定の番号帯を制限したりするサービスがあります。キャンセルするかウィンドウの期限切れを待って返金を受けてから、時間を置いて再試行するか、別のサービスルートでテストしてください。
サービス名はそれぞれの所有者の商標です。OTP Route はこれらの企業と提携していません。番号は合法的にご利用いただき、各サービスの利用規約および当社の利用規定に従ってください。