Integrate Azure Pipelines with Microsoft Teams

Azure DevOps Services

This article shows you how to use the Azure Pipelines app for Microsoft Teams to monitor pipeline events. You can set up and get notifications in your Teams channel for pipeline builds, releases, and approvals. Approvers can also approve releases from within the Teams channel.

Prerequisites

• Access to a Team in Microsoft Teams where you can add an app.
• Project Administrator or Build Administrator permissions in an Azure DevOps project. For more information, see Create a project and Pipeline security resources.
• Third party application access via OAuth enabled in Azure DevOps organizational settings.

Set up the Azure Pipelines app

1. In Microsoft Teams, select Apps, search for Azure Pipelines, and then select Azure Pipelines.

   

2. Select the dropdown arrow next to Add, and select Add to a team.

   

3. Select or enter your team name, and then select Set up a bot.

   

Use Azure Pipelines app commands

The Azure Pipelines Teams app supports the following commands:

Sign in to Azure Pipelines

1. In the Teams conversation pane, enter @azurePipelines signin.
2. Select Sign in and complete authentication to Azure Pipelines.

Subscribe to pipelines

Use the following commands to subscribe to and monitor all pipelines in a project or only specific pipelines.

• All pipelines in a project: The URL can be to your project or any page within your project, except to a pipeline. For example:

  @azure pipelines subscribe https://dev.azure.com/myorg/myproject/
  

• A specific pipeline: The pipeline URL can be to any page within a pipeline that has a definitionId or buildId/releaseId in the URL. For example:

  @azure pipelines subscribe https://dev.azure.com/myorg/myproject/_build?definitionId=123
  

Expand linked notifications

All replies for a particular post are linked together.

To expand the thread, select the compacted thread link.

Manage subscriptions

When you subscribe to a pipeline, a few subscriptions get created by default without any filters applied. These subscriptions include Run state changed and Run stage waiting for approval for YAML pipelines, and Release deployment approval pending for Classic releases. You can remove these subscriptions or add more subscriptions.

The Azure Pipelines app also supports filters to customize what you see in your channel. For example, you might want to get notified only when builds fail or when deployments get pushed to a production environment.

To manage your subscriptions, complete the following steps.

1. To list all pipelines subscriptions, run the @azure pipelines subscriptions command.

   

2. To remove a subscription, select View all subscriptions. Select Remove under any subscription you don't want, and then select OK.

3. To add a subscription, select Add subscription.

4. Select the event and the pipeline you want to subscribe to, and select Next.

5. Choose any Stage and Environment filters you want, select Submit, and then select OK.

   For example, the following subscription provides notifications for the _default stage only when the Completed state is Failed.

   

See approval notifications

To see approval notifications, make sure you subscribe to the Run stage waiting for approval notification for YAML pipelines or the Release deployment approval pending notification for Classic releases. These subscriptions are created by default when you subscribe to the pipeline.

If you subscribe to the Run stage approval completed notification, you can also see when the stage is approved.

Approve from your channel

If you're an approver, you can approve deployments from within your Teams channel. The Azure Pipelines app supports all Azure Pipelines checks and approval scenarios. You can approve requests as an individual or for a team.

Whenever the running of a stage is pending your approval, the app posts a notification card with options to Approve or Reject the request in the channel. You can review the details of the request in the notification and take appropriate action.

The response is sent to the app.

If you subscribed to Run stage approval completed notifications, you can also see when the stage is approved.

Unsubscribe from a channel

Run the unsubscribe command to delete all the subscriptions related to any pipeline in the project and remove the pipelines from the channel. For example:

@azure pipelines unsubscribe all https://dev.azure.com/myorg/myproject

To delete the project and all subscriptions from the channel, select Proceed.

Use the compose extension

To help you search and share information about pipelines, the Azure Pipelines app for Teams supports a compose extension in messages. You can use the extension to search for pipelines in a project by pipeline ID or pipeline name.

To use the extension, you must be signed in to the Azure Pipelines project in the Teams channel. Select the + symbol in the message field, select Azure Pipelines, and then search for your pipeline or release.

Preview of pipeline URLs

When you use the compose extension to add a pipeline URL to a Teams message, you see a preview similar to the following images. The preview helps to keep pipeline-related conversations relevant and up to date.

The following example shows a Release URL preview:

Connect multiple tenants

If you use different emails or tenants for Microsoft Teams and Azure DevOps, follow these steps to sign in and connect based on your settings.

Troubleshoot authentication issues

In the same browser, start a new tab and sign in to https://teams.microsoft.com/. Run the @Azure Pipelines signout command and then run the @Azure Pipelines signin command in the channel where the Azure Pipelines app for Microsoft Teams is installed.

Select the Sign in button, and complete the sign-in process. Ensure that the directory shown is the same as what you chose in the previous step.

If these steps don't resolve your authentication issue, reach out to the Developer Community.

Related articles

• Use Azure Boards with Microsoft Teams
• Use Azure Repos with Microsoft Teams