Notifications for Bitbucket Pipelines

Bitbucket Pipelines can send notifications to your team's chat room, and to your email.

See also:

Chat notifications

Hipchat

It's easy to get Pipelines to notify Hipchat rooms about build result successes and failures:

Read more about setting up notifications for Hipchat.

Slack

Pipelines can notify Slack about branch and build results, in addition to the existing Bitbucket notifications.

If you had the legacy integration app installed, you will want to remove it first to avoid duplicate notifications.

Install the Slack app

  1. Open the repository you wish to configure notifications for.
  2. Click Settings then select Chat notifications > Settings.
  3. Press the Connect button under Slack. A dialog for Slack login might open if you are not already logged in.
  4. Choose the Slack workspace to connect to your repository.

You should receive an automated welcome message in Slack.

Then you can choose which notifications to receive, in the repository specific settings. Notifications can be configured for the whole repository or on a per-branch basis.

  1. Open one of the repositories you connected to Slack.
  2. Click Settings then select Chat notifications > Settings.
  3. Enter or select a branch or branch pattern, or select repository-wide to get notifications for all branches. 
  4. Select the notifications to receive for the branch.
    Note: It can be helpful to set notifications on a per-branch basis. For example, it may be important to receive pipeline fixed notifications for your master branch, but not for other branches in the repository.

For Pipelines we have 3 specific notifications:

  • pipeline succeed
  • pipeline failed
  • pipeline fixed (for a successful completion after a failed attempt)

The default configuration is shown here:

Image of default notifcation setting

Note: build failed and build succeeded are for external build tools and are different to pipeline notifications.

If you receive failed pipeline notifications in Slack, you can re-run your failed build from within your Slack channel.

an image of a hopeful but failed pipeline

Where's Stride?

You can get lots of notifications from the Bitbucket app in Stride, but, so far, none specifically for your Pipelines builds. We are working on it!  However we know that, as Stride is a sparkling new product, more of you are using Slack right now, so we prioritized that integration. 

Email notifications

You can get emails about:

  • when you push and the pipeline fails.
  • all failed pipelines in a repository.

If you provided your email in the Bitbucket settings for your account, you'll get notified each time your push triggers a pipeline that fails:

Currently, you can unsubscribe from notifications by following the steps in Enabling or disabling email.

Manual steps and notifications

Pipeline completion notifications are sent when there are no further steps that can be run in the pipeline. This means notifications are sent when:

  • the initial automated steps in the pipeline are complete, even if later manual steps remain to be run
  • when a manual step (and any following automated steps) completes, even if later manual steps remain to be run.

This is designed to cover the primary use case of manual steps being used for deployments, where the team should be notified about deployments.

Some notification channels (e.g. HipChat) allow filtering of build status, which can be used to further filter notifications from manual steps.


Generic webhooks

You can set up notifications for other services by creating webhooks.

You can add the following webhooks specific to Pipelines:

Last modified on Jun 4, 2018

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.