NTT CPaaS NNIDを使用したキャンペーンの移行

これらの移行手順は、NTT CPaaS Net Number ID (NNID) を使用して 10DLC キャンペーン を NTT CPaaS に移行する Campaign Service Provider (CSP) および Connectivity Network Provider (CNP) のお客様を対象としています。NTT CPaaSは、合理化されたプロセスを提供し、NNIDとオペレーターサービスレコード(OSR)の更新を管理し、移行を確実に成功させるためにお客様と協力します。

資格

開始する前に、次の資格基準を満たしていることを確認してください。

前提条件

移行プロセスを開始する前に、次の前提条件を完了してください。移行は、NTT CPaaSが完了し、すべての項目を確認した後にのみ開始してください。

• 番号のインポートの有効化。 Numbers API (opens in a new tab) を使用する前に、アカウントでセルフサービス番号のインポートを有効にする必要があります。この有効化は、アカウントマネージャーを通じてリクエストしてください。

• 番号プール(該当する場合)。 キャンペーンで番号プールを使用している場合は、キャンペーンに追加の修正が必要なため、アカウントマネージャーにお問い合わせください。番号プールはNTT CPaaSが管理しています。

• 移行 API の有効化。 移行サービスへの API アクセスには、アカウントが有効になっている必要があります。この有効化は、アカウントマネージャーを通じてリクエストしてください。有効にすると、以下の移行手順で説明されているように、移行要求をトリガーできます。

移行手順

移行は 6 つのステップのプロセスに従います。キャンペーンは、次のステータスを経由します。

1. NTT CPaaSプラットフォームに番号をインポートする

キャンペーンに関連付けられているすべての番号を NTT CPaaS プラットフォームにインポートします。これにより、移行要求中に番号を選択できるようになります。

次の Numbers API エンドポイントを使用して、数値をインポートします。

POST https://api-ny2.infobip.com/numbers/2/numbers/import

リクエストの例:

curl --location 'https://api-ny2.infobip.com/numbers/2/numbers/import' \
--header 'Content-Type: application/json' \
--header 'Authorization: App {apiKey}' \
--data '{
    "numbers": [
        "19546899283"
    ],
    "country": "US",
    "type": "VIRTUAL_LONG_NUMBER",
    "capabilities": [
        "SMS",
        "MMS"
    ],
    "skipOsrUpdate": true
}'

要求パラメータ:

2. TCRによるNTT CPaaSへのキャンペーン選出

次のエンドポイントを呼び出して、TCR で移行を開始します。

POST /campaign/{campaignID}/migrateCnp/{upstreamCnpID}

3. NTT CPaaS移行APIを呼び出す

TCRでNTT CPaaSへのキャンペーンを選択したら、NTT CPaaS移行エンドポイントをトリガーします。

POST https://{baseUrl}/number-registration/1/campaigns/migrate

リクエストの例:

curl --location 'https://{baseUrl}/number-registration/1/campaigns/migrate' \
--header 'Content-Type: application/json' \
--header 'Authorization: App {apiKey}' \
--data '{
    "name": "migrateCampaignCOJD655",
    "externalCampaignId": "COJD655",
    "numberPoolID": null,
    "numbers": ["19168361160"],
    "isClientManageNnid": false
}'

要求パラメータ:

応答の例:

{
    "id": "44e8c5fc-1f17-4f4c-9519-6606c907075f",
    "referenceId": null,
    "applicationId": "default",
    "entityId": null,
    "name": "migrateCampaignCOJD655",
    "createdDate": "2026-03-04T09:08:43Z",
    "lastModifiedDate": "2026-03-04T09:08:43Z",
    "stage": "IN_MIGRATION",
    "priority": null,
    "campaignFeedback": null,
    "externalCampaignId": "COJD655",
    "numbers": null,
    "externalDocuments": [],
    "numberKeys": [],
    "numberPreviews": [],
    "type": "EXTERNAL_TEN_DIGIT_LONG_CODE"
}

応答フィールド:

4. 移行中: 現在のプロバイダー経由で送信を続行する

移行リクエストを送信すると、キャンペーンは 移行中 ステータスに移行します (API 応答の "stage": "IN_MIGRATION" で確認されます)。このフェーズでは、現在のアップストリームプロバイダーを介してトラフィックを送信し続けます。NTT CPaaSが移行を処理する間、何もする必要はありません。

5. NTT CPaaSがOSRレコードを更新

NTT CPaaS は、番号の OSR レコードの NNID を自動的に上書きしようとします。番号が OSR の自動上書きを許可しないプロバイダーに属している場合、NTT CPaaS 登録チームは、提供された LOA を使用して OSR 更新の正式な承認を要求します。

この手順の詳細については、アカウント マネージャーに相談し、移行予定の番号の共有リストを使用してください。登録チーム directly にも連絡できます。

キャンペーンが長期間 移行中 ステータスのままになっている場合は、[登録 team](mailto:cpaas_registrations@infobip.com に連絡して、番号の OSR 更新を処理してください。

6. 移行完了:NTT CPaaSへのトラフィック切り替え

NTT CPaaSは、TCRからキャンペーンを自動的に受け入れ、キャリアにプロビジョニングし、Webhookイベントを通じて通知します。Webhook ペイロードには次のものが含まれます。

• 'campaignStatus=登録済み'
• 関連する NTT CPaaS UUID

キャンペーンのすべての番号が NTT CPaaS NNID に割り当てられると、キャンペーンは「登録済み」ステータスに移行します。

Webhook イベントをサブスクライブする

キャンペーンのステータス変更通知を受け取るには、次のいずれかでサブスクライブします。

• NTT CPaaS Web インターフェイス: サブスクリプション ドキュメント を参照してください。
• サブスクリプション API: サブスクリプション API のドキュメント (opens in a new tab)を参照してください

ベストプラクティス

• Start small. いくつかの少量のキャンペーンから始めてプロセスを学習し、NTT CPaaS が問題を迅速に解決できるようにします。

• 事前に共有してください。 移行を計画しているキャンペーンと関連番号のリストを事前に NTT CPaaS に提供します。

• **OSRの更新を調整する。NTT CPaaSはNNIDとOSRの更新を管理するため、LOAが最新(30日以内)であり、完全な番号リストをアカウントマネージャーに伝えていることを確認してください。