Flow triggers

A trigger is the mechanism for kicking off a flow in xMatters. Flow Designer includes different types of triggers, which are initiated either when event activities occur (such as an event status change, a specific response, or an added comment), or when information is injected into xMatters by an incoming HTTP request or email. Each trigger populates outputs based on the type of trigger, which are available to downstream steps in a flow.

If you have existing outbound integrations for a communication plan form, they'll appear as triggers on the canvas. You can connect additional steps to these triggers to extend the current functionality of your outbound integrations.

Event activity triggers

Event activity triggers kick off flows based on different event lifecycle activities, including event status updates, device delivery updates, responses, event comments, escalations, and targeted recipient failures. Each of these different triggers include a common set of event properties, and additional properties specific to the type of event activity.

Common properties

The common properties output by all event activity triggers provide information identifying the event in addition to its status and properties.

Event status updates trigger

The Event Status Updates trigger initiates a flow when an event is started, suspended, resumed, or terminated. Outputs include the status of the event and the user who initiated the event status change.

Device delivery updates trigger

The Device Delivery Updates trigger initiates a flow when a notification is delivered to a device, or when notification delivery fails. Outputs include the user and device that the message was sent to and whether the delivery was successful.

Responses trigger

The Responses trigger initiates a flow when a user responds to a message. Outputs include the user and device that made the response, their response choice, and comments added from the mobile app.

Event comments trigger

The Event Comments trigger initiates a flow when a user adds a comment from the mobile app, xMatters Inbox, email, Tracking Report, or xMatters REST API. Outputs include the user that made the comment and the content of their comment.

Escalations trigger

The Escalations trigger initiates a flow when an escalation occurs in a group. Outputs include the group containing the shift with the escalation, the reason for the escalation, the user that escalated the event (if it was escalated manually), the type of escalation, the recipients the event escalated from, and the recipients the event escalated to.

Targeted recipient failures trigger

The Targeted Recipient Failures trigger initiates a flow when none of the targeted recipients could be immediately notified for an event. Outputs include the type of failure, the first 100 targeted recipients, and the total number of targeted recipients.

^ Back to top

 

 

HTTP Request trigger

HTTP Request triggers initiate a flow when xMatters receives a POST request to the trigger's URL. The HTTP trigger parses the payload from the incoming HTTP request, then extracts information from the payload and maps it to user-defined outputs of the trigger to be available as inputs to later steps in a flow.

^ Back to top

 

 

Email trigger

An email trigger initiates a flow when you send an email to xMatters. When xMatters receives an email from a valid sender, it initiates the corresponding flow and uses information from the email to set values for outputs of the trigger, available as inputs to later steps in a flow. Outputs include the email sender, headers, addressees, subject, and body.

If you have an existing integration using the legacy email initiation, you can convert it to an email trigger in Flow Designer.

^ Back to top