Using Zoom chat integration for Atlassian Bitbucket Chatbot

The Atlassian Bitbucket Integration with Zoom gives you the opportunity to receive notifications directly from a robot regarding build notifications and messages from a bot as they relate to a specific channel in Zoom.

Prerequisites for the Atlassian Bitbucket Chatbot

• Admin account for Atlassian Bitbucket

• Your Bitbucket settings should have development mode enabled

• Bitbucket chatbot has been pre-approved as a part of the Zoom Marketplace
  Note: Your Zoom administrator will be able to assist you if the app has not been pre-approved.

How to add and configure the Atlassian Bitbucket Chatbot

Add the integration from the Zoom App Marketplace

1. Log in with your Zoom account to access the Zoom App Marketplace.

2. Enter “Bitbucket” in the search box that appears on the upper right side of your screen.

3. The Bitbucket Notifications app can be found in the search results and can be clicked on.
   Note: It is recommended that you contact your Zoom administrator if the app is not pre-approved on your account in order to have it approved.

4. Please click the Add button.

5. Click on the Allow button after you have confirmed the app’s permission requirements.

Note: Zoom desktop client will be configured to automatically install the Bitbucket chatbot if your administrator has installed the Bitbucket chatbot for your account.

Configure the Bitbucket chatbot

The next step will need to be completed by an account administrator on your Bitbucket account.

1. Zoom’s desktop client can be accessed by signing in.

2. You will find the Chat tab on the left side of the screen.

3. If you are looking for a Bitbucket chatbot, you need to search under apps.
   Additionally, you have the option to choose the channel in which you would like to receive notifications about Bitbucket builds.

4. You will need to enter the URL for the repository (or the Bitbucket URL for the repository).

5. The connection to Bitbucket needs to be authorized by clicking the link below.
   This chat channel will now be used to send you notifications for new builds.

How to use the Bitbucket Notifications app

1. Help: If you type help, you will be able to see a list of all the commands available to you.

2. Connect: Connecting to your Bitbucket account is as simple as typing the word connect.
   Note: By adding the URL of your repository after you have typed connect, you will be able to add your repository URL.

3. Disconnect: When you type disconnect, the Bitbucket account associated with Zoom will be disconnected from Bitbucket. To confirm the disconnect, click the Disconnect button.

4. Configure: Connect your repo by typing configure in the command line. As soon as you type configure, you can include the URL of your repo so that it can be configured.

How to change the subscription settings on Bitbucket

1. Then open the repository that you wish to work on in Bitbucket.

2. Click on the Settings button

3. You can turn on chat notifications by clicking the Zoom Bitbucket Chatbot button.

4. The Bitbucket Chatbot in Zoom Chat can be configured to send you custom notifications when the Bitbucket API is updated.

How to remove the Bitbucket Notifications app

1. Log in with your Zoom account to access the Zoom App Marketplace.

2. Click on the Manage button at the top of the page, which can be found in the right corner.

3. Select the Added Apps option from the navigation menu at the top of the page.

4. If you select Bitbucket Notifications in the list of apps, click Remove next to it.

5. Click the Remove button to confirm that you wish to remove the item.

Data security

Using this app, you will be able to access the following Zoom information:

• Using the Zoom account, you can view all the groups that a Zoom user has subscribed to.

• The Zoom account allows you to view the details of existing meetings for a Zoom user.

• Under the Zoom account, you can view information about a Zoom user.

The following information on Bitbucket can be accessed by this app:

• It is your responsibility to maintain your builds and repositories.

  • We have read-only access to this information.

Zoom has granted the following permissions to this chat app:

• You can use this app to send a chat message to a Zoom user under your Zoom account or to an IM channel under your Zoom account.

• As part of this chat app you can invite any Zoom user under your Zoom account to join a Zoom meeting.

This chat application communicates encryptedly with Zoom/Bitbucket through the following protocols:

• Protocol: TLS 1.2

• Cipher suite: ECDHE-ECDSA-AES128-GCM-SHA256

• Key length: 128 bits

• Perfect Forward secrecy: YES

The following credentials are stored in the local data store of this chat app:

• An encrypted database is used to store the Bitbucket OAuth credentials and Zoom OAuth credentials (both are available only to admins).

Zoom Support can provide you with additional assistance if you need it.