Logo
CTRLK
Logo
CTRLK
無料で試す
すべての製品を表示
概要
10DLC登録
ブランド
キャンペーン
スループット
移行ガイド
概要
10DLC 番号を移行する
NTT CPaaS NNIDを使用したキャンペーンの移行
独自の NNID を使用してキャンペーンを移行する
政治的なユースケース
却下理由マトリクス

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 NNIDを使用して10DLCキャンペーンを移行するCSP/CNPのお客様を対象としています。

独自の NNID を管理している場合は、代わりに 独自の NNID を使用してキャンペーンを移行する ガイドを参照してください。

資格

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

条件形容
CSP/CNP の状態CSP/CNP のみが The Campaign Registry (TCR) エコシステム内でキャンペーンを移行できます。
権限付与書NTT CPaaS が番号を NTT CPaaS NNID に移動することを許可する、30 日以内の署名済みの権限付与書 (LOA) を提出する必要があります。

前提条件

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

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

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

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

手記

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


移行手順

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


ペンディング→移行中→Registered (登録完了)

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

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

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

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

リクエストの例:

json
1curl --location 'https://api-ny2.infobip.com/numbers/2/numbers/import' \
2--header 'Content-Type: application/json' \
3--header 'Authorization: App {apiKey}' \
4--data '{
5 "numbers": [
6 "19546899283"
7 ],
8 "country": "US",
9 "type": "VIRTUAL_LONG_NUMBER",
10 "capabilities": [
11 "SMS",
12 "MMS"
13 ],
14 "skipOsrUpdate": true
15}'

要求パラメータ:

パラメーター種類必須形容
numbers配列はいインポートする電話番号のリスト。
country文字列はい番号の国コード (例: "US")。
type文字列はい数値タイプ。10DLC番号には VIRTUAL_LONG_NUMBER を使用します。
capabilities配列はい番号の機能 (SMS、MMS など)。
skipOsrUpdateブール値はいNTT CPaaSがNNIDを管理するため、インポート中にOSRの更新をスキップするには true に設定します。
大事な

アカウントでセルフサービス番号のインポートが有効になっていない場合は、アカウントマネージャーにお問い合わせください。


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

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

json
POST /campaign/{campaignID}/migrateCnp/{upstreamCnpID}
手記

NTT CPaaS CNP ID は OPMKT です。詳細については、TCR CSP API ドキュメント を参照してください。


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

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

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

リクエストの例:

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

要求パラメータ:

パラメーター種類必須形容
name文字列はいキャンペーンの名前。
externalCampaignId文字列はいTCR キャンペーン ID。
numberPoolID文字列いいえこのキャンペーンに関連付ける番号プール ID。該当しない場合は null に設定します。キャンペーンの番号プールが必要な場合は、まずアカウントマネージャーにお問い合わせください。
numbers配列はい本キャンペーンの電話番号一覧です。要求ごとに最大 200 個の番号。
isClientManageNnidブール値はいfalseに設定すると、NTT CPaaS がユーザーに代わって NNID と OSR の更新を管理します。

応答の例:

json
1{
2 "id": "44e8c5fc-1f17-4f4c-9519-6606c907075f",
3 "referenceId": null,
4 "applicationId": "default",
5 "entityId": null,
6 "name": "migrateCampaignCOJD655",
7 "createdDate": "2026-03-04T09:08:43Z",
8 "lastModifiedDate": "2026-03-04T09:08:43Z",
9 "stage": "IN_MIGRATION",
10 "priority": null,
11 "campaignFeedback": null,
12 "externalCampaignId": "COJD655",
13 "numbers": null,
14 "externalDocuments": [],
15 "numberKeys": [],
16 "numberPreviews": [],
17 "type": "EXTERNAL_TEN_DIGIT_LONG_CODE"
18}

応答フィールド:

畑形容
idこのキャンペーンに割り当てられた一意の NTT CPaaS UUID。この ID は、後続のすべての参照に使用します。
applicationIdキャンペーンのアプリケーション コンテキスト (デフォルトは default)。
name要求で指定されたキャンペーン名。
createdDate移行要求が作成されたときのタイムスタンプ (ISO 8601)。
stageキャンペーンの現在のステータス。送信直後の IN_MIGRATION を表示します。
externalCampaignId元の TCR キャンペーン ID。
typeキャンペーンタイプ。10DLC 移行の 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 更新を処理してください。

大事な

NTT CPaaSがOSRレコードを更新するとすぐに、ダウンタイムが始まります。移行が完了し、トラフィックが NTT CPaaS に切り替わるまで、番号はメッセージの送受信を停止します。このステップを慎重に計画し、影響を最小限に抑えるためにチームと調整してください。


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

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

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

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

大事な

REGISTEREDのWebhookを受け取ったら、トラフィックをNTT CPaaSに切り替えます。移行が完了し、ダウンタイムが終了します。


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

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


ベストプラクティス

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

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

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






← 10DLC 番号を移行する独自の NNID を使用してキャンペーンを移行する →

Logo

ご不明点は

サポートまでお問い合わせ

ください

© NTT DOCOMO BUSINESS X,Inc.