Webhookでイベントをフィルタリングするトリガーを作成する

Genesys Cloud の Webhook メッセージ用に生成されるカスタム イベントをフィルタリングするためのトリガーを作成できます。これらのイベントは、イベント統合用の Genesys Cloud Webhook が、統合設定で指定された呼び出し URL で Webhook 呼び出しを受信したときに生成されます。 

あなたがトリガーを作成するWebhook メッセージの場合は、次のオプションを選択します。

  • トピック名v2.integrations.inbound.webhook.{id}.invocationリストから。
  • イベントに対して開始するワークフロー。
  • Webhook メッセージを識別する条件。たとえば、Webhookidあなたがイベント統合用のWebhookを追加しました

この画像は、Webhook イベントのトリガーの詳細の例を示しています。

この画像は、イベント統合用の Webhook 用に作成されたトリガーのスクリーンショットです。 スクリーンショットは、Webhook ID をフィルタリングする条件を持つ Webhook イベントを示しています。

以下は、Webhook ペイロードの形式の例です。

この画像は、Webhook ペイロードのスクリーンショットです。

トリガーでは、次のようなJSONパス式を使用します。$.body.{{foo}}値を含むか等しい演算子を使用し、トリガーが Webhook メッセージの内容に基づいてフィルター処理できるようにします。ペイロードの例のように、$.body.someKey含むsomeValue一致基準が満たされ、トリガーによって構成されたワークフローが呼び出されます。

注記:Webhook 呼び出し本体の実際の構造は、Webhook メッセージを送信するシステムによって定義されます。Webhook メッセージの内容に基づいてフィルタリングする必要がある場合、使用する正確な JSON パスはこの構造によって異なります。

アクセスするにはsomeKeyウェブフック呼び出し本体内の属性を使用する場合は、次のような式を使用する必要があります。ToString(Flow.jsonData.webhooksInvocation.body.someKey)建築家の中で。この関数はまず、Webhook メッセージの JSON を解析します。次に、body要素に移動して、someKey現在のフロー内で使用する属性。

注記:Webhook 呼び出し本体の実際の構造は、Webhook メッセージを送信するシステムによって定義されます。Webhook メッセージの内容に基づいてフィルタリングする必要がある場合、使用する特定の JSON パスは、システムがデータをどのように構造化しているかによって直接異なります。