独自の NNID を使用してキャンペーンを移行する

これらの移行手順は、10DLC キャンペーン を NTT CPaaS に移行し、独自の Net Number ID (NNID) で独自の番号を引き続きホストしたい Campaign Service Provider (CSP) および Connectivity Network Provider (CNP) のお客様を対象としています。

資格

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

前提条件

移行を開始する前に、以下を完了して確認します。

• NNID のセットアップとキャリア設定
• 番号インポートの有効化
• 番号プール (該当する場合)
• 移行 API の有効化

NNIDのセットアップ

NTT CPaaS に、使用したい NNID を以下とともに提供します。

• 署名済みの権限付与書(LOA)
• 記入済みのT-Mobile NNIDリクエストフォーム

NTT CPaaSは、NNID設定の要求をキャリアに転送します。リードタイムは約1ヶ月です。

番号のインポートを有効にする

NNIDは自分で管理しているので、NTT CPaaS APIを使って自分で番号をインポートすることができます。アカウントマネージャーは、まずアカウントでセルフサービス番号のインポートを有効にする必要があります。

番号プール (該当する場合)

キャンペーンで番号プーリングを使用しない場合は、このセクションをスキップしてください。

移行前に、すべての番号プールを事前に設定し、NTT CPaaS プラットフォームにインポートする必要があります。番号プールは移行できないため、移行する前に新しいプールを作成する必要があります。

NTT CPaaSを通じて番号プールのリクエストを送信します。番号プールをリクエストするには、番号プールリクエストフォーム(アカウントマネージャーから提供)に必要事項を記入し、NTT CPaaSチームに送信して処理してください。

移行 API の有効化

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. OSRレコードを更新する

番号のOSRレコードを確認し、正しい番号で更新します。

• NNIDの
• キャンペーン ID
• SubID (該当する場合)
• 文脈

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

TCRでNTT CPaaSへのキャンペーンを選択し、OSRレコードを更新した後、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": "INFOBIP23",
    "numbers": ["19168361160"],
    "isClientManageNnid": true
}'

要求パラメータ:

応答の例:

{
    "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"
}

応答フィールド:

5. 移行中

移行リクエストを送信すると、キャンペーンは 移行中 ステータスに移行します (API 応答の "stage": "IN_MIGRATION" で確認されます)。このフェーズでは、番号はオフラインになります。NTT CPaaSが移行を処理する間、お客様からのアクションは必要ありません。通常、これには数分かかります。

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

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

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

個人事業主

個人事業主のキャンペーンでは、標準の移行プロセスに従う前に追加の設定が必要です。

TCR要件

個人事業主のキャンペーンを移行する前に、NTT CPaaS は CSP が次の TCR 要件を満たしていることを確認する必要があります。

• 個人事業主キャンペーンごとに1つの番号
• 1 日あたり最大 1,000 件のメッセージ

登録

NTT CPaaSは、CSPをT-Mobileに登録し、デフォルトのキャンペーンを作成します。この既定のキャンペーンは、CSP から移行されたすべての個人事業主キャンペーンの親です。

1. CSPは、TCRを通じてNTT CPaaSに1つの個人事業主キャンペーンを共有します。
2. NTT CPaaSは、デフォルトのキャンペーンを作成し、番号プールを割り当てます。
3. それ以降のすべての個人事業主キャンペーンは、このデフォルトキャンペーンにリンクされます。

デフォルトのキャンペーン設定が完了し、確認されたら、上記の標準的な [移行手順] (#migration の手順) に従ってください。

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

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

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

ベストプラクティス

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

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

• OSR を確認します。 各移行バッチを開始する前に、OSR レコードを再確認してください。