QA・ローンチ・地域運用のための、コートジボワール+225認証番号

コートジボワールの電話番号は何が変わり、どう保存すべきですか?

コートジボワールでは2021年初めに加入者番号が8桁から10桁に変更されたため、それ以前に書かれたテストフィクスチャや検証ルールは、気づきにくい失敗の原因になりがちです。現在の国内番号は10桁で、携帯番号は01、05、07のいずれかで始まります。

エンジニアが見落としやすいのは、この先頭のゼロがトランクプレフィックスではないという点です。加入者番号の一部であり、国際形式でも残るため、コートジボワールの携帯番号はE.164で+225 07 xx xx xx xxのようになります。

• +225に10桁すべてを続けた完全な文字列を保存し、スペースは表示するときにだけ加えます。
• +225の入力に対して先頭のゼロを取り除く汎用ルールは無効にしてください。9桁の値になり、どのネットワークでもルーティングされません。
• 8桁の入力は旧形式として扱い、欠けているプレフィックスを推測せず、ユーザーに再入力を求めます。
• 西アフリカの番号計画のメタデータは時々変わるため、電話番号ライブラリを最新に保ちます。

プロダクトやQAのチームが、+225番号に対してテストするのはなぜですか?

アビジャンはフランス語圏西アフリカの商業の中心であり、同地域のフランス語圏へ進出する企業にとって、コートジボワールは最初の拠点になることがよくあります。+225番号をテスト計画に加える典型的な理由は次のとおりです。

• 市場ローンチ:マーケティングの開始前に、現地の番号で登録、ログイン、アカウント復旧がエンドツーエンドで動くことを確認する。
• ローカライズQA:公用語はフランス語なので、グローバルアプリからの認証SMSはフランス語で届くことが多く、アカウントのロケールによっては英語で届きます。決まったフレーズに一致させるのではなく、数字を抽出してください。
• ウォレットや決済のオンボーディング:モバイルマネーが広く使われており、多くの金融プロダクトが電話番号を顧客の主要な本人情報として扱います。このパターンはフィンテックのオンボーディングガイドで解説しています。
• 地域運用:セネガルのような近隣市場をサポートするチームは、同じスイートからコートジボワールのチェックも実行することがよくあります。

コートジボワールの番号にコードを配信できるサービスは何ですか?

コートジボワールのライブカタログには、800を超えるサービスが掲載されています。現在のスナップショットで人気のあるルートには、WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、X (Twitter)、ChatGPT (OpenAI)、Microsoft & Outlook、LinkedIn、Uber、Signal、Viberなどがあります。

在庫は1日を通して変動するため、どんな一覧も出発点と考え、現時点で注文できるものはAPIに問い合わせてください。また、同じ組み合わせでもサービスごとに価格が異なることがあるため、表に載せるのではなくライブで提示しています。

コートジボワールOTP APIのフローは、実際にはどうなりますか?

HTTPクライアントをhttps://otproute.com/api/v1に向け、開発者コンソールで作成したor_live_のBearerキーで認証します。コートジボワールの注文での国IDはciです。

テスト実行は通常、GET /api/v1/balanceから始めます。これにより、ウォレットが空の場合にジョブが最初の段階で失敗します。次に、GET /api/v1/prices?country=ci&service=<id>で、現在の価格と、その組み合わせの在庫があるかを確認します。注文そのものは、{"service": "whatsapp", "country": "ci"}のような本文を付けたPOST /api/v1/activationsで行い、レスポンスにはアクティベーションIDと、自社アプリに入力する+225番号が含まれます。

その後はGET /api/v1/activations/{id}をポーリングするか、並列スイートにはより適した方法として、Webhookでactivation.sms_received、activation.expired、activation.cancelledを購読します。各配信はX-OTPRoute-Signatureヘッダー(t=<unix>,v1=<hex>)で署名されています。エンドポイントのシークレットで<t>.<raw body>のHMAC-SHA256を再計算し、定数時間で比較して、古いタイムスタンプは破棄してください。詳しくはHMACの解説とAPIドキュメントをご覧ください。制限は1アカウントあたり毎分300リクエストで、SMS認証APIのテストハーネスには十分です。

コードを書かない人でも、+225番号を注文できますか?

はい。運用担当者や代理店はダッシュボードを好むことが多く、これはAPIと同じOTPルーティングのルールに従っています。

1. サインアップで、メールアドレスと6桁のコード、またはGoogleでアカウントを作成します。
2. USDウォレットに資金を追加します。
3. コートジボワールを選び、次に認証したいサービスを選びます。確定前に価格が表示されます。
4. 番号をアプリの電話番号欄にコピーして、コードをリクエストします。
5. SMSを受信すると、すぐにアクティベーションカードに表示されます。

アクティベーションは20分間有効です。何も届かない場合や、先にキャンセルした場合は、全額が自動的にウォレットに返金されます。

コートジボワールのコードが届かない場合は、何を試せばよいですか?

コードが届かない原因は、たいていありふれたものです。問い合わせる前に、次の点を確認してください。

• サービスによっては、特定の国やアカウントの種類で仮想番号を拒否します。返金はまさにそのケースのためにあります。
• 送信元によってはメッセージをキューに入れるため、1分でキャンセルせず、20分のウィンドウが終わるまで待ちます。
• 時間を置いて再試行するか、テストで可能なら、同じサービスで別の国のルートを試します。
• 数秒ごとに注文を繰り返さないでください。再試行の間隔を空けることで、ウォレットとルートの両方を健全に保てます。

必ず各サービスの利用規約を守ってください。OTP Routeの利用規定(Acceptable Use Policy)はすべての注文に適用されます。

コートジボワールの長期回線はありますか?また、課金はどうなっていますか?

コートジボワール向けのセルフサービスの長期番号はありません。専用回線はアメリカとカナダ向けの製品で、月額$1.95からです。継続して使えるコートジボワールの回線が必要な場合は、[email protected]にメールで問い合わせてください。ただし、提供の可否は現地の規制によるため、実現できない場合もあります。

課金は、月額料金もプランの選択もない、前払いのUSDウォレット1つによる従量課金です。コートジボワールのテスト予算は、カード、またはUSDT/USDCでチャージでき、入金のたびに発行されるPDF請求書は、アカウント所有者の受信ボックスに届きます。連携作業では、ご依頼に応じて開発用アカウントをサンドボックスに切り替えられ、ウォレットの資金に触れずに、シミュレートされた番号とコードでフロー全体を実行できます。最新の料金は料金ページにあります。

よくある質問

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

はい。テストするサービス用の+225番号をOTP Gatewayで注文し、登録フォームに入力して、ダッシュボードまたはAPIでコードを読み取ります。

番号を保存するとき、+225の後のゼロは取り除くべきですか?

いいえ。2021年の変更以降、先頭のゼロは10桁のコートジボワールの番号の一部であり、E.164形式で保存するときも残す必要があります。

OTP Route APIでのコートジボワールの国IDは何ですか?

ciです。POST /api/v1/activationsを呼び出すときや、料金を照会するときに、countryフィールドに指定します。

コートジボワールのコードが届かなかった場合、課金されますか?

いいえ。課金されるのはコードが届いた場合のみです。期限切れやキャンセルになったアクティベーションは、全額がウォレットに返金されます。

認証SMSは何語で届きますか?

送信するサービスによって決まりますが、コートジボワールのアカウントではフランス語と英語が最も一般的です。文言に一致させるのではなく、数字のコードを抽出してください。

今後のログイン用に、同じ+225番号を保持できますか?

セルフサービスの製品としてはできません。OTP Gatewayの番号は1コード分だからです。長期のDedicated Numbersを即時に提供しているのはアメリカとカナダのみで、コートジボワールについてはサポートにメールでお問い合わせいただけます。

連携を構築している間、ウォレットの資金を使わないようにするには?

開発用アカウントにサンドボックスモードを依頼してください。シミュレートされた番号とコードが返されるので、Webhookとポーリングをエンドツーエンドでテストできます。

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