Skip to content

Commit 833e762

Browse files
authored
Merge pull request #8463 from MicrosoftDocs/users/chcomley/more-updates-slack
More Slack updates based on Word doc
2 parents 11cf30a + 44e3b98 commit 833e762

File tree

7 files changed

+18
-40
lines changed

7 files changed

+18
-40
lines changed

docs/boards/integrations/boards-slack.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ ms.reviewer: karrg
99
ms.author: chcomley
1010
author: chcomley
1111
monikerRange: 'azure-devops'
12-
ms.date: 09/22/2025
12+
ms.date: 10/24/2025
1313
ms.custom:
1414
- cross-service
1515
- sfi-image-nochange

docs/boards/integrations/boards-teams.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ ms.custom:
1414
- cross-service
1515
- sfi-image-nochange
1616
---
17-
17+
1818
# Use Azure Boards in Microsoft Teams
1919

2020
[!INCLUDE [version-eq-azure-devops](../../includes/version-eq-azure-devops.md)]

docs/boards/integrations/includes/boards-troubleshoot-authentication.md

Lines changed: 2 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
ms.topic: include
33
---
44

5-
### Configuration failed. Please make sure that the organization '{organization name}' exists and that you have sufficient permissions.
5+
### Configuration failed. Make sure that the organization '{organization name}' exists and that you have sufficient permissions.
66

77
To resolve this authentication issue, complete the following steps:
88

@@ -17,9 +17,4 @@ To resolve this authentication issue, complete the following steps:
1717
> [!div class="mx-imgBorder"]
1818
> ![Screenshot that shows selecting the directory that contains the organization that contains the project.](../media/troubleshooting/profile-page.png)
1919
20-
5. In the **same browser**, start a new tab, go to `https://slack.com`, and sign in to your work space (**use web client**). Run the `/azboards signout` command followed by the `/azboards signin` command.
21-
22-
6. Select the `Sign in` button and you get redirected to a consent page like the one in the following example. Ensure that the directory shown beside the email is same as what was chosen in the previous step. Accept and complete the sign-in process.
23-
24-
> [!div class="mx-imgBorder"]
25-
> ![Consent to the requested app permissions](../media/troubleshooting/boards-consent-page-slack.png)
20+
5. In the **same browser**, start a new tab, go to `https://slack.com`, and sign in to your work space (**use web client**). Run the `/azboards signout` command followed by the `/azboards signin` command.

docs/pipelines/integrations/includes/troubleshoot-authentication.md

Lines changed: 4 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -5,18 +5,11 @@ title: Azure Pipelines with Slack
55
ms.manager: bijuv
66
ms.author: atinb
77
author: atinb
8-
ms.date: 7/22/2024
8+
ms.date: 10/24/2025
99
---
1010

11-
If you get the following errors when using the Azure Pipelines App for Slack, try the procedures in this section.
11+
If you get the following errors when using the Azure Pipelines App for Slack, try the following procedure.
1212

13-
### Sorry, something went wrong. Please try again.
14-
15-
The Azure Pipelines app uses the OAuth authentication protocol, and requires [Third-party application access via OAuth](../../../organizations/accounts/change-application-access-policies.md) to be enabled. To enable this setting, navigate to **Organization Settings** > **Security** > **Policies**, and enable **Third-party application access via OAuth**.
16-
17-
:::image type="content" source="../media/troubleshooting/third-party-app-consent.png" alt-text="A screenshot showing how to enable third party access via OAuth.":::
18-
19-
### Configuration failed. Please make sure that the organization exists and that you have sufficient permissions.
20-
21-
If you're seeing this error, you're most likely a Guest user in the Entra tenant connected to your Azure DevOps organization. You'll need to have an Entra Member go through the configuration steps.
13+
### Configuration failed. Make sure that the organization exists and that you have sufficient permissions.
2214

15+
If you're seeing this error, you're most likely a Guest user in the Microsoft Entra tenant connected to your Azure DevOps organization. You need to have a Microsoft Entra member go through the configuration steps.

docs/pipelines/integrations/slack.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ This article shows you how to use the [Azure Pipelines app for Slack](https://sl
2121

2222
- A Slack account with permission to install an app to your Slack workspace.
2323
- An Azure DevOps project with **Project Collection Administrators** or **Project Administrators** permissions.
24-
- Must not be an external user in Entra.
24+
- Must not be an external user in Microsoft Entra.
2525

2626
## Install the Azure Pipelines app
2727

@@ -36,7 +36,7 @@ Once the app is installed in your Slack workspace, you can connect the app to an
3636
:::image type="content" source="media/integrations-slack/sign-in.png" alt-text="A screenshot showing the sign-in prompt message.":::
3737

3838
> [!NOTE]
39-
> If your Azure DevOps organization is connected to an Entra ID tenant, you must sign in with a native member of that tenant. External users will see the following error if they try to sign in to the Azure Pipelines app: `Configuration failed. Please make sure that the organization exists and that you have sufficient permissions.`
39+
> If your Azure DevOps organization is connected to a Microsoft Entra ID tenant, you must sign in with a native member of that tenant. External users receive the following error if they try to sign in to the Azure Pipelines app: `Configuration failed. Please make sure that the organization exists and that you have sufficient permissions.`
4040
4141
## Subscribe to pipelines
4242

@@ -125,4 +125,4 @@ The Azure Pipelines app can also help you monitor pipelines activity in your pri
125125
## Related articles
126126
- [Azure Boards with Slack](../../boards/integrations/boards-slack.md)
127127
- [Azure Repos with Slack](../../repos/integrations/repos-slack.md)
128-
- [Service hook for Azure DevOps with Slack](../../service-hooks/services/slack.md)
128+
- [Service hook for Azure DevOps with Slack](../../service-hooks/services/slack.md)

docs/repos/integrations/repos-slack.md

Lines changed: 3 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ ms.manager: bijuv
99
ms.author: Divais
1010
author: Divais
1111
monikerRange: 'azure-devops'
12-
ms.date: 09/22/2025
12+
ms.date: 10/24/2025
1313
ms.custom:
1414
- cross-service
1515
- sfi-image-nochange
@@ -26,7 +26,7 @@ If you use [Slack](https://slack.com), you can use the [Azure Repos app for Slac
2626
| Category | Requirements |
2727
|--------------|-------------|
2828
| Platform | Azure Repos Slack app works only with Azure DevOps Services (cloud); it isn't supported on Azure DevOps Server. |
29-
| Permissions | To create subscriptions in a Slack channel for repository-related events: Member of the **Project Administrators** group or team administrator. For more information, see [Change project-level permissions](../../organizations/security/change-project-level-permissions.md) or [Add a team administrator](../../organizations/settings/add-team-administrator.md). To receive notifications: **Third-party application access via OAuth** setting enabled for the organization. For more information, see [Change application access policies for your organization](../../organizations/accounts/change-application-access-policies.md). |
29+
| Permissions | To create subscriptions in a Slack channel for repository-related events: Member of the **Project Administrators** group or team administrator. For more information, see [Change project-level permissions](../../organizations/security/change-project-level-permissions.md) or [Add a team administrator](../../organizations/settings/add-team-administrator.md). |
3030
| Microsoft Entra account | If your organization is connected to a Microsoft Entra ID tenant, sign in with an account that is a native member of that tenant; guest or external accounts can experience authentication errors when signing in through Slack. |
3131

3232
## Add the Azure Repos app to your Slack workspace
@@ -200,12 +200,7 @@ If you're experiencing the following errors when using the [Azure Repos App for
200200

201201
[!INCLUDE [troubleshooting](./includes/repos-troubleshoot-authentication.md)]
202202

203-
In the **same browser**, start a new tab, navigate to `https://slack.com`, and sign in to your work space (**use web client**). Run the `/azrepos signout` command followed by the `/azrepos signin` command.
204-
205-
Select the `Sign in` button and you're redirected to a consent page like the one in the following example. Ensure that the directory shown beside the email is same as what was chosen in the previous step. Accept and complete the sign in process.
206-
207-
> [!div class="mx-imgBorder"]
208-
> ![Screenshot shows Consent to the requested app permissions.](media/troubleshooting/repos-consent-page-slack.png)
203+
In the **same browser**, start a new tab, navigate to `https://slack.com`, and sign in to your work space (**use web client**). Run the `/azrepos signout` command followed by the `/azrepos signin` command.
209204

210205
If these steps don't resolve your authentication issue, reach out to us at [Developer Community](https://developercommunity.visualstudio.com/spaces/21/index.html).
211206

docs/repos/integrations/repos-teams.md

Lines changed: 4 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ ms.service: azure-devops
66
ms.subservice: azure-devops-integration
77
ms.topic: how-to
88
monikerRange: 'azure-devops'
9-
ms.date: 05/22/2023
9+
ms.date: 10/24/2025
1010
ms.custom:
1111
- cross-service
1212
- sfi-image-nochange
@@ -33,7 +33,7 @@ In this article, learn how to do the following tasks:
3333

3434
| Category | Requirements |
3535
|--------------|-------------|
36-
|**Permissions**|- To create subscriptions for repo-related events: Member of the **Project Administrators** group or team administrator. For more information, see [Change project-level permissions](../../organizations/security/change-project-level-permissions.md) or [Add a team administrator](../../organizations/settings/add-team-administrator.md).<br>- To receive notifications: **Third-party application access via OAuth** setting enabled for the Azure DevOps organization. For more information, see [Change application access policies for your organization](../../organizations/accounts/change-application-access-policies.md).|
36+
|**Permissions**|- To create subscriptions for repo-related events: Member of the **Project Administrators** group or team administrator. For more information, see [Change project-level permissions](../../organizations/security/change-project-level-permissions.md) or [Add a team administrator](../../organizations/settings/add-team-administrator.md).|
3737

3838
> [!NOTE]
3939
> * You can only link the Azure Repos app for Microsoft Teams to a project hosted on Azure DevOps Services.
@@ -145,14 +145,14 @@ The following table lists all the `azure repos` commands you can use in your Tea
145145
|`@azure repos feedback` | Report a problem or suggest a feature |
146146
| `@azure repos unsubscribe all [project url]` | Remove all repos (belonging to a project) and their associated subscriptions from a channel |
147147

148-
## Multi-tenant support
148+
## Multitenant support
149149

150150
If you're using a different email or tenant for Microsoft Teams and Azure DevOps, do the following steps to sign in, based on your use case.
151151

152152
|Use case |Email ID + Microsoft Teams tenant|Email ID + Azure DevOps tenant|Steps |
153153
|---------|---------|---------|---------|
154154
|1 |[email protected] (tenant 1) | [email protected] (tenant 1) | Select **Sign in**. |
155-
|2 |[email protected] (tenant 1) | [email protected] (tenant 2) |Sign in to Azure DevOps. In the same browser, start a new tab and go to https://teams.microsoft.com/. Run the signin command and select **Sign in**. |
155+
|2 |[email protected] (tenant 1) | [email protected] (tenant 2) |Sign in to Azure DevOps. In the same browser, start a new tab and go to https://teams.microsoft.com/. Run the sign-in command and select **Sign in**. |
156156
|3 |[email protected] (tenant 1) | [email protected] (tenant 2) | Select **Sign in with different email address**, and then in the email ID picker use the email2 to sign in to Azure DevOps. |
157157
|4 |[email protected] (tenant 1) | [email protected] (non default tenant 3) | This scenario isn't supported. |
158158

@@ -164,11 +164,6 @@ If you're experiencing the following errors when using the Azure Repos App, foll
164164

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

167-
Select the `Sign in` button and you're redirected to a consent page like the one in the following example. Ensure that the directory shown beside the email is same as what was chosen in the previous step. Accept and complete the sign-in process.
168-
169-
> [!div class="mx-imgBorder"]
170-
> ![Consent to the requested app permissions](media/troubleshooting/repos-consent-page-teams.png)
171-
172167
If these steps don't resolve your authentication issue, reach out to us at [Developer Community](https://developercommunity.visualstudio.com/spaces/21/index.html).
173168

174169
## Related articles

0 commit comments

Comments
 (0)