Overview of triggers
A trigger is a resource within Genesys Cloud that allows customers to configure a reaction to specific events that happen within Genesys Cloud. The actions are workflows that you can create via Architect. For more information about how to create workflows, see About Architect in the Genesys Cloud Resource Center.
A trigger includes three main components:
- Topic name: The topic or the event for which you want to invoke an action.
- Workflow target: The action to take on the matching events.
- Conditions: The criteria that must be met for an event to be acted on.
Topic name
The following list is an example of some of the notification topics that are available when you create triggers in Genesys Cloud. New topics update regularly and the topics can vary, depending on your organization.
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.users.{id}.integrationpresence
When you select the topic in the trigger view, the event schema of the topic displays for reference. You can obtain a list of topics available to your organization by fetching with a GET request. For more information, see Process Automation APIs.
Workflow target
Triggers support the Architect workflow flow type. Administrators create workflows in Architect. In the trigger view, you can only select active and published workflows as the workflow target. The data format in which the input parameters are sent to the workflow can be top-level primitive fields or JSON.
- The top-level primitives such as, strings, enums, numbers, and Boolean are sent to the workflow.
- 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.
For more information about workflows, see Work with workflows.
Conditions
Conditions are the list of criteria under which the trigger invokes the workflow target. The condition expression includes three parts:
- JSON Path: Defines the part of the event to compare. Express the condition using JSONPath, the language used to traverse and parse JSON documents to find specific elements. You can also use the Jayway JsonPath Evaluator or the JSONPath test utility tool to check the response for your JSON payload and JSONPath statements.
- Operator: Defines the comparison type used to compare the JSON Path output with the value. String comparisons are case-sensitive. In the trigger view, to see a description on the operator list, click View help on filter operators.
- Value: User-defined value or values for the operations that take a single value or list of values. The input value can be string, number, or Boolean values. Depending on the selection of the operator, the input type of the value changes accordingly. The input type of the value ensures the accuracy of the comparison.
Operator Input type GreaterThanOrEqual Number LessThanOrEqual Number Equal Object
NotEqual Object
LessThan Number
GreaterThan Number
In Array of objects
NotIn Array of objects
Contains Object
All Array of Object
Exists Boolean
Size Number
Note: A trigger can have up to 10 conditions, all of which must be met to initiate the workflow. To invoke a workflow when any of the several conditions are true (OR logic), you must create multiple triggers, each with its own set of conditions.
Timing configuration
When a trigger invokes a workflow, the workflow begins instantly or according to a configured time delay. You can also configure Time to Live (TTL) for a trigger such that the workflow will not execute after the configured time. For example, if there is a delay in trigger processing for a status change workflow, then it is not relevant to execute the workflow after the set time.
Next, learn how to create a trigger.