- Zulip supports both Git and Mercurial notifications from - Bitbucket. This integration is for the old-style Bitbucket - webhooks used by Bitbucket Enterprise. -
- -
- First, create the stream you'd like to use for Bitbucket notifications,
- and subscribe all interested parties to this stream. The integration will
- use the default stream commits if no stream is supplied in the
- hook; you still need to create the stream 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." Make sure to replace the
- @ in the bot's email address with %40,
- as Bitbucket will not execute the hook if the username contains a @.
-
- In the URL field, enter
- {{ external_uri_scheme }}bot_email:bot_api_key@{{ external_api_path_subdomain }}/v1/external/bitbucket
-
- Or, you can also limit the notifications you receive to specific - branches by specifying them in a comma-separated list at the end - of the URL, like so: -
-{{ external_uri_scheme }}bot_email:bot_api_key@{{ external_api_path_subdomain }}/v1/external/bitbucket?branches=master,development
-
-
- By default, notifications are sent to the commits stream.
- To send notifications to a different stream,
- append ?stream=stream_name to
- the URL.
-
- Congratulations! You're done!
Whenever you push code to your repository,
- you'll get an automated notification that looks like this:
-
diff --git a/zerver/webhooks/bitbucket/doc.md b/zerver/webhooks/bitbucket/doc.md
new file mode 100644
index 0000000000..e92cb5b4f0
--- /dev/null
+++ b/zerver/webhooks/bitbucket/doc.md
@@ -0,0 +1,27 @@
+Zulip supports both Git and Mercurial notifications from
+Bitbucket. This integration is for the old-style Bitbucket
+webhooks used by Bitbucket Enterprise.
+
+{!create-stream.md!}
+
+The integration will use the default stream `commits` if no
+stream is supplied in the hook; you still need to create the
+stream 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**.
+
+{!webhook-url-with-bot-email.md!}
+
+{!git-append-branches.md!}
+
+By default, notifications are sent to the `commits` stream. To
+send notifications to a different stream, append
+`?stream=stream_name` to the URL.
+
+
+
+{!congrats.md!}
+
+