チャド(+235)の認証コードを自社スタックに取り込む

チャドのOTP APIリクエストの呼び出しシーケンスは?

チャド向けのリクエストも、ほかの市場と同じベースURL https://otproute.com/api/v1 に送り、or_live_ のBearerキーで署名します。キーは開発者コンソールで作成します。1アカウントで最大10個のキーを保持でき、毎分300リクエストまで送れます。

典型的なチャド向けの実行は、4つの呼び出しで進みます。

1. GET /api/v1/countries と GET /api/v1/services で、td が掲載されていることと、テスト対象のサービスIDを確認します。
2. GET /api/v1/prices?country=td&service=<id> で、費用をかける前に、その組み合わせの現在価格を確認します。
3. {"service": "telegram", "country": "td"} のようなボディを付けて POST /api/v1/activations を送ります。レスポンスには、アクティベーションIDと、テスト対象のアプリに入力する+235番号が含まれます。
4. コードを待ち、そのままアクティベーションを完了させるか、テストを早めに中断する場合は POST /api/v1/activations/{id}/cancel を呼びます。

CIジョブの冒頭で GET /api/v1/balance を呼んでおく価値があります。ウォレットが空のとき、パイプラインが途中でタイムアウトするのではなく、はっきりと失敗するようになるからです。完全なリファレンスは開発者向けドキュメントにあります。

Webhook受信側は、+235のコードをどう扱うべきですか?

単一のスクリプトなら、数秒おきに GET /api/v1/activations/{id} をポーリングする方法で十分です。複数のテストランナーが1つのキーを共有するようになったら、Webhookのほうがすっきりします。エンドポイントを登録し(1アカウントで5つまで)、activation.sms_received、activation.expired、activation.cancelled を購読してください。

各リクエストには、t=<unix>,v1=<hex> 形式の X-OTPRoute-Signature ヘッダーが含まれます。<t>.<raw body> という文字列を再構成し、エンドポイントのシークレットでHMAC-SHA256の署名を作成して、v1 と定数時間で比較します。タイムスタンプが古いものは拒否してください。そうすれば、リプレイされたリクエストを防げます。HMACによるOTP Webhookの保護のガイドで、複数の言語での手順を解説しています。

アクティベーションIDは、冪等性キーとして扱います。同じイベントが2回配信されても、2回目の書き込みは何も変えないようにし、ハンドラーは2xxを素早く返して、時間のかかる処理はその後に行いましょう。

チャドの認証番号にコードを送れるアプリは?

td のライブスナップショットには、1,500を超えるサービスが掲載されています。人気のものには、WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、Viber、imo、Signal、Microsoft & Outlook、LinkedIn、ChatGPT (OpenAI)、AliExpressなどがあります。

利用可否は固定ではありません。提携キャリアが容量を動かすため、ルートは一日の中で開閉し、午前に見えていたサービスが午後には消えていることもあります。カタログは決め打ちにせず、実行時に読み取ってください。また、チャドで最初のサービスが一時的に使えない場合に備えて、テスト計画に2つ目のサービスを入れておきましょう。

+235番号は、どのように保存・正規化しますか?

チャドはクローズド・ナンバリング・プランを採用しており、国内番号は8桁で、取り除くべきトランクプレフィックスはありません。そのため、E.164形式は +235 にその8桁を続けるだけです。チャドは、検証が比較的簡単な市場の1つといえます。

• 国番号と加入者番号を分けるのではなく、完全なE.164の文字列を1つのカラムに保存します。
• フォームがスペースや、人がよく入力する2桁ずつの区切りを受け付ける場合は、保存前にそれらを取り除きます。
• 別の番号計画から来たユーザーが、癖で余分な先頭の 0 を付けることがあるため、そうした値が拒否されるか整形されることを、テストで確認します。

公用語はフランス語とアラビア語です。ただし、認証SMSの文面は、アプリやアカウントに設定された言語に従うため、ローカライズのテストスイートでは、フランス語、アラビア語、英語のテンプレートを別々に確認してください。

プロダクトチームが、チャドでテストを行うのはなぜですか?

ンジャメナに拠点を置くエンジニアリングチームはほとんどありません。だからこそ、リモートの+235番号が役に立ちます。よくある理由は次のとおりです。

• フランス語圏の中央アフリカでの展開。 すでに近隣市場で稼働しているプロダクトが、サインアップの国選択にチャドを加え、フローが動くことを証明する必要がある場合です。
• アラビア語とフランス語のローカライズQA。 コード入力画面の右から左へのレイアウトも含みます。
• ディアスポラの顧客。 海外に住みながらチャドの番号を保持しており、不正対策ルールが国番号をどう読むかに影響します。
• 運用チーム。 地域のパートナー向けに、ビジネスメッセージングのアカウントを管理している場合です。

より広いパターンは、OTPの国別ルーティングで解説しています。

チャドのコードが届かないときは?

番号が沈黙する原因は、たいていコードのバグではなく、ルートか受け入れ側の問題です。次の順で確認しましょう。

• 20分のウィンドウを最後まで待ちます。メッセージをまとめて送る送信元もあります。
• 対象のサービスが仮想番号を受け付けるか確認します。受け付けないサービスもあり、返金はそのためにあります。
• 短い間隔で再注文するのではなく、時間をおいてやり直すか、同じ国で別のサービスを試します。連続した再試行は、送信側自身のレート制限に引っかかることがあります。
• ハンドラーが署名を正しく検証したかを確認します。拒否されたWebhookは、コードが届いていないように見えます。

ウィンドウが閉じた場合やキャンセルした場合は、サポートへの問い合わせなしで、全額がウォレットに戻ります。ほかの対処法はOTP配信失敗を減らす方法にあります。

長期利用のチャド回線はありますか?課金の仕組みは?

セルフサービスで使える長期利用のチャド番号はありません。Dedicated Numbersは米国とカナダ向けのプロダクトで、月額$1.95/monthからです。SMSの送受信とブラウザ通話に対応しています。継続的な+235回線が必要な場合は、[email protected] にメールしてください。提供できるかどうかは現地の規制次第で、お約束できるものではありません。

+235コードの料金は、前払い制のUSD残高1つから差し引かれます。サブスクリプションの階層も月額料金もありません。入金はカードまたはUSDT/USDCのステーブルコインで行え、入金のたびにPDFの請求書が受信トレイに届きます。最新の料金は料金ページに表示されます。連携の開発では、サンドボックスへの切り替えを依頼してください。シミュレートされた番号とコードが返るので、ウォレットの資金に触れずに、フローの予行演習ができます。新しいアカウントの開設には、6桁のメールコードが必要です。チームが希望すれば、Googleサインインも使えます。

よくある質問

OTP RouteのAPIで、チャドの国IDは何ですか?

POST /api/v1/activations の country フィールドと、価格のクエリで td を使います。

現地のSIMなしで、アプリのチャド向けサインアップフローをテストできますか?

はい。OTP Gatewayで+235番号を注文してアプリに入力し、ダッシュボード、API、またはWebhookでコードを読み取ります。

+235番号は、どのくらいの間使えますか?

1回のアクティベーションは20分間開いており、コード1回分に対応します。その後は、新しく注文してください。

SMSが届かなかった場合でも、支払いは発生しますか?

いいえ。ウィンドウが閉じるまでにメッセージが届かなかった場合や、キャンセルした場合は、金額が自動的にウォレットへ返金されます。

チャドの番号では、トランクプレフィックスを取り除く必要がありますか?

いいえ。チャドにはトランクプレフィックスがないため、保存する形式は +235 に8桁の国内番号を続けたものです。

チャドの番号を、あとのログインのために保持できますか?

セルフサービスではできません。長期利用のDedicated Numbersは米国とカナダにのみあります。チャドについては、チームにメールで何が可能かを問い合わせてください。

利用ルールはありますか?

はい。各サービスの規約と、OTP Routeの利用規定(Acceptable Use Policy)を守ってください。ゲートウェイは、自社の正当なプロダクトとアカウントのテストや運用のためのものです。

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