Two-Way Jira Integration Setup

Learn how to set up the Two-Way Jira Integration.

Two-Way Jira Integration Setup

For those with Jira 6.0 and higher, the Applause platform allows you to map your Jira issue statuses to ours. This allows for updates done on your Jira ticket to automatically update the Applause issue. The Integration includes setting up a webhook within Jira, subscribed to the internal Issue Update event, effectively notifying the Applause platform on changes to the issue.

Once the Two-Way Jira Integration is successfully set up, you may utilize it to drive the Bug Verification workflow.

How to Configure the Two-Way Jira Integration

Configuration of the Two-Way Jira Integration consists of an initial set of steps you’ll be required to complete within the Applause platform and additional settings required to be completed with Jira, to ensure the integration is properly subscribed to the Webhook.

Steps to Configure the Two-Way Jira Integration
  1. Log in to the Applause platform and navigate to the Connectors List. Then, Either create a new BTS Connector of type Jira, or edit an existing one.

  2. At the bottom of the form, check the “Enable Two-Way Integration” box.

  3. If you already have a Jira connection set up, you may need to click the “Refresh Connection” button to enable this option.

  4. Select the Jira Fields you’d like to send from Jira to the Applause platform.

  5. Make sure to click “Save” on the created/edited product, even if you go through steps 1 (“Components”) or return to step 1 (“Basic”).

Note: While Jira may allow multiple “Target Version” values, the Applause platform will only save a single value. We will always keep the latest version value, based on the ID assigned to it by Jira.

Creating the Jira Webhook

After you click “Save” you’ll be prompted to create a webhook on your Jira.

Creating the Jira Webhook

Methods to Set Up the Jira Webhook
  • Provide your Jira admin credentials (one-time only) and we’ll set it up for you automatically
  • Set up the webhook manually from within your Jira instance. (See: How to manually create a Jira webhook)

Note: We do not store your credentials and only use them for the one-time purpose of setting the webhook.

Getting the API Key During the Manual Setup

Creating the webhook manually will require using an API key, effectively enabling the registration of the Applause platform to your Jira instance. The API Key can be found during setup, under the “do it manually on your Jira without providing admin credentials” checkbox in the same dialog box.

Getting the API Key During the Manual Setup

An Alternative Way of Getting the API Key

Alternatively, once the created/edited product is saved with the Two-Way Jira Integration settings saved, the API Key will be available when editing the Connector:

An Alternative Way of Getting the API Key on Jira