Automating customer notifications with Opsgenie and Statuspage

Step 1: Add an integration in Opsgenie

In Opsgenie, all integrations are set up through Teams. If you don’t yet have a team set up, click Add Team at the top right of the Teams screen to create one. Enter a team name and description. Once saved, you can select the team and start your integration by choosing Integrations and then Add Integration.

Step 2: Connect your integration in Statuspage

In a new window, open your Statuspage account. If this is a new account, the system will walk you through setup before you get to your dashboard. Once you’re at the dashboard, go to Subscribers and click WebHook at the top of the page.

Step 4: Get your Statuspage API key and page ID

Return to your Statuspage account. In the URL, just after /pages/, you’ll see a series of letters and numbers. This is your Page ID. You can copy it and then return to Opsgenie to paste it into the Page ID field. 

It should look something like this: q776213b98cb.

Back in Statuspage, click on the profile icon at the bottom left of your screen and choose API Info. Copy the series of letters, numbers, and dashes in the Your API user key field and return to Opsgenie to paste them into the API key field. 

Page IDs are also available on the API page if you have trouble pulling yours from the URL. 

Once you’ve pasted both numbers into Opsgenie, Save Integration. 

Step 5: Test your integration with an alert in Opsgenie

In Opsgenie, create a test alert. (You can learn how to create alerts here.)

In the new alert, under Responders, enter the team name that the Statuspage integration is assigned to. Under Tags, enter your tags. To integrate properly with Statuspage, every tag should begin with cmp_ followed by the name of the component in Statuspage (for example, if your component name is API, your tag would begin cmp_API). Tags are case sensitive, so make sure your capitalization matches up exactly with your component. There is a specific list of components status’ that are available. Please see the documentation for the full list. 

After the name of the component, enter a colon and a description of the state of the component. There is a fixed list of components you can use for these tags.

For example, a tag indicating your API has degraded performance would look like this: cmp_API:degraded_performance.

The component states available include: 

operational
degraded_performance
partial_outage
major_outage
under_maintenance

Once you have your tag, click Show advanced fields and enter a description. The title of the incident will be your alert message, and the description is where you can provide additional information users will see next to the title on your Statuspage. 

Click Create. 

Refresh your Statuspage if you don’t see the alert right away. 

Note: These instructions are for creating alerts and incidents in Opsgenie that will automatically update your Statuspage. You can also automate in the other direction—creating your alerts in Statuspage and sending them automatically to Opsgenie. To learn more about this second type of integration, visit our documentation. 

Congratulations! You’re integrated.

If the settings above are correct, the test alert should be showing up on your Statuspage and when you close the alert in Opsgenie, it should be resolved  on your Statuspage in real time.

Should you automate your status page?

Opsgenie and Statuspage make automation fairly simple. But as with any technical decision, the question remains: Should you automate? Are status pages a good place to use automation or do they need a human touch?

There’s no one-size-fits-all answer. 

For some businesses, the value of speedy communication and the assurance that customer updates won’t fall off the to-do list in the heat of an intense incident make automation a no-brainer. 

For other businesses, PR and communication teams might want tighter control over the when, how, and why of alerting the public. 

Ultimately, we can’t answer the question for anyone but ourselves. But we can provide the technology that lets you sync Opsgenie with Statuspage to automate your own unique version of incident comms.