Example: Configuring an inbound integration

Inbound integrations take action in xMatters. For example, xMatters might create or terminate a notification event based on an incoming web request.

In this example, we'll build an inbound integration that sends notifications when New Relic detects a new incident.

1. Add a new Inbound Integration

The first step in getting an integration up and running in xMatters is to create and save the integration in our communication plan.

2. Send a test webhook to xMatters

In this next step, we'll get New Relic to send a web request to our integration URL so that we can figure out what our transformation script needs to do.

3. Check the request details in the Activity Stream

We can use the Activity Stream in xMatters to see the history of incoming web requests sent to us by an integration service. Once we see what New Relic is sending us, we can transform the content so that our communication plan form understands it.

4. Transform the content of the incoming request

In this step, we'll create a script that will transform the incoming web request from New Relic into a format that is compatible with our communication plan form.

5. Define the xMatters endpoint

The final configuration step is to define our xMatters endpoint. Endpoints provide a simple way to define the base URL and authentication credentials to use when making HTTP requests from a transformation script.

6. Check that it works

The final thing to do is to send another webhook from New Relic and make sure everything is working.

And, that's it!