Bitbucket Mattermost Webhook

Serves as a bridge that translates the Bitbucket webhooks into Mattermost webhooks.

Configuration

Set the following environment variables to provide the Mattermost server details:

• MATTERMOST_SERVER_PORT - Default: 80
• MATTERMOST_SERVER_PATH - Default: /hooks/
• MATTERMOST_SERVER_PROTO - Default: http
• MATTERMOST_SERVER - Default: localhost

Integration

• Install the required modules by running npm install
• Start the app by running npm start
• Configure Mattermost server and create a new incoming webhooks and note the hook-id (the part that appears after hooks in the hook URL.
• Configure Bitbucket Webhooks to forward the hook (for the required JQL) to http://<jira-matter-bridge-server>:3000/hooks/<mattermost hook id>
• That's it.

Docker Version

• Change your environment variable in docker-compose.yml
• Execute docker-compose up

Hosted Version

• The app is hosted on a free dyno at https://matterhost-webhook-bitbucket.herokuapp.com/
• If the Mattermost server and Bitbucket server are on public domain, you can directly use this hosted version.
• In the Bitbucket Server, configure the webhook URL as given in this example
• https://matterhost-webhook-bitbucket.herokuapp.com/hooks/<hookid from your mattermost server>?matterurl=<your mattermost server base url>
• E.g.:
• https://matterhost-webhook-bitbucket.herokuapp.com/hooks/ckshz5joqigkfmj6po7fm4r8wh?matterurl=https://someserver.com
• https://matterhost-webhook-bitbucket.herokuapp.com/hooks/ckshz5joqigkfmj6po7fm4r8wh?matterurl=http://someserver.com:3000
• https://matterhost-webhook-bitbucket.herokuapp.com/hooks/ckshz5joqigkfmj6po7fm4r8wh?matterurl=https://someserver.com:8443

⚠️ Since this is hosted on a free dyno, there is no guarantee that the messages will be delivered and it is recommended that you use a paid dyno at Heroku using this repository as source.