Zulip supports both Git and Mercurial notifications from Bitbucket. This integration is for the old-style Bitbucket webhooks used by Bitbucket Enterprise.

Create the channel you'd like to use for Bitbucket notifications.

The integration will use the default channel commits if no channel is supplied in the hook; you still need to create the channel even if you are using this default.

Next, from your repository's web page, go to the Administration page and choose Hooks on the left-hand side. Choose the POST hook from the list presented and click Add hook.

Construct the URL for the Bitbucket bot using the bot's API key and email address:

https://bot_email:bot_api_key@chat.zulip.org/api/v1/external/bitbucket

Modify the parameters of the URL above, where bot_email is the bot's URL-encoded email address and bot_api_key is the bot's API key. To URL-encode the email address, you just need to replace @ in the bot's email address with %40.

You can also limit the branches you receive notifications for by specifying them in a comma-separated list appended to the end of the URL, e.g., &branches=main,development.

By default, notifications are sent to the commits channel. To send notifications to a different channel, append ?stream=channel_name to the URL.

You're done! Your Bitbucket notifications may look like this: