チュニジア(+216)SMS認証:開発者向けチェックリスト

+216番号を注文する前の事前チェックリストには何が必要ですか?

このリストを一度確認しておけば、チュニジアのテスト実行のほとんどはスムーズに進みます。

• APIキーの準備。 Developerコンソールでキーを作成します。ライブキーは or_live_ で始まります。
• ウォレットへの入金。 OTP Gatewayはプリペイドの米ドル残高から支払われます。GET /api/v1/balance でスクリプトから確認できます。
• Webhookへの到達性。 HTTPSエンドポイントを登録してシークレットを保管し、タイムスタンプのチェックが通るようにサーバーの時計が正確であることを確認します。
• 価格の確認。 テスト予定のサービスについて、GET /api/v1/prices?country=tn&service=<id> を呼び出します。
• 電話番号欄のテスト。 自社のフォームが、8桁のチュニジアの国内番号と、貼り付けられた +216 の国際形式の両方を受け付けることを確認します。
• パーサーの許容範囲。 アラビア語、フランス語、英語のメッセージ本文のどれでもコード抽出が機能することを確認します(後述)。
• 規約の確認。 自社のプロダクトのテスト、またはご自身の正当なアカウントの運用であり、サービスのルールとOTP Routeの利用規定(Acceptable Use Policy)に沿っていること。

チュニジアの番号はE.164でどのように整形されますか?

チュニジアはクローズドな番号計画で、すべての加入者番号は8桁、トランクプレフィックスはないため、国番号を付ける前に取り除くものはありません。E.164形式は、単純に +216 にその8桁を続けたものです。現地では xx xxx xxx のようにグループ分けして書くことが多いため、正規化の際にスペース、ドット、ダッシュを取り除いてください。先頭の数字の固定リストで検証するのは避けましょう。手書きの範囲表よりも、桁数のチェックと信頼できる電話番号ライブラリのほうが安全です。

チュニジアの認証SMSはどの言語で届きますか?

公用語はアラビア語で、日常的に話されるのはチュニジア・アラビア語、そしてフランス語はビジネス、行政、多くのアプリで一般的です。その結果、1回のテスト実行で、送信元と端末のロケールに応じて、フランス語、英語、アラビア語のコードを目にすることがあります。

アラビア語のメッセージはUnicode SMSとして送られ、数字の前後に右から左への方向マークが含まれることがあります。見えない文字を取り除いたうえで、ASCIIの4〜8桁の数字列の最初の並びを取る正規表現なら、3つの言語すべてに対応できます。チームがチュニジアをテストマトリクスに加えるのは、通常、モロッコやアルジェリアとあわせたフランス語圏の北アフリカ向けローンチ、右から左のレイアウトのローカライズQA、あるいはヨーロッパに住むチュニジアの顧客にサービスを提供するためで、テスト用の+216番号はそのいずれにも使えます。

手順で見る:APIでチュニジアのOTPを受信する

現在のスナップショットでは、チュニジアには1,700を超えるサービスがあり、Facebook、WhatsApp、Instagram、Telegram、TikTok、Google (Gmail & YouTube)、Snapchat、Signal、LinkedIn、Discord、ChatGPT (OpenAI)、Microsoft & Outlook、Amazon、Uberなどが含まれます。空き状況は一日の中で変わるため、実行の開始時に、OTPルーティングのロジックが GET /api/v1/services と GET /api/v1/countries から取得するようにしてください。

1. POST /api/v1/activations に {"service": "facebook", "country": "tn"} を送り、アクティベーションIDを保存します。
2. 返された番号をテスト対象のアプリに入力し、コードの送信を起動します。
3. Webhookで activation.sms_received を処理します。X-OTPRoute-Signature(タイムスタンプ、ドット、生のボディのHMAC-SHA256)を検証し、古いタイムスタンプは拒否し、すでに処理したアクティベーションIDの重複は無視します。
4. Webhookを使わない場合は、1分300リクエストの上限を十分に下回る間隔で GET /api/v1/activations/{id} をポーリングします。
5. テストを中断する場合は、POST /api/v1/activations/{id}/cancel を呼び出します。

すべてのフィールドはAPIドキュメントに記載されており、パイプラインへの組み込み方はCIテストガイドで紹介しています。

手順で見る:ダッシュボードから

1. メールアドレスと6桁のコード、またはGoogleサインインでアカウントを作成し、TOTPの2要素認証を有効にします。
2. カードまたはUSDT/USDCで資金を追加します。
3. チュニジアを選び、続いてサービスを選び、表示された価格を確認します。
4. 注文して+216番号をコピーし、対象のアプリでコードを要求します。
5. チュニジアのコードがダッシュボードに表示されたらすぐにコピーして、テスト中の登録を完了します。

トラブルシューティング:+216のコードが届かない場合は?

各アクティベーションは20分間実行され、課金されるのはコードが届いたときだけです。有効時間が切れた場合やキャンセルした場合は、全額がウォレットに戻ります。

• 何も届かなかった場合:有効時間が終わるまで待ち、テストが許せば、時間をおいて、または別のサービスルートで再試行します。
• サービスが番号を拒否した場合:サービスによっては仮想番号が拒否されます。返金はそのケースをカバーします。
• Webhookは無反応だが、ダッシュボードにはコードがある場合:署名チェックが失敗している可能性が高いです。再シリアライズしたJSONではなく、生のボディと比較し、時計のずれも確認してください。
• 失敗が何度も続く場合:バックオフを追加してください。短い間隔で再注文しても、ほとんど効果はありません。

チュニジアの長期回線、課金、サンドボックス

チュニジア向けのセルフサービスの長期番号はありません。専用番号は米国とカナダ向けの製品で、月額$1.95からです。+216の長期回線が必要な場合は、[email protected] にメールしてください。提供できるかどうかは現地の規則次第です。

ウォレットは従量課金で月額料金はなく、チャージごとにPDF請求書がメールで届きます。開発用アカウントはサンドボックスモードを申請でき、シミュレートされた番号とコードにより、残高を使わずに連携を検証できます。

よくある質問

チュニジアのSIMなしで、チュニジアの登録フローをテストできますか?

はい。OTP Gatewayの+216番号を使い、コードをダッシュボード、またはSMS認証APIとWebhookで受け取ってください。

チュニジアの番号に、取り除くトランクプレフィックスはありますか?

いいえ。チュニジアの番号は8桁でトランクプレフィックスがないため、E.164形式は+216にその桁を付けるだけです。

チュニジアOTP APIの国IDは何ですか?

価格のクエリと POST /api/v1/activations のリクエストボディで tn を使います。

チュニジアの認証番号はいくらですか?

$0.20/コードからです。正確な金額はサービスによって異なり、注文前にダッシュボードと価格エンドポイントに表示されます。料金をご覧ください。

パーサーがアラビア語のOTPメッセージで失敗します。何を変えればよいですか?

Unicodeの方向マークを取り除き、前後の単語ではなく数字の並びをマッチさせてください。そうすれば、アラビア語、フランス語、英語の本文に同じルールが使えます。

後のログインのために+216番号を保持できますか?

セルフサービスではできません。Gatewayの番号で受け取れるのは1回分のコードです。すぐに利用できる長期回線は、米国とカナダにのみあります。

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