Microsoft Teams integration support for service hooks is retiring as of December 31, 2024 for new integrations and January 31, 2025 for existing integrations. We recommend using Power Automate workflows to provide maximum security for your data. For more information, see Retirement of Office 365 connectors within Microsoft Teams.
Azure DevOps Services
Note
This feature is only available on Azure DevOps Services. Typically, new features are introduced in the cloud service first, and then made available on-premises in the next major version or update of Azure DevOps Server. For more information, see Azure DevOps Feature Timeline.
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.
Note
Azure Pipelines notifications aren't supported inside Teams chat or direct messages.
Prerequisites
Access to a Team in Microsoft Teams where you can add an app.
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.
To list all pipelines subscriptions, run the @azure pipelines subscriptions command.
To remove a subscription, select View all subscriptions. Select Remove under any subscription you don't want, and then select OK.
To add a subscription, select Add subscription.
Select the event and the pipeline you want to subscribe to, and select Next.
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.
Note
Team Administrators can't remove or modify subscriptions that are created by Project Administrators.
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.
Note
You can't subscribe to deployment approvals that have the Revalidate identity of approver before completing the approval policy applied.
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.
Important
Only Project Administrators can run this command.
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.
Microsoft Teams
Azure DevOps
Sign in action
email1@abc.com (tenant1)
email1@abc.com (tenant1)
Select Sign in
email1@abc.com (tenant1)
email2@pqr.com (tenant2)
1. Sign in to Azure DevOps. 2. In the same browser, start a new tab and go to https://teams.microsoft.com/. 3. Run the sign in command and select Sign in.
email1@abc.com (tenant1)
email2@pqr.com (tenant2)
1. Select Sign in with different email address. 2. In the email ID picker, use the email2 to sign in.
email1@abc.com (tenant1)
email2@pqr.com (nondefault tenant3)
Not supported.
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.
Learn how to build and distribute Microsoft Teams apps that retrieve user information using the Microsoft Graph API. Practice building and deploying apps in the guided project at the end of the learning path.
Demonstrate skills to plan, deploy, configure, and manage Microsoft Teams to focus on efficient and effective collaboration and communication in a Microsoft 365 environment.