Microsoft Teams Bitbucket Connector for Bitbucket Server and Data Center enables one-way Bitbucket to Microsoft Teams integration. It is one way (read-only) to enable better security.

You can find it  Microsoft Teams Bitbucket Connector on the Atlassian Marketplace here.

You can find additional information about Microsoft Teams Bitbucket Connector.

Main features

  • Receive updates from Bitbucket directly in your Microsoft Teams channels. Get notifications about events you or your team care about, including Build Status Set notification

  • Filter down notifications by project, repository, branch, user, event types and other entities

  • Configuration notification rules on Global, Project or Repository level.

Frequently Asked Questions

Frequently Asked Questions can be found at Microsoft Teams Bitbucket Connector product page.

Configuration

Go to the Microsoft Teams channel configuration and add a connector.

microsoft teams bitbucket connector add connector

Find Incoming Webhook and add one. Put the name as Bitbucket and download the Bitbucket logo from here.



Set the logo of the Incoming webhook to the Bitbucket logo and generate the webhook URL. Copy it to the clipboard and save the Incoming Webhook.

Navigate in Bitbucket to the Microsoft Teams Bitbucket Connector administration page (Administration -> Atlassian Marketplace -> Microsoft Teams Connector).

Create a configuration section for every channel, enter the name and paste the incoming webhook URL. Additionally, select the events you want to notify the channel/room about. If something is missing please let us know.



Save the configuration and enjoy!

Global configuration

You can access global configuration by navigating to System → Add-ons → Microsoft Teams Connector. You need to have Global Admin permissions to see this configuration page.

Project level configuration

Bitbucket project level configuration accessible via Project Settings. Please navigate to Project settings → Add-ons → Microsoft Teams Connector.

You must have project admin permission to be able to see this page. You only can configure rules for this project only (including all repositories and branches). You cannot configure other projects from here even if you are an admin on those projects. Particular project rules should be configured in the project settings of that project or on a global level.

Repository level configuration

Bitbucket repository level configuration accessible via Repository Settings. Please navigate to Repository settings → Add-ons → Microsoft Teams Connector.

You must have repository admin permission to be able to see this page. You only can configure rules for this repository only (including all branches and tags). You cannot configure other repositories from this Microsoft Teams Bitbucket Connector page even if you are an admin on those repositories. Particular repository rules should be configured in the repository settings of that project, project level or on a global level.

Proxy configuration

You can go to Global configuration and there is a tab "Global settings" where you can enter your proxy url. Additionally, the default project configuration is used (on the Bitbucket level).

REST API (Internal)

API documentation

Troubleshooting

Update

Please make sure that you have the latest App version, we fix the issue pretty quickly and there is a chance that your problem had been fixed.

Debug mode

Enable the debug mode for a short period to see any errors, warnings for debug information in the logs.

Download the support zip

You can send us the support zip which contains the log files. You can download it following this official Atlassian documentation.

Get help

You can create a Jira Service Desk support request with all information you could gather, please include the screenshot of the configuration (please don't worry about the webhook URLs, we won't store or use them) and the logs or errors you could find in the browser or on the server-side.