Jira Integration

Setting up webhooks for Jira

Updated over a week ago

Connect Jira to Status Hero with a webhook, and Status Hero will match up relevant issue changes and work log updates to your team members based on their email address or name. Then, their Jira activity appears in the activity page and alongside their check-ins automatically.

Installation

To set it up, first, visit the Account Management - Integrations page in Status Hero, and copy the URL listed there under the Jira panel.

Log in to Jira, visit the Jira project you want to connect, and click on the Settings menu on the top right of your screen and select "System."

Then, scroll down the left menu until you get to "Webhooks" under "Advanced." Then click on the "Create a Webhook" button.

Name the webhook "Status Hero" and paste in the URL copied over from the Status Hero configuration panel, and select the "Issue" and "Worklog" events. Then scroll to the bottom of the page and click "Create."


That's it! Status Hero will now process incoming events from Jira.

Note: webhooks configuration may be in a different spot "Classic" or some older on-prem versions of Jira.

Usage

Here's how the Jira activity will show up with check-ins:

To test it out, make an update in Jira and look for a new entry in the activity stream.

Once a few activities have been logged, you can use the auto-complete functionality in check-ins and comments to auto-link to issues in your Jira account.

Simply type # and a string of text that is part of your Jira item and you'll be able to select and auto-insert a fully formatted link to it.

You can add as many Jira projects as you want to your Status Hero team using the same webhook URL.
โ€‹
Right now, we only support the "created", "updated", and "deleted" actions for issues and worklogs, but if there are others that you'd like to see, let us know!

Disconnecting

To turn off the Jira integration, remove the Status Hero webhook from within Jira.

Troubleshooting

  • Look for updates in the activity stream first. The dashboard will sum up updates from the previous period. (The check-ins essentially say "here's what I did yesterday, and here is all of the Jira activity to go along with that.

  • Check to make sure the email address that is being used in Jira matches the email address that is being used in Status Hero. If you or a team member is using a different email address in Jira, set the secondary email address in Status Hero to match the one used in Jira.

    • If the emails match, check if the visibility of your email address in Jira is limited to your organization. If it is, try setting it to public.

  • Check to make sure the first and last names in Jira match what is being used in Status Hero.

  • Status Hero won't be able to record data retroactively. Make sure you generate some activity in Jira in order to test things out after you've set up the connection.

  • Make sure the "Exclude body" option is left unchecked in the webhook configuration

Did this answer your question?