With this Outbound Integration, notification recipients can quickly create, update, and resolve StatusPage incidents, right from the xMatters notification!
This document details how to install and use this integration.
:heavy_exclamation_mark: Note: You can get this same functionality using the awesome new Flow Designer without a line of code. Check it out here
Manage Account
.Click 'Edit Endpoints', and then click Add Endpoint
to add an endpoint for StatusPage; fill out the following details:
Item | Selection |
---|---|
Name | StatusPage |
Base URL | https://api.statuspage.io/v1/pages/PAGE_ID_HERE |
Where PAGE_ID_HERE
should be replaced with the Page ID from StatusPage in the steps above.
Click the Edit Constants
button and Add Constant
; fill out the following details to create a constant to hold the API key:
Item | Selection |
---|---|
Name | Status Page Token |
Value | API_KEY_VALUE |
Where API_KEY_VALUE is the API Key from StatusPage in the steps above.
Save Changes
and Close
.+ Add
buttonMy Shared Library
to StatusPage
, then paste in the contents of the StatusPage.js file and hit Save
.+ Add
button. (We are going to add a new script here, but don't worry: this will not impact any existing scripts. You can have several outbound integrations that all run on notification response, as long as you add logic to each one to determine if they should fire.) Fill out the following details in the wizard:
Item | Selection |
---|---|
Choose an action | Run a Script |
Select a form | \ |
Select a trigger | Notification responses |
Integration name | \ |
Add the following response options with the related attributes. You can change the text displayed, but the code in the OutboundResponseScript.js file will reference the value in the Response
column. If you do change the text, make sure to update the OutboundResponseScript to reflect the value in the Response column. Also note that comments (annotations) are only supported on mobile devices.
Response | Email Description | Voice Prompt | Options |
---|---|---|---|
Create StatusPage.io Incident | Create StatusPage.io Incident | Create StatusPage.io Incident | Record Response |
Update StatusPage.io Incident with Comment | Update StatusPage.io Incident with Comment | Update StatusPage.io Incident with Comment | Record Response |
Resolve StatusPage.io Incident | Resolve StatusPage.io Incident | Resolve StatusPage.io Incident | Record Response |
Testing the changes will differ based on your specific communication plan, but new events will have three new response options. For example:
Display the response options
Choose to include comments
Enter comments
First, select the Create StatusPage.io Incident
option to generate the incident. Then use the Update StatusPage.io Incident with Comment
option to add a comment to the StatusPage incident.