Integrating CloudBees Feature Management with Microsoft Teams

3 minute read

The CloudBees Feature Management integration with Microsoft Teams sends messages directly to your subscribed Teams channels to notify you of any changes within your app.

This page describes how to set up Teams notifications for your CloudBees application.

Sending messages directly to Teams provides the following benefits:

  • No need to switch between different tools to be alerted when changes are made to applications and feature flags.

  • Real time notification of changes to applications and flags.

  • Quick access to CloudBees Feature Management applications from within Microsoft Teams to manage flag changes.

You can create one or more notifications to be posted to any Teams channel that you have access to. You can configure notifications to report on changes to all environments or only specific environments.

CloudBees Feature Management notifications for Teams report the following information:

  • The notification name

  • Who made the change

  • The type of change

  • The application name

  • The environment where the change was made

  • Details about the change

You must have access to the Teams channel you are configuring notifications for. Refer to Overview of teams and channels in Microsoft Teams page for more information.

Configuring a channel subscription

You must be an organization or application administrator to create, update, and delete Microsoft Teams integrations within CloudBees Feature Management. All users can view the configured Teams integrations on the integrations page.

You can create one or more subscriptions for reporting application and flag changes to any Microsoft Teams channel that you have access to.

Accessing the Teams webhook URL

The subscription is created with a Teams webhook URL. To access the webhook URL, refer to the Create an Incoming Webhook on the Microsoft website.

The incoming webhook title is included with all Teams channel notifications.

Setting up the subscription

  1. From the CloudBees Feature Management Home page, select the organization that you want to configure notifications for.

  2. From the top left corner, select the application.

  3. From the left pane, select App settings.

  4. From the top of your screen, select the Integrations tab.

  5. In the Microsoft Teams section, select Create.

    The Microsoft Teams integration.

    In the New notification dialog, configure the following:

  6. For Name, enter a name to display in the CloudBees Feature Management Integrations tab. This name is not displayed within Teams.

    New notification dialog
  7. For Event type select All changes per application or Changes in specific environments.

    1. If Changes in specific environments is selected, for Environment select the environment.

  8. For Webhook URL paste the Teams webhook URL. Refer to Accessing the Teams webhook URL for more information.

  9. Select Create.

The channel configuration is created and displayed in the Microsoft Teams section.

A new notification is displayed in the Teams integration.

A notification is sent to the Microsoft Teams channel with the following information:

  • The Teams webhook title

  • The integration notification source: CloudBees Feature Management

  • Who created the notification

  • The environment

New changes to flags in the configured environments are posted to the subscribed Teams channel with the following information:

  • The Teams webhook title

  • The name and email of who made the change

  • A link to the application

  • A link to the environment

  • A link to the flag

  • The type of changes that were made

Deleting a channel subscription

Channel subscriptions can be deleted from the CloudBees Feature Management dashboard.

  1. From the CloudBees Feature Management Home page, select the organization that you want to delete notifications for.

  2. From the top left corner, select the application.

  3. From the left pane, select App settings.

  4. From the top of your screen, select the Integrations tab.

  5. In the Microsoft Teams section, select the Delete this subscription trashcan icon.

    Selecting Delete this subscription.
  6. If you agree with the Delete notification dialog information select Yes, Delete.

    Are you sure you would like to delete this notification? There is no undo action on delete.

The notification is deleted from CloudBees Feature Management, and removed from the Microsoft Teams section.

The Teams channel is notified that a CloudBees CloudBees Feature Management integration has been removed and the type of changes that will no longer be notified to the channel.