Übersicht über die Auslöser

Ein Trigger ist eine Ressource innerhalb von Genesys Cloud, die es Kunden ermöglicht, eine Reaktion auf bestimmte Ereignisse zu konfigurieren, die innerhalb von Genesys Cloud auftreten. Die Aktionen sind Workflows, die Sie über Architect erstellen können. Weitere Informationen über die Erstellung von Workflows finden Sie unter About Architect im Genesys Cloud Resource Center.

Ein Auslöser besteht aus drei Hauptkomponenten:

  • Name des Themas: Das Thema oder das Ereignis, für das Sie eine Aktion aufrufen möchten.
  • Workflow-Ziel: Die Aktion, die bei den übereinstimmenden Ereignissen durchgeführt werden soll.
  • Bedingungen: Die Kriterien, die erfüllt sein müssen, damit auf ein Ereignis reagiert werden kann.

Name des Themas

Die folgende Liste ist ein Beispiel für einige der Benachrichtigungsthemen, die beim Erstellen von Triggern in Genesys Cloud verfügbar sind. Neue Themen werden regelmäßig aktualisiert und die Themen können je nach Organisation variieren.

  • v2.users.{id}.activity
  • v2.detail.events.conversation.{id}.acd.end
  • v2.detail.events.conversation.{id}.acd.start
  • v2.detail.events.conversation.{id}.acw
  • v2.detail.events.conversation.{id}.wrapup
  • v2.detail.events.conversation.{id}.attributes
  • v2.detail.events.conversation.{id}.customer.end
  • v2.detail.events.conversation.{id}.customer.start
  • v2.detail.events.conversation.{id}.outbound
  • v2.detail.events.conversation.{id}.user.end
  • v2.detail.events.conversation.{id}.user.start
  • v2.detail.events.conversation.{id}.voicemail.end
  • v2.detail.events.conversation.{id}.voicemail.start
  • v2.outbound.email.campaigns.contact.preContact
  • v2.outbound.email.campaigns.contact.postContact
  • v2.outbound.messaging.campaigns.contact.preContact
  • v2.outbound.messaging.campaigns.contact.postContact
  • v2.quality.evaluations
  • v2.operations.events.{id}
  • v2.detail.events.collaboratechat.adhoc.{id}.messages
  • v2.detail.events.collaboratechat.group.{id}.messages
  • v2.workforcemanagement.managementunits.{id}.adherence
  • v2.workforcemanagement.teams.{id}.adherence
  • v2.users.{id}.workforcemanagement.adherence
  • v2.users.{id}.workforcemanagement.schedules
  • v2.users.{id}.workforcemanagement.notifications
  • v2.users.{id}.workforcemanagement.timeoffrequests
  • v2.users.{id}.integrationpresence

Wenn Sie das Thema in der Triggeransicht auswählen, wird das Ereignisschema des Themas als Referenz angezeigt. Sie können eine Liste der für Ihre Organisation verfügbaren Themen abrufen, indem Sie eine GET-Anfrage stellen. Weitere Informationen finden Sie unter APIs zur Prozessautomatisierung Und Verfügbare Themen .

Workflow-Ziel

Trigger unterstützen den Workflow-Flow-Typ „Architect“. Administratoren erstellen Workflows in Architect. In der Auslöseransicht können Sie nur aktive und veröffentlichte Workflows als Ziel für den Workflow auswählen. Das Datenformat, in dem die Eingabeparameter an den Workflow gesendet werden, können primitive Felder der obersten Ebene oder JSON sein.

  • Die Grundelemente der obersten Ebene wie Zeichenfolgen, Aufzählungen, Zahlen und boolesche Werte werden an den Workflow gesendet.
  • For JSON data format, the entire event is sent to the workflow as a JSON object. The workflow must be configured to have an input variable named jsonData of type JSON.
Notiz : Bei Workflow-Attributen in Architect muss die Groß-/Kleinschreibung beachtet werden. Wenn Sie im Workflow auf ein Attribut verweisen, achten Sie darauf, die Groß- und Kleinschreibung genau so zu verwenden, wie sie im Ereignisschema angezeigt wird.

Weitere Informationen zu Workflows finden Sie unter Arbeit mit Workflows.

Bedingungen

Bedingungen sind die Liste der Kriterien, unter denen der Auslöser das Workflow-Ziel aufruft. Der Bedingungsausdruck umfasst drei Teile:

  • JSON-Pfad : Definiert den zu vergleichenden Teil des Ereignisses. Drücken Sie die Bedingung mit JSONPath aus, der Sprache, die zum Durchlaufen und Parsen von JSON-Dokumenten verwendet wird, um bestimmte Elemente zu finden. Sie können auch den Jayway JsonPath Evaluator oder das JSONPath-Testdienstprogramm-Tool verwenden, um die Antwort auf Ihre JSON-Payload und JSONPath-Anweisungen zu überprüfen.
  • Operator : Definiert den Vergleichstyp, der zum Vergleichen der JSON-Pfadausgabe mit dem Wert verwendet wird. Bei String-Vergleichen wird zwischen Groß- und Kleinschreibung unterschieden.Klicken Sie in der Triggeransicht auf, um eine Beschreibung der Operatorliste anzuzeigen Hilfe zu Filteroperatoren anzeigen .
  • Wert : Benutzerdefinierte(r) Wert(e) für die Operationen, die einen einzelnen Wert oder eine Liste von Werten annehmen. Der Eingabewert kann eine Zeichenkette, eine Zahl oder ein boolescher Wert sein. Je nach Auswahl des Operators ändert sich entsprechend die Eingabeart des Wertes. Der Eingabetyp des Wertes stellt die Genauigkeit des Vergleichs sicher.
    Operator Art der Eingabe
    GreaterThanOrEqual Nummer
    LessThanOrEqual Nummer
    Gleichberechtigt

    Objekt

    NotEqual

    Objekt

    WenigerAls

    Nummer

    GrößerAls

    Nummer

    Unter

    Array von Objekten

    NichtIn

    Array von Objekten

    Enthält

    Objekt

    Alle

    Array von Objekt

    Existiert

    Boolesch

    Größe

    Nummer

    Notiz : Ein Trigger kann bis zu 10 Bedingungen haben, die alle erfüllt sein müssen, um den Workflow zu starten. Um einen Workflow aufzurufen, wenn eine der verschiedenen Bedingungen erfüllt ist (ODER-Logik), müssen Sie mehrere Trigger erstellen, jeder mit seinem eigenen Satz von Bedingungen.

Timing-Konfiguration

Wenn ein Auslöser einen Workflow aufruft, beginnt der Workflow sofort oder entsprechend einer konfigurierten Zeitverzögerung. Sie können auch die Time to Live (TTL) für einen Auslöser konfigurieren, sodass der Workflow nach der konfigurierten Zeit nicht ausgeführt wird. Kommt es beispielsweise zu einer Verzögerung bei der Auslöserverarbeitung für einen Statusänderungs-Workflow, ist es nicht relevant, den Workflow nach der eingestellten Zeit auszuführen.

Als Nächstes erfahren Sie, wie Sie unter einen Auslöser erstellen.