웹훅으로 이벤트를 필터링하기 위한 트리거 생성

Genesys Cloud에서 웹훅 메시지에 대해 생성되는 사용자 정의 이벤트를 필터링하기 위한 트리거를 만들 수 있습니다. 이러한 이벤트는 Genesys Cloud 웹훅이 이벤트 통합을 위해 통합 구성에 지정된 호출 URL에서 웹훅 호출을 받을 때 생성됩니다. 

당신이 때 트리거를 생성하다 웹훅 메시지의 경우 다음 옵션을 선택하세요.

  • 주제 이름v2.integrations.inbound.webhook.{id}.invocation 목록에서.
  • 이벤트를 시작하기 위한 워크플로입니다.
  • 웹훅 메시지를 식별하는 조건입니다. 예를 들어, 다음을 사용합니다.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}} 값을 포함하거나 동일한 연산자를 사용하여 트리거가 웹훅 메시지의 내용을 기반으로 필터링할 수 있도록 합니다. 예시 페이로드와 같이,$.body.someKey 포함하다someValue , 일치 기준이 충족되고 트리거가 구성된 워크플로를 호출합니다.

메모 : 웹훅 호출 본문의 실제 구조는 웹훅 메시지를 보내는 시스템에 의해 정의됩니다. 웹훅 메시지의 내용을 기준으로 필터링해야 하는 경우 사용하는 정확한 JSON 경로는 이 구조에 따라 달라집니다.

접근하려면someKey 웹후크 호출 본문 내의 속성을 사용하려면 다음과 유사한 표현식을 사용해야 합니다.ToString(Flow.jsonData.webhooksInvocation.body.someKey) 건축가에서. 이 기능은 먼저 웹훅 메시지의 JSON을 구문 분석합니다. 그런 다음 본문 요소로 이동하여 다음을 가져옵니다.someKey 현재 흐름 내에서 사용할 속성입니다.

메모 : 웹훅 호출 본문의 실제 구조는 웹훅 메시지를 보내는 시스템에 의해 정의됩니다. 웹훅 메시지의 내용을 기준으로 필터링해야 하는 경우 사용하는 구체적인 JSON 경로는 시스템이 데이터를 구성하는 방식에 따라 달라집니다.