Skip to main content

Configuring Slack and Teams notifications for releases

Abstract

You can enable Slack and Microsoft Teams notifications for Bitrise Release Management events. You need to create an incoming webhook at your preferred service (or both), and add the webhook URL in Release Management.

You can enable Slack and Microsoft Teams notifications for Release Management events. You need to create an incoming webhook at your preferred service (or both), and add the webhook URL in Release Management.

Standard plan only

This feature is only available on the Standard plan. It is not available on a Basic plan.

Configuring notifications for a release

You can configure notifications for each individual release:

  1. Configure an incoming webhook at Slack or Teams.

  2. Open Release Management, and select your app from the Connected apps list.

    rm-overview-connected.png

  3. Select Releases and then select the release you need.

  4. Select Configuration on the left navigation bar.

  5. Go to the Notifications tab.

    release-config-notifications_083123_015406_PM.jpg

  6. In the Connected services section, find your service, and click Edit in its section.

  7. In the dialog, copy and paste your webhook URL in the URL field and click Save.

Configuring notifications as a release preset

You can configure notifications as a release preset. These notification settings will be applied to every new release afterwards.

  1. Configure an incoming webhook at Slack or Teams.

  2. Open Release Management and select your app from the Connected apps list.

  3. Select Presets from the left navigation menu.

    release-presets-notif.png

  4. In the Notifications section, find your service, and click the ellipsis next to it.

  5. Click Edit webhook URL.

  6. In the dialog, copy and paste the webhook URL in the URL field and click Save.

    You can also send a test notification to make sure your notification works before saving.

Notification events

Table 1. RM events for iOS apps

Stage

Event

Event description

Release candidate

Release candidate set

This event is triggered each time there is a new release candidate is selected in the Release candidate stage. This can happen automatically (a new build generated a new IPA) or manually (the release manager locks a specific artifact on the Release candidate stage).

TestFlight upload

Upload and processing finished

This event is triggered when TestFlight processing is finished for an uploaded IPA. First we upload the IPA to TestFlight, then the TestFlight processing starts. When the processing finishes, we trigger the event.

Approved by TestFlight App Review

This event is triggered when Apple approves the beta app review that is required for sharing the app with external beta testers.

Rejected by TestFlight App Review

This event is triggered when Apple rejects the beta app review that is required for sharing the app with external beta testers.

Approvals

Release approved

This event is triggered when all tasks are approved at the Approval stage. It will not be triggered for each approval, only when all tasks are done.

App Store review

Release sent for review

This event happens when the store review submission starts. (Release Manager clicks on the submit button, and Apple accepts it)

Status of review submission changed

This event is triggered each time there is a change in the status of the review submission. (Approved, rejected, canceled)

Release

Release started

This event is triggered after the submission was accepted, and the release rollout started (so the new version becomes available in App Store Connect)

Release finished

This event is triggered when the release in Release Management completes.

Table 2. RM events for Android apps

Stage

Event

Event description

Release candidate

Release candidate set

This event is triggered each time there is a new release candidate is selected in the Release Candidate stage. This can happen automatically (a new build generated a new AAB) or manually (the release manager locks a specific artifact on the Release candidate stage).

Google Play upload

Upload and processing finished

This event is triggered after the AAB is uploaded to Google Play console and is available in the App bundle explorer.

Release on testing track

This event is triggered after the release candidate is released on a Google Play testing track.

Approvals

Release approved

This event is triggered when all tasks are approved at the Approval stage. It will not be triggered for each approval, only when all tasks are done.

Release

Release started

This event is triggered when a release is started. It can be a full release or a staged rollout. For a staged rollout, it only happens once, at the first rollout.

Release finished

This event is triggered when release is completed in Release Management.

Rollout percentage changed

This event is triggered if the rollout percentage changes from any percentage other than 0%. For example, if the rollout percentage goes from 10% to 20%. It is NOT triggered when the first rollout happens.

In this section: