インバウンド・メッセージ: サブスクリプション・ルーティング
Webhook サブスクリプションは、複数の通信チャネルにわたる受信メッセージの一元的な構成を提供します。リソースごとに受信処理を個別に構成する代わりに、チャネル固有の要件に対する柔軟性を維持しながら、統一的に適用されるサブスクリプションベースのルールを定義します。
受信メッセージにサブスクリプションを使用する理由 [#why-subscriptions-for-inbound]
一元管理
チャネルレベルでインバウンド処理を設定します。1 つのサブスクリプションでそのチャネル上のすべてのリソースがカバーされるため、リソースごとのセットアップが不要になり、構成のオーバーヘッドが削減されます。
統合イベント処理
受信メッセージと、配信確認、リンククリック、バウンスを 1 か所で管理します。1 つのサブスクリプション フレームワークで、チャネルのすべてのイベント タイプが処理されます。
マルチテナントルーティング
CPaaS X 環境では、アプリケーションまたはエンティティに基づいて、インバウンド メッセージをさまざまなエンドポイントに送信します。リソースレベルのオーバーライドは、例外が必要な場合に優先されます。
構成階層 [#configuration-hierarchy]
インバウンド・メッセージが到着すると、システムは優先順位ベースの決定プロセスに従って、その処理方法を決定します。
- リソース固有(最高優先度): リソースにリソースレベルのアクション(HTTP、電子メール、または SMPP への転送)がある場合、システムはそれをすぐに実行します。これにより、すべてのサブスクリプション設定が上書きされます。
- サブスクリプションの適用: リソース固有の構成が存在しないが、受信アクションとして "サブスクリプションの適用" が設定されている場合、システムはそのチャネルに一元化されたサブスクリプション ルールを適用します。
- 非転送アクション (常に実行): 自動応答、ブロック、および会話は、システムが行うルーティングの決定に関係なく、並行して実行されます。
スタンドアロン通知プロファイル は、アウトバウンド (MT) イベントにのみ適用されます。受信メッセージのリソース レベルの転送 URL は、スタンドアロンの通知プロファイルを使用しません。
インバウンドメッセージ決定フロー
リソースの構成オプション [#configuration-options]
リソースの受信メッセージ処理を設定する場合は、次の 3 つの方法のいずれかを選択します。
リソースレベルの転送
そのリソースに対してのみ特定のアクションを設定します。最も高い優先度を取り、サブスクリプションをオーバーライドします。リソースの管理: インバウンド・メッセージ処理の構成を参照してください。
サブスクリプションを申し込む
そのチャネルに定義されているサブスクリプション設定を使用します。リソースごとの制御を維持しながら、一元化された構成を可能にします。
設定なし
リソース・レベル構成もサブスクリプション構成も存在しない場合、受信メッセージは、非転送アクションのアクティブ・サブスクリプションなど、他の構成された設定によって処理されます。
サブスクリプション ベースの受信ルーティングの構成方法 [#setup]
サブスクリプションを作成する
受信メッセージを管理するチャネルごとに Webhook サブスクリプションを設定します。選択したイベントタイプの中に INBOUND_MESSAGE を含めます。Webhookサブスクリプションの管理を参照してください。
「サブスクリプションの適用」を設定する
サブスクリプション設定を使用するリソースごとに、受信アクションを "サブスクリプションの適用" として構成します。リソースの管理を参照してください。
セットアップをテストする
テストメッセージをリソースに送信し、受信メッセージが正しい Webhook エンドポイントに到着することを確認します。
Webhook サブスクリプションについて
コア概念、フィルター処理、およびサブスクリプションのしくみ。
利用可能なWebhookイベント
受信メッセージやその他のイベントタイプをチャネル別に検索します。
Webhook サブスクリプションの管理
サブスクリプションを作成、更新、削除します。
通知プロファイルの管理
Webhook URL と配信設定を構成します。
イベント形式の管理
インバウンド・メッセージ・ペイロード構造をチャネル別に制御します。