Microsoft Teams for Bitbucket

Microsoft Teams Bitbucket connector helps in notifying the changes in the Bitbucket to the Microsoft Teams.

How to setup?

The plugin basically invokes the webhook configured in the Microsoft Teams when there is a change in the bitbucket repository. The setup involves configuring Teams and Bitbucket.

Creating a Webhook in Teams

• Open teams, click on the Apps icon in the left bottom
• Choose Connectors in the left pane
• And then, select Incoming Webhook from the list of available apps

1. Configuring Webhook

• Select Add to Team
• Type the team or channel name where the bitbucket notifications will be sent and click Setup Connector
• Provide a name, choose and image and click Create
• It will generate a webhook URL. This URL will be used while we configure the plugin in the bitbucket. Copy the URL for later use.

Installing Plugin

• Go to Global Settings (Administration page) in the bitbucket by clicking the Settings icon in the right top
• Select Find new apps in the left pane
• Search for Bitbucket Microsoft Teams Connector
• Choose `Free Trial` or `Buy now`. This will install the plugin in Bitbucket
• The next step is to configure the plugin either at the Project level or repository level.

Configuring at Project Level

• The plugin allows configuring at the project level. This will be applicable for all the repositories under that project
• To configure the project, go the Project Settings page of the project
• Click Teams Connector under Add On section
• Specify the Webhook url of the teams
• Select all the options that need to be notified to the channel
• Click Save
• The settings will be enabled for all the repositories under the project. This configuration can be overridden in the repository config page.

Configuring at Repository Level

• The plugin allows configuring at the repository level. This will be applicable only for the repository
• To configure the repository, go the Repository Settings page of the repository
• Click Teams Connector under Add On section
• The first dropbox has three options

Inherited — This will use the settings at the project level

Enabled — This will override the configuration at project level and will always keep it enabled even if the project config is disabled

Disabled — This will disable the plugin at the repository level even if it enabled at the project level

• Specify the Webhook url of the teams
• Select all the options that need to be notified to the channel
• Click Save
• Done

Now, the notifications will be sent to the teams based on the configuration.