独自の NNID を使用してキャンペーンを移行する
これらの移行手順は、10DLC キャンペーン を NTT CPaaS に移行し、独自の Net Number ID (NNID) で独自の番号を引き続きホストしたい Campaign Service Provider (CSP) および Connectivity Network Provider (CNP) のお客様を対象としています。
このガイドは、独自の番号をホストし、独自の NNID を持っている場合にのみ適用されます。CSP/CNP でない場合は、アカウント マネージャーに連絡して、移行オプションについて話し合ってください。
NTT CPaaSにNNIDを代行して管理する場合は、「NTT CPaaS NNIDを使用したキャンペーンの移行」ガイドを参照してください。
資格
開始する前に、次の資格基準を満たしていることを確認してください。
| 条件 | 形容 |
|---|---|
| CSP/CNP の状態 | CSP/CNP のみが The Campaign Registry (TCR) エコシステム内でキャンペーンを移行できます。 |
| OSRアクセス権を持つ独自のNNID | 独自の NNID と、オペレーター サービス レコード(OSR)を使用して番号を上書きおよび更新できる機能が必要です。 |
前提条件
移行を開始する前に、以下を完了して確認します。
- NNID のセットアップとキャリア設定
- 番号インポートの有効化
- 番号プール (該当する場合)
- 移行 API の有効化
個人事業主のキャンペーンを移行する場合は、個人事業主で追加設定を完了してから移行手順に進みます。
NNIDのセットアップ
NTT CPaaS に、使用したい NNID を以下とともに提供します。
NTT CPaaSで使用するネットナンバーから新しいNNIDを調達します。専用の NNID により、移行フローが簡素化され、モバイル発信(MO)トラフィック ルーティングを完全に制御できます。
- 署名済みの権限付与書(LOA)
- 記入済みのT-Mobile NNIDリクエストフォーム
NTT CPaaSは、NNID設定の要求をキャリアに転送します。リードタイムは約1ヶ月です。
番号のインポートを有効にする
NNIDは自分で管理しているので、NTT CPaaS APIを使って自分で番号をインポートすることができます。アカウントマネージャーは、まずアカウントでセルフサービス番号のインポートを有効にする必要があります。
番号プール (該当する場合)
キャンペーンで番号プーリングを使用しない場合は、このセクションをスキップしてください。
移行前に、すべての番号プールを事前に設定し、NTT CPaaS プラットフォームにインポートする必要があります。番号プールは移行できないため、移行する前に新しいプールを作成する必要があります。
NTT CPaaSを通じて番号プールのリクエストを送信します。番号プールをリクエストするには、番号プールリクエストフォーム(アカウントマネージャーから提供)に必要事項を記入し、NTT CPaaSチームに送信して処理してください。
番号プールに設定された NNID は、移行で番号に割り当てる NNID と一致する必要があります。NNID が一致しない場合、番号プールは正しく機能せず、移行は失敗します。続行する前に、要求された番号プールが移行で使用される新しい NNID を共有していることを確認します。
移行 API の有効化
NTT CPaaS キャンペーン移行 API エンドポイントを呼び出すには、移行サービスへの API アクセスがアカウントで有効になっている必要があります。この有効化は、アカウントマネージャーを通じてリクエストしてください。有効にすると、以下の移行手順で説明されているように、移行要求をトリガーできます。
移行プロセスは、NTT CPaaS が完了し、すべての前提条件を確認した後にのみ開始してください。
移行手順
移行は 6 つのステップのプロセスに従います。キャンペーンは、次のステータスを経由します。
1. NTT CPaaSプラットフォームに番号をインポートする
キャンペーンに関連付けられているすべての番号を NTT CPaaS プラットフォームにインポートします。これにより、移行要求中に番号を選択できるようになります。
次の Numbers API エンドポイントを使用して、数値をインポートします。
リクエストの例:
要求パラメータ:
| パラメーター | 種類 | 必須 | 形容 |
|---|---|---|---|
numbers | 配列 | はい | インポートする電話番号のリスト。 |
country | 文字列 | はい | 番号の国コード (例: "US")。 |
type | 文字列 | はい | 数値タイプ。10DLC番号には VIRTUAL_LONG_NUMBER を使用します。 |
capabilities | 配列 | はい | 番号の機能 (SMS、MMS など)。 |
skipOsrUpdate | ブール値 | はい | 独自の NNID を管理するため、インポート中に OSR の更新をスキップするには、 true に設定します。 |
このエンドポイントは、独自の NNID を使用して米国番号を移行するクライアントのみが使用できます。独自の NNID を管理していない場合は、アカウント マネージャーに問い合わせて、番号のインポートに関するサポートを受けてください。
2. TCRによるNTT CPaaSへのキャンペーン選出
次のエンドポイントを呼び出して、TCR で移行を開始します。
NTT CPaaS CNP ID は OPMKT です。詳細については、TCR CSP API ドキュメント を参照してください。
3. OSRレコードを更新する
番号のOSRレコードを確認し、正しい番号で更新します。
- NNIDの
- キャンペーン ID
- SubID (該当する場合)
- 文脈
OSR レコードの NNID を切り替えると、ダウンタイムが始まります。移行が完全に完了するまで、番号はメッセージを送受信できません。このステップを慎重に計画し、影響を最小限に抑えるためにチームと調整してください。
4. NTT CPaaS移行APIを呼び出す
TCRでNTT CPaaSへのキャンペーンを選択し、OSRレコードを更新した後、NTT CPaaS移行エンドポイントをトリガーします。
リクエストの例:
要求パラメータ:
| パラメーター | 種類 | 必須 | 形容 |
|---|---|---|---|
name | 文字列 | はい | キャンペーンの名前。 |
externalCampaignId | 文字列 | はい | TCR キャンペーン ID。 |
numberPoolID | 文字列 | いいえ | このキャンペーンに関連付ける番号プール ID。キャンペーンで番号プーリングを使用する場合にのみ必要です。NTT CPaaSプラットフォームで事前設定する必要があります。 |
numbers | 配列 | はい | 本キャンペーンの電話番号一覧です。要求ごとに最大 200 個の番号。 |
isClientManageNnid | ブール値 | はい | true に設定します。独自の NNID を管理し、すべての OSR 更新を処理します。 |
応答の例:
応答フィールド:
| 畑 | 形容 |
|---|---|
id | このキャンペーンに割り当てられた一意の NTT CPaaS UUID。この ID は、後続のすべての参照に使用します。 |
applicationId | キャンペーンのアプリケーション コンテキスト (デフォルトは default)。 |
name | 要求で指定されたキャンペーン名。 |
createdDate | 移行要求が作成されたときのタイムスタンプ (ISO 8601)。 |
stage | キャンペーンの現在のステータス。送信直後の IN_MIGRATION を表示します。 |
externalCampaignId | 元の TCR キャンペーン ID。 |
type | キャンペーンタイプ。10DLC 移行の EXTERNAL_TEN_DIGIT_LONG_CODE を示します。 |
5. 移行中
移行リクエストを送信すると、キャンペーンは 移行中 ステータスに移行します (API 応答の "stage": "IN_MIGRATION" で確認されます)。このフェーズでは、番号はオフラインになります。NTT CPaaSが移行を処理する間、お客様からのアクションは必要ありません。通常、これには数分かかります。
6. 移行完了:NTT CPaaSへのトラフィック切り替え
NTT CPaaSは、TCRからキャンペーンを自動的に受け入れ、キャリアにプロビジョニングし、Webhookイベントを通じて通知します。Webhook ペイロードには次のものが含まれます。
- 'campaignStatus=登録済み'
- 関連する NTT CPaaS UUID
REGISTEREDのWebhookを受け取ったら、トラフィックをNTT CPaaSに切り替えます。移行が完了し、ダウンタイムが終了します。
個人事業主
個人事業主のキャンペーンでは、標準の移行プロセスに従う前に追加の設定が必要です。
TCR要件
個人事業主のキャンペーンを移行する前に、NTT CPaaS は CSP が次の TCR 要件を満たしていることを確認する必要があります。
- 個人事業主キャンペーンごとに1つの番号
- 1 日あたり最大 1,000 件のメッセージ
登録
NTT CPaaSは、CSPをT-Mobileに登録し、デフォルトのキャンペーンを作成します。この既定のキャンペーンは、CSP から移行されたすべての個人事業主キャンペーンの親です。
- CSPは、TCRを通じてNTT CPaaSに1つの個人事業主キャンペーンを共有します。
- NTT CPaaSは、デフォルトのキャンペーンを作成し、番号プールを割り当てます。
- それ以降のすべての個人事業主キャンペーンは、このデフォルトキャンペーンにリンクされます。
デフォルトのキャンペーン設定が完了し、確認されたら、上記の標準的な [移行手順] (#migration の手順) に従ってください。
Webhook イベントをサブスクライブする
キャンペーンのステータス変更通知を受け取るには、次のいずれかでサブスクライブします。
- NTT CPaaS Web インターフェイス: サブスクリプション ドキュメント を参照してください。
- サブスクリプション API: サブスクリプション API のドキュメントを参照してください
ベストプラクティス
-
Start small. いくつかの少量のキャンペーンから始めてプロセスを学習し、NTT CPaaS が問題を迅速に解決できるようにします。
-
事前に共有してください。 移行を計画しているキャンペーンと関連番号のリストを事前に NTT CPaaS に提供します。
-
OSR を確認します。 各移行バッチを開始する前に、OSR レコードを再確認してください。