The xMatters app in Zapier allows you to easily create notification events in xMatters when triggers are met in other apps. Similarly, you can also take actions on other apps when xMatters events are created, notifications are delivered, or responses are submitted. Zapier supports over 2000 web apps, and in this basic example, we'll show you to create a Zap using a generic webhook as our trigger.
Create xMatters Events
Let's imagine you want to use xMatters to send notifications to your on-call support group when your monitoring tool detects an application or server outage. Your monitoring tool supports webhooks and can make an HTTP POST when an event occurs. The monitoring tool sends event data as JSON, but you cannot control the schema of the JSON payload and call the xMatters REST API directly.
Fortunately, we can use Zapier to solve this problem by creating a "Zap" that will execute the xMatters Create Event action when the Webhook Catch Hook trigger fires:
Zapier provides a webhook URL that your monitoring tool can send its POST to:
Next, Zapier asks for your xMatters hostname and user credentials:
When everything has been entered, Zapier will test your credentials and make sure it can access the xMatters REST API:
If you want to add any filters to your incoming webhooks, you can do that next. For example, you could create a filter so that only monitoring events about certain applications or servers send out notifications:
Next comes the fun part, this is where we can map data being sent from your monitoring tool to xMatters properties in your workflows.
The first thing we need to do is provide the Web Service URL of the form we will use to send our notification. You can obtain this URL in the xMatters workflow design tools:
Next we need to tell Zapier which properties exist in your workflow form. Suppose your form contains 3 properties. "Application", "Issue, and "Server":
Back in Zapier, we add these event properties to the Properties action field:
Finally, we can map data from the incoming webhook to these 3 event properties. Zapier will ask for a test post from your monitoring tool and then allow you to create the data mapping:
The next two fields are optional but if you want to override the event priority that is configured in the xMatters design tools you can. The xMatters design tools allow you to define message recipients in the form, but it you also want to override this and use the Zap to define the message recipients you can do that too.
Finally, we can test the Zap and confirm that a new event is created in xMatters:
That's it! Now every time your monitoring tools sends a webhook to Zapier, you will get a new xMatters event with the event properties correctly populated.
If you have problems getting your Zap to work there are a few common things to check:
- Make sure your workflow is enabled and your form is deployed as a web service:
- Make sure the xMatters user you are using in Zapier has initiate sender permissions on your form:
- Make sure the names of your event properties in your workflow form exactly match the values you added to the Properties action field in Zapier.
- Make sure you have defined your message recipients in either xMatters or Zapier. All xMatters events must have at least one targeted recipient.