リソース

CPaaS Xでは、リソースとは、Infobipサービスでエンドツーエンドの通信を可能にするために必要な資産を指します。これらには、ショートコード、仮想ロングナンバー(または米国の10桁のロングコード)、英数字の送信者、メールドメイン、ChatApp IDなどが含まれます。これらのリソースは、複数のチャネル間でスケーラブルなコミュニケーションを促進するために、Infobip を通じて購入または登録されます。

リソース・アソシエーションは、以下のチャネルで使用できます。

• メール
• MMS
• SMS

リソースの関連付けを管理する

リソースが取得され、アプリケーション や エンティティ が作成されたら、ユース ケースに基づいてリソースをアプリケーションやエンティティに関連付けることができます。たとえば、これは送信者戦略を使用する場合に必要です。

アプリケーションおよびエンティティ API (opens in a new tab) または Web インターフェイス (opens in a new tab)を使用して、リソースをリンクしたり、アプリケーションまたはエンティティとのリソースの関連付けを構成したりできます。このプロセスは、リソースの関連付けと呼ばれます。

リソースの関連付けの作成と表示

**API **

必要なリソースを取得し、アプリケーションおよび/またはエンティティを作成した後、次の API 要求を使用してそれらをリンクおよび取得できます。

API	情報	依頼
リソースの関連付けを作成する (opens in a new tab)	リソースの関連付けを作成します。使用可能なリソースの種類: 番号、ドメイン、英数字の送信者。	POST /provisioning/1/associations
リソースの関連付けを取得する (opens in a new tab)	すべて のリソース関連付けのページ分割されたリストを取得します	GET /provisioning/1/associations
リソースの関連付けを取得する (opens in a new tab)	正確なリソースの関連付けを取得します	GET /provisioning/1/associations/single

Webインターフェイス

すべてのリソース (登録番号、英数字の送信者、およびドメイン構成) を表示するには、次の手順を実行します。

1. Infobip Web インターフェイス (opens in a new tab)で、開発者ツール > アプリケーションとエンティティ に移動します。

2. [リソース] タブを選択します。

3. 数値、英数字の送信者、ドメインを切り替えて、リソースの種類で並べ替えます。また、フィルターを使用してリソースを検索することもできます。

4. リソースを選択して、アプリケーションまたはエンティティに関連付けます。

リソース・アソシエーションの削除

リソースの関連付けは、API または Web インターフェイスを使用していつでも削除できます。リソース・アソシエーションを削除しても、リソース自体は削除されないことに注意してください。他の構成で再利用できます。

**API **

リソースの関連付けを削除するには、次の API 要求を使用します。

API	情報	依頼
リソース・アソシエーションの削除 (opens in a new tab)	リソース・アソシエーションを削除します (リソースは削除しません)。	DELETE /provisioning/1/associations

Webインターフェイス

Web インターフェイスを使用してリソースの関連付けを削除するには、次の手順に従います。

1. Infobip Web インターフェイス (opens in a new tab)で、開発者ツール > アプリケーションとエンティティ に移動します。

2. 関連付けを削除するリソースを選択します。

3. リソースの詳細には、既存のすべての関連付けが表示されます。削除するリソースの関連付けを見つけて、ごみ箱アイコンを選択します .

例

次の例は、リソースとその使用状況の概要を示しています。

1. 異なる環境を持ち、それぞれが異なるリソースを使用するクライアント。

   

2. 複数の顧客を持ち、それぞれが異なるリソースを使用するクライアント。

   

リソースと送信トラフィック

送信トラフィックの場合、リソースを購入した後、それを関連付けるための 2 つのオプションがあります。

1. 送信要求内: リソースをアプリケーション、エンティティ、またはアプリケーション/エンティティのペアと共に要求に含めます。
2. (SMS と MMS のみ) 明示的な関連付け: 送信する前に、1 つ以上のリソースをアプリケーション、エンティティ、またはアプリケーションとエンティティのペアに関連付けます。この場合、アウトバウンド要求でリソースを指定する必要はありません。アプリケーション、エンティティ、またはアプリケーション/エンティティのペアのみを含める必要があります。送信戦略も作成する必要があることに注意してください。

明示的なリソースの関連付けは、クライアントごとのリソースの概要を提供しますが、送信戦略は、メッセージの送信時にこれらのリソースがどのように使用されるかを決定します。送信戦略とアプリケーション/エンティティの設定に基づいて、Infobip は適切なリソースを自動的に解決して選択します。

複数のリソースを明示的に関連付ける一般的なユース ケースは、送信者 リソースの選択の複雑さを Infobip プラットフォームにオフロードする場合です。1 回限りのセットアップを完了することで、送信者リソースをアプリケーション、エンティティ、またはアプリケーションとエンティティのペアに関連付け、送信者戦略を構成して、メッセージ送信時に残りの処理を Infobip に任せることができます。

リソースと受信トラフィック

受信トラフィックの場合、アプリケーションとエンティティの ID は、番号レベルと番号の受信構成レベルの両方で設定できます。受信構成レベルの設定は、受信メッセージをルーティングするときに、番号レベルのよりも優先されます。

アプリケーション ID とエンティティ ID を 数値レベル で設定するには:

1. Infobip Web インターフェイス (opens in a new tab)で、[チャネルと番号] >[番号]** に移動します。

2. 数値を選択し、[全般]タブに移動して、アプリケーションまたはエンティティを設定します。

アプリケーション ID とエンティティ ID を 受信構成レベル で設定するには:

• Infobip Web インターフェイス (opens in a new tab)で、[チャネルと番号] > [番号]** に移動します。

• 番号を選択し、チャネルの 受信設定 セクションで、編集アイコン .

• アプリケーション や エンティティ を設定し、構成 を選択します。

受信構成レベルでアプリケーション ID とエンティティ ID を設定すると、受信トラフィックに適用され、受信メッセージが受信構成設定に従ってルーティングされます。これらの ID が受信構成レベルで設定されていない場合、番号レベルのアプリケーション ID とエンティティ ID が受信メッセージのルーティングに使用されます。

SMSまたはMMSインバウンドトラフィックのコンテキストでは、番号リソース(ショートコードまたは仮想ロング番号)が必要です。さらに、数値はキーワードをサポートでき、それぞれに特定の数値構成が必要です。たとえば、1201000001 のような着信番号がある場合、その設定を 1 つのアプリケーション、エンティティ、またはアプリケーションとエンティティのペアに関連付けることができます。または、同じ番号に異なるキーワードを設定し、各キーワードを異なるアプリケーション、エンティティ、またはアプリケーション/エンティティのペアに関連付けることもできます。

受信トラフィック - 専用番号

キーワードを含む受信トラフィック