Erstellen Sie Trigger, um Ereignisse per Webhook zu filtern

Sie können einen Trigger zum Filtern benutzerdefinierter Ereignisse erstellen, die für Webhook-Nachrichten in Genesys Cloud generiert werden. Diese Ereignisse werden generiert, wenn der Genesys Cloud-Webhook für die Ereignisintegration Webhook-Aufrufe unter der in der Integrationskonfiguration angegebenen Aufruf-URL empfängt. 

Wenn Sie einen Auslöser erstellen Wählen Sie für eine Webhook-Nachricht die folgenden Optionen aus:

  • Der Themennamev2.integrations.inbound.webhook.{id}.invocation aus der Liste.
  • Der für das Ereignis zu initiierende Workflow.
  • Die Bedingung, die die Webhook-Nachricht identifiziert. Verwenden Sie beispielsweise dieWebhookid die du bekommen hast, als du Webhook für Event-Integration hinzugefügt .

Dieses Bild zeigt ein Beispiel der Triggerdetails für Webhook-Ereignisse:

Dieses Bild ist ein Screenshot des Triggers, der für die Webhook-für-Events-Integration in Genesys Cloud erstellt wurde.

Nachfolgend sehen Sie ein Beispielformat für die Webhook-Nutzlast:

{
 "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"
}

Verwenden Sie im Trigger einen JSON-Pfadausdruck wie$.body.{{foo}} mit einem Operator, der den Wert enthält oder ihm entspricht und es dem Trigger ermöglicht, basierend auf dem Inhalt der Webhook-Nachricht zu filtern. Wie in der Beispielnutzlast, wenn$.body.someKey enthältsomeValue , das Übereinstimmungskriterium ist erfüllt und der Trigger ruft den konfigurierten Workflow auf.

Notiz : Die tatsächliche Struktur Ihres Webhook-Aufruftexts wird durch das System definiert, das die Webhook-Nachricht sendet. Wenn Sie basierend auf dem Inhalt der Webhook-Nachricht filtern müssen, hängt der genaue JSON-Pfad, den Sie verwenden, von dieser Struktur ab.

Für den Zugriff auf diesomeKey Attribut im Webhook-Aufruftext müssen Sie den Ausdruck verwenden, der dem folgenden ähnelt:ToString(Flow.jsonData.webhooksInvocation.body.someKey) im Architekten. Diese Funktion analysiert zuerst das JSON der Webhook-Nachricht. Anschließend navigiert es in das Body-Element, um dassomeKey Attribut zur Verwendung innerhalb des aktuellen Flusses.

Notiz : Die tatsächliche Struktur Ihres Webhook-Aufruftexts wird durch das System definiert, das die Webhook-Nachricht sendet. Wenn Sie basierend auf dem Inhalt der Webhook-Nachricht filtern müssen, hängt der von Ihnen verwendete spezifische JSON-Pfad direkt davon ab, wie das System seine Daten strukturiert.