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

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

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

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

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

この画像は、Genesys Cloud の Webhook for Events 統合用に作成されたトリガーのスクリーンショットです。

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

{
 "webhookId": "93f59079-9d26-49b1-bbb7-83630b85a489",
 "webhooksInvocation": {
   "body": {
     "someKey": "someValue",
     "someArray": ["a", "e", "i", "o", "u"],
     "someObject": { "nested": "property" }
   },
   "headers": {
     "accept": ["*/*"],
     "accept-encoding": ["gzip, deflate, br"],
     "cloudfront-forwarded-proto": ["https"],
     "cloudfront-is-desktop-viewer": ["true"],
     "cloudfront-is-mobile-viewer": ["false"],
     "cloudfront-is-smarttv-viewer": ["false"],
     "cloudfront-is-tablet-viewer": ["false"],
     "cloudfront-viewer-ash": ["1xxx1"],
     "cloudfront-viewer-country": ["US"],
     "content-length": ["130"],
     "content-type": ["application/json"],
     "host": ["api.inntca.com"],
     "inin-correlation-id": ["562af708-6f7f-xxxx-a27b-146b27d5xxxx"],
     "my-header": ["my-value"],
     "user-agent": ["PostmanRuntime/7.42.0"],
     "via": [
       "1.1 8770cedbbb1c2feb157dc67ce83fe00c.cloudfront.net (CloudFront)"
     ],
     "x-amz-cf-id": [
       "g2LedL9Rtfu_rkCCxxxx9_07UV2jgr4lGvrnqWwnrJf1lH3uYu7Q=="
     ],
     "x-amzn-trace-id": ["Root=1-67f8xxxx-074dc1775c69e6c396073c4"],
     "x-forwarded-for": ["27.251.30.213, 15.158.35.16"],
     "x-forwarded-port": ["443"],
     "x-forwarded-proto": ["https"]
    },
    "query": { "abc": ["123"], "foo": ["bar"] }
   },
 "invocationTime": "2025-04-10T20:21:16.825Z"
}

トリガーでは、次のような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 パスは、システムがデータをどのように構造化しているかによって直接異なります。