Two-Way Azure DevOps Integration Setup

The Applause platform allows you to map your Azure issue statuses to ours. This allows for updates done on your Azure ticket to update the Applause issue automatically. The Integration includes setting up a webhook within Azure, subscribing to the internal Issue Update event, and effectively notifying the Applause platform of changes to the issue.

Once the Two-way Azure Integration is successfully set up, you may utilize it to drive the Bug Verification Workflow.

 

How to Configure the Two-Way Azure Integration

Configuration of the Two-Way Azure Integration consists of two steps:

• An initial set of steps for setting up the connection within the Applause platform
• Additional settings required to be completed with Azure, to ensure the integration is properly subscribed to the Webhook

Configuring the Two-Way Azure Integration

1. Log in to the Applause platform and navigate to the Connectors List. Then, either create a new BTS Connector of type Azure DevOps, or edit an existing one.
2. At the bottom of the form, check the “Enable Two-Way Integration” box.
3. If you already have an Azure connection set up, you may need to click the “Refresh Connection” button to enable this option.
4. Select the Azure fields you’d like to send from Azure to the Applause platform.
5. Click Save.

Notes:

• While Azure 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 Azure.
• When choosing the connector in the Integrations tab of the Product edit page, make sure to click “Save”, even if you go through step 3 (“Components”) or return to step 1 (“Basic”).

 

Creating the Azure Webhook

Once the Enable Two-Way Integration checkbox is checked, the API Key will be available:

Note that the warning message will disappear after sending your first update from your BTS to Applause.

Next, you will need to set up a webhook from within your ADO instance.

1. Log in to your ADO instance with an admin account.
2. Open a project by clicking on it.
3. At the bottom of the left navigation menu click Project Settings.
4. On the next page, from the left navigation menu open Service Hooks.
5. Click on the plus icon to add a new service hook subscription.
6. Select Web Hooks and click Next.
7. For Event choose “Work item updated”.
8. For Work item type choose Bug, and click Next.
9. For URL enter https://bts.applause.com/api/applause/v1/azuredevops?apikey= and at the end add the API Key provided in the Applause platform when setting up the 2-way integration.
10. Click on the Test button to see if the webhook was configured correctly. If the test is successful, close the window and click Finish.