Events
Mar 17, 11 PM - Mar 21, 11 PM
Join the meetup series to build scalable AI solutions based on real-world use cases with fellow developers and experts.
Register nowThis browser is no longer supported.
Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.
Note
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.
In Microsoft Teams, select Apps, search for Azure Pipelines, and then select Azure Pipelines.
Select the dropdown arrow next to Add, and select Add to a team.
Select or enter your team name, and then select Set up a bot.
The Azure Pipelines Teams app supports the following commands:
Slash command | Functionality |
---|---|
@azure pipelines signin | Sign in to your Azure Pipelines account. |
@azure pipelines signout | Sign out from your Azure Pipelines account. |
@azure pipelines subscribe <pipeline url | project url> | Subscribe to a pipeline or all pipelines in a project to receive notifications. |
@azure pipelines subscriptions | View, add, or remove subscriptions for this channel. |
@azure pipelines unsubscribe all <project url> | Remove all pipelines belonging to a project and their associated subscriptions from a channel. |
@azure pipelines help | Get help on the commands. |
@azure pipelines feedback | Report a problem or suggest a feature. |
@azurePipelines signin
.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
All replies for a particular post are linked together.
To expand the thread, select the compacted thread link.
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.
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.
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.
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.
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.
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:
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. |
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.
Events
Mar 17, 11 PM - Mar 21, 11 PM
Join the meetup series to build scalable AI solutions based on real-world use cases with fellow developers and experts.
Register nowTraining
Learning path
Build collaborative apps for Microsoft Teams - Training
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.
Certification
Microsoft 365 Certified: Teams Administrator Associate - Certifications
Demonstrate skills to plan, deploy, configure, and manage Microsoft Teams to focus on efficient and effective collaboration and communication in a Microsoft 365 environment.
Documentation
Azure DevOps integration with Microsoft Teams - Azure DevOps
See how to set up Azure DevOps notifications and approvals in your Microsoft Teams channels.
Use Azure Repos with Microsoft Teams - Azure Repos
Monitor Azure Repos from Microsoft Teams.
Workplace Messaging Apps with Azure DevOps - Azure DevOps
Integrate workplace messaging apps like Microsoft Teams and Slack with your Azure DevOps organization