Bitbucket Server

Atlassian Bitbucket Server Integration

This app can also work in a fully air-gapped environment. Follow the Air-gapped App Installation guide and continue with the configuration instructions below.

Install Bitbucket Server App

To install the Bitbucket Server App,

• Navigate to Administration > Apps > Marketplace.

• Search for the Bitbucket Server Integration app.

• Click Install.

• Agree to the permissions to confirm the installation.

Configure Bitbucket Server App

Connect a channel or private room to one or more Bitbucket repositories to enable notifications.

To configure the Bitbucket Server App,

• Run the slash command /bitbucket-server connect REPO_URL, where:

  • REPO_URL: The URL of the repository you want to connect to, e.g., http://example.com:7990/bitbucket/projects/PROJECT_1/repos/repo1/browse.

• You'll receive an ephemeral message with further instructions on how to add a Webhook to your Bitbucket repository.

• Navigate to your Bitbucket repository and create a new Webhook. In the URL field, paste the URL that was generated for you in the ephemeral message, e.g., https://example.com:3000/api/apps/private/d98e7da9-2398-4bd1-a596-d5cac28468bd/zC5r4DxBQSTHfrhLg/webhook?repoId=aHR0cDovL2xcY2FsaG9zdDo30TkwL2Jpd6J1Y2t1dHxQUk9KRUNUXzF8cmVwzE=
• Then, Bitbucket sends notifications on some events to the connected channel or private room.

Only some of the available events are interpreted by the Rocket.Chat App. They include Repository Push, Pull Request Opened, Approved, Merged, and Declined. Any webhook sent to Rocket.Chat from other events will not result in any notification being sent.

Example of chosen events

To connect the same repository to another channel or private group, repeat the process on them using the same repository URL.