リソースと関連付けを理解する
リソースとは、NTT CPaaSの通信資産(電話番号、送信者ID、メールドメイン)で、購入、登録、トラフィック送信に使用します。CPaaS X では、リソースとトラフィック (インバウンドとアウトバウンド) の両方をアプリケーションやエンティティに関連付けて、請求、レポート作成、ルーティングを行うことができます。CPaaS X でアウトバウンド・メッセージングの取得、関連付け、構成、およびアウトバウンド・メッセージングのリソースを使用する方法について説明します。
リソースとは [#what-are-resources]
リソースは、一般的なNTT CPaaS通信資産です。
- 電話番号: 仮想ロングナンバー (VLN)、ショート コード、SMS、MMS、WhatsApp のフリーダイヤル番号
- 英数字の送信者 ID: SMSのテキスト識別子
- メールドメイン: メール送信用に登録済みドメイン
- デジタルチャネル送信者: Viber、RCS、Messenger、Telegram、Instagram、およびその他のデジタルメッセージングプラットフォームアカウント
次の図は、クライアントがさまざまなユースケースとリソースを使用する顧客を持っている、使用可能なリソースタイプを示しています。
基本的な概念、リソースの種類、およびリソースの要求方法については、「リソースと数値の概要」を参照してください。
リソースの取得と関連付け [#resource-acquisition-and-association]
リソースを購入または登録すると、同じ要求で関連付けを指定しない限り、既定では関連付けが解除されます。設定が変更された場合は、後で関連付けを調整できますが、変更はその時点からのみ適用され、過去のトラフィックには遡及的に適用されません。以下に関連付けることができます。
- 特定のアプリケーションと特定のエンティティ: リソースを特定の環境内の特定の顧客に帰属させます。
- 特定のアプリケーションと任意のエンティティ: リソースを単一のエンティティに制限せずに、リソースをアプリケーションに帰属させます。
電話番号と英数字の送信者 ID の場合、関連付けにより顧客ごとのコスト配分が可能になります。リソースを異なるアプリケーションやエンティティに個別に追跡して請求する場合は、取得時にリソースを関連付ける必要があります。これらのリソースには、セットアップ料金と定期的な料金があり、それに応じて帰属して請求できます。
インバウンドメッセージングの場合、リソース取得時に指定した関連付けは、インバウンドメッセージ処理に自動的に適用されます。そのリソース上のすべての受信トラフィックは、追加の設定なしで、関連付けられたアプリケーション/エンティティで自動的にタグ付けされます。関連付けは、RCS 送信者ステータスの変更や送信者起動更新 Webhook などのサービス管理更新にも使用されます。リソースタイプ(ショートコード、VLN、キーワード)別の詳細な構成については、インバウンドメッセージ処理を参照してください。
アウトバウンドメッセージングの場合、各APIリクエストでアプリケーションとエンティティを指定します。リソースの関連付けと送信戦略が設定されている場合、アプリケーション/エンティティおよびメッセージプロパティ (国、チャネル) に基づいて適切な送信者が自動的に選択されます。どちらの方法も アウトバウンド メッセージ送信 を参照してください。
送信戦略の場合、リソースの関連付けは自動送信者選択の基盤です。リソースをアプリケーションやエンティティにリンクし、送信戦略が宛先の国とチャネルに基づいてメッセージを適切な送信者にルーティングできるようにします。アソシエーションと戦略がどのように連携するかについては、 送信戦略を理解する を参照してください。
CPaaS Xの米国SMS数 [#usa-sms-numbers-resource-acquisition]
US SMS (10DLC、ショートコード、フリーダイヤル) の場合、すべての番号タイプで、トラフィックを送信する前にブランド登録、ブランド審査、キャンペーン承認が必要です。この登録プロセス中に、各番号を特定のアプリケーションおよびエンティティに関連付けて、CPaaS X セットアップで顧客ごとの請求とトラフィック アトリビューションを有効にすることができます。
このワークフローには、番号の購入、The Campaign Registry(TCR)へのブランドの登録、携帯電話会社からのキャンペーンの承認の取得、および番号をCPaaS Xアプリケーションおよびエンティティに関連付けることが含まれます。完全な調達ガイダンスとキャンペーン承認プロセスについては、 米国送信者登録について を参照してください。
リソースアソシエーションの作成と管理については、送信ストラテジーの設定(/cpaas-x/sending-strategies/configure#manage-resource-associations)を参照してください。
インバウンドメッセージ処理 [#inbound-message-handling]
受信メッセージのタグ付け方法は、リソースの種類と構成によって異なります。受信メッセージ処理を構成するには、 NTT CPaaS Web インターフェイスで、チャネルと番号 > 番号 に移動し、構成する番号を選択し、[チャネル] タブ (SMS など) を選択して、デフォルトの受信構成 設定にアクセスします。イン バウンド構成の管理 API エンドポイントを使用することもできます。
双方向リソース [#two-way-resources-inbound]
双方向メッセージングをサポートするすべてのリソース (番号、電子メール ドメイン、RCS 送信者、および選択したデジタル チャネル送信者) は、受信メッセージ ルーティングのアプリケーションおよびエンティティに関連付けることができます。設定時:
- リソースは、セットアップ中にアプリケーションに関連付けられ、オプションで特定のエンティティに関連付けられます。
- そのリソース上のすべての受信トラフィックには、関連付けられたアプリケーション/エンティティでタグ付けされます。
- 使用状況とレポートは、それに応じて帰属します。
**マルチテナントで最も一般的:**電話番号(すべての米国SMSタイプ:10DLC VLN、ショートコード、フリーダイヤル、および米国以外のVLN)は、専用で共有された割り当ての柔軟性のためです。
リソースの種類の完全な比較と、双方向メッセージングをサポートするチャネルについては、「リソースの種類」を参照してください。
専用番号を持つリソースとインバウンドトラフィック
数字のキーワード [#keywords-inbound]
異なるアプリケーション/エンティティのペアを持つ数値の各キーワードを設定します。これにより、1 つの番号で複数のビジネス ユニットまたは顧客にサービスを提供できます。
| 番号 | キーワード | 行き先 | ユースケース |
|---|---|---|---|
| +1-555-0001 | アラート | エンティティ A | 財務チーム |
| サポート | エンティティ B | サポートチーム | |
| プロモーション | エンティティ C | マーケティングチーム |
キーワードのしくみ、設定方法、およびキーワードがトリガーするアクションの詳細については、受信メッセージ処理の設定を参照してください。
キーワードを使用したリソースとインバウンドトラフィック
アウトバウンド メッセージの送信 [#outbound-message-sending]
メッセージを送信するときに、次の 2 つの方法でアプリケーションとエンティティを使用して送信トラフィックにタグを付けることができます。
| アスペクト | 明示的なタグ付け | 暗黙的なタグ付け (関連付け + 戦略) |
|---|---|---|
| 仕組み | すべての API 要求に applicationId や entityId を含め、送信者を指定します | すべての API 要求に applicationId や entityId を含めます。送信戦略は、アプリケーション/エンティティとメッセージのプロパティに基づいて適切な送信者を自動的に選択します。 |
| 送信者の選択 | 各要求で送信者を指定します | システムは、リソースの関連付けとメッセージのプロパティ (国、チャネル) に基づいて送信者を選択します |
| 最適な用途 | シンプルなセットアップ、シングルチャネル、送信者を完全に制御 | 大規模な複数国、複数チャネルの自動ルーティング |
| セットアップが必要 | なし。要求でパラメーターを渡します。 | リソースの関連付け + 送信戦略の構成 |
リソースとアウトバウンド トラフィック
ストラテジーと高度なルーティングパターンの詳細については、「送信ストラテジー」を参照してください。
リソースの所有権と割り当てモデル [#resource-ownership-and-allocation]
マルチテナント プラットフォームでは、顧客層に基づいてリソースを割り当てます。電話番号は当然、共有番号と専用番号の両方をサポートしますが(専用番号と共有番号を参照)、他のリソースタイプは専用番号のみである場合があります。
共有リソース
1 つのリソースが複数のエンティティによって使用されます。小規模な顧客にとって費用対効果が高い。各エンティティの使用状況は個別に追跡され、すべてのインバウンドトラフィックとアウトバウンドトラフィックが適切にアトリビュートされます。
例: 異なる顧客を異なるエンティティにルーティングするキーワードを含む単一の電話番号。
専用リソース
1 つのエンティティにのみ関連付けられたリソース。顧客自身の送信者 ID を使用したブランド化されたコミュニケーション。コストが高く、企業や大量の顧客に適しています。リソースレベルでの完全な分離。
例: 1 人の顧客のみに購入され、関連付けられた電話番号。
ハイブリッドアプローチ
Standard レベルの顧客向けの共有リソース、Premium レベルの専用リソース。階層型 SaaS(Software as a Service) プラットフォームの一般的な価格モデル。
例: 小規模な顧客は英数字の送信者を共有します。企業のお客様には専用の 10DLC 番号が割り当てられます。
クライアント環境間でのリソース分散