Mobile alerting with tracking & escalation for Jira Software
Jira Software is an issue tracking product developed by Atlassian. Jira offers a REST API for integration capabilities. When you create a new issue in Jira you can configure to trigger an alert across your mobile SIGNL4 team. However, it would be great to update the issue in Jira when the alert has been acknowledged in SIGNL4… Do not worry. We went ahead and created a two-way integration solution for this.
How it Works
Trigger an HTTP request via custom conditions in Jira Software. Additionally configure SIGNL4 to interact with a PHP script and update events back in Jira.
IT staff is alerted via mobile push, text and voice
Staff can acknowledge and take ownership for critical events that occur
Alerts are escalated in case of no response
Communicate within an alert to address a particular problem
Inbound HTTP webhook or email establishes connection from Jira Software to a SIGNL4 team
SIGNL4 then updates the issue in Jira Software when the issue has been acknowledged by a mobile SIGNL4 user
How To Integrate
For sending acknowledgement information back to Jira we need to match the Jira ID with the ID of SIGNL4. This is how it works with a simple PHP script.
The PHP script is attached above. You need to add your Jira credentials here in order to be able to use the REST API.
You can either use your own Web server or try out a service like heroku.com.
Jira -> PHP Script
When a Jira issue is created you trigger a Webhook to be sent to the URL where your PHP scrips is running. You can configure this easily in the Webhook section in the Jira settings. The PHP script will store the Jira issue ID in order to match it later.
PHP -> SIGNL4
Upon receiving the Jira issue information the PHP script will send an HTTP request to SIGNL4 in order to trigger the alert. As a response the PHP script will get the event ID of the SIGNL4 event. This is stored along the Jira issue ID.
SIGNL4 -> PHP
In the SIGNL4 portal you configure the outbound Webhook that will be called when a user acknowledges an alert in SIGNL4. You can do so under Developer -> Webhooks. The PHP script will receive the acknowledgement request where the SIGNL4 event ID is contained. It will then search for the corresponding Jira issue ID and then sends back the update request to Jira.
PHP -> Jira
In Jira the issue is then updates accordingly.