Integration Builder

The Integration Builder, in combination with the other elements of the xMatters integration platform (including the REST API, xMatters Agent, and Flow Designer), allows you to easily add an automated, closed-loop integration to address any business interruption.

You can use the Integration Builder to create an integration between xMatters and another application. You can create multiple integrations for a single workflow.

How it works

Flow Designer and the Integration Builder

When a trigger is added to a canvas in Flow Designer, an integration is also added to the Integration Builder list. This lets you see all the triggers and outbound integrations for a workflow in one list so you can quickly enable or disable them or view activity updates (for example, if you're doing some troubleshooting). But any management of the flow should be done in Flow Designer. It even has its own easy-to-use Activity panel that provides information for each step in a flow, letting you see in more detail what went wrong and where. You can access the Activity panel directly from an integration to view logs in detail.

Inbound integrations

Inbound integrations are primarily used to create an alert in xMatters. The transformation script for an inbound integration can receive an incoming HTTP request, parse and modify its data, enrich the data using additional web requests, and finally create an alert to send notifications.

Create an inbound integration to have an external application create an alert or take action in xMatters.

Outbound integrations

Outbound integrations are triggered when actions take place in xMatters. The outbound services can make web requests to any API accessible over the Internet. You can use outbound integrations to update the originating alert with status changes or response information. You can also configure webhooks to create new alerts in xMatters; for example, to start a conference bridge or send additional notifications to recipients based on their actions.

Create an outbound integration to have xMatters send out response or alert information to take action in another application.

Transformation script editor

The Integration Builder includes a full-featured, browser-based script editor that allows you to create and modify your transformation script within the xMatters web user interface. Transformation scripts for the Integration Builder are written in JavaScript (ECMAScript 5.1).

  • Want to get starting creating a request? Check out the request object details in the Integration Builder scripting reference.

HTTP Endpoints

Each web request you want to make using the Integration Builder is represented in the transformation scripts by HTTP request to an endpoint. Each endpoint is configured with a base URL, a name, and optional configuration parameters, such as the request method (GET, POST, etc.), a specific path to append to the base URL of the endpoint, and any request headers, parameters, or body data.

How to use the Integration Builder

We go into detail on creating inbound and outbound integrations elsewhere, but here's some basic information on using the Integration Builder.