Skip to content

Commit 2abf540

Browse files
committed
remove duplicated info
1 parent bf78d61 commit 2abf540

File tree

2 files changed

+18
-23
lines changed

2 files changed

+18
-23
lines changed

docs/boards/integrations/boards-slack.md

Lines changed: 7 additions & 11 deletions
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/17/2025
12+
ms.date: 09/22/2025
1313
ms.custom:
1414
- cross-service
1515
- sfi-image-nochange
@@ -39,9 +39,6 @@ events in their Slack channel. Conversations in the Slack channel can be used to
3939
| **Permissions** | To create subscriptions in a Slack channel for work item events: Member of the [Project Administrators](../../organizations/security/change-project-level-permissions.md) or [Team Administrators](../../organizations/settings/add-team-administrator.md) group. |
4040
| **Policies** | To receive notifications: [**Third party application access via OAuth** policy enabled for the organization](../../organizations/accounts/change-application-access-policies.md). |
4141

42-
> [!NOTE]
43-
> 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 might see authentication errors when attempting to sign in through Slack.
44-
4542
## Add the Azure Boards app to your Slack workspace
4643

4744
1. To install the Azure Boards app to your Slack workspace, open a web browser, sign into Slack, and open the [Azure Boards app](https://azchatopprodcus1.azchatops.visualstudio.com/_slack/installboardsapp).
@@ -61,7 +58,7 @@ To use the app, you must first link your Azure Boards project to your Slack chan
6158
![screenshot of sign-in](./media/integrations-slack/signin.png)
6259

6360
> [!NOTE]
64-
> 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 see the following error if they try to sign in to the Azure Boards app: `Configuration failed. Please make sure that the organization exists and that you have sufficient permissions.`
61+
> If your Azure DevOps organization is connected to a Microsoft Entra ID tenant, you're required to sign in with a native member of that tenant. External users might see authentication errors when attempting to sign in through Slack. Ensure that the organization exists and that you have sufficient permissions.
6562
6663
1. After signing in, use the following slash command inside a Slack channel to link to the Azure Boards project that you specify with the URL:
6764

@@ -128,7 +125,7 @@ You can add areas that your team works on to the channel so that they're always
128125
```
129126
/azboards create 'user story' Push cloud monitoring alerts to mobile devices
130127
```
131-
128+
132129
133130
## Create a work item from message actions
134131
@@ -140,7 +137,6 @@ access to the discussion that led to the creation of the work item.
140137
> [!div class="mx-imgBorder"]
141138
> ![Create work item using message action](./media/integrations-slack/message-action-collated.png)
142139
143-
144140
## Manage Azure Boards subscriptions
145141
146142
1. To view, add and remove subscriptions for a channel, use the `/azboards subscriptions` command:
@@ -211,10 +207,10 @@ If these steps don't resolve your authentication issue, reach out to us at [Deve
211207
212208
## Conditions and limitations
213209
214-
- You can use the Azure Boards app for Slack only with Azure DevOps Services.
215-
- Notifications aren't supported inside direct messages.
216-
- To create subscriptions in a channel, you must be a project or team admin as described in the Prerequisites section.
217-
- To use the app, **Third party application access via OAuth** must be enabled in Azure DevOps **Organization settings** > **Security** > **Policies**.
210+
- The Azure Boards app for Slack works only with Azure DevOps Services (cloud). It isn't supported on Azure DevOps Server.
211+
- Notifications don't appear in direct messages — they go to channels only.
212+
- To create channel subscriptions, be a Project or Team Administrator (see the [Prerequisites](#prerequisites) section).
213+
- Your organization must allow third-party apps to use OAuth. Make sure the **Third party application access via OAuth** policy is enabled in **Organization settings** > **Security** > **Policies**.
218214
219215
## Related content
220216

docs/repos/integrations/repos-slack.md

Lines changed: 11 additions & 12 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/17/2025
12+
ms.date: 09/22/2025
1313
ms.custom:
1414
- cross-service
1515
- sfi-image-nochange
@@ -28,9 +28,11 @@ If you use [Slack](https://slack.com), you can use the [Azure Repos app for Slac
2828
|**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).<br> - 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).|
2929

3030
> [!NOTE]
31-
> * You can only link the Azure Repos app for Slack to a project hosted on Azure DevOps Services.
32-
> * Notifications aren't supported inside direct messages.
33-
> * 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 might see authentication errors when attempting to sign in through Slack.
31+
> - The Azure Repos app for Slack works only with Azure DevOps Services (cloud); it isn't supported on Azure DevOps Server.
32+
> - Notifications are sent to channels — they don't appear in direct messages.
33+
> - To create channel subscriptions be a Project or Team Administrator (see the [Prerequisites](#prerequisites) section).
34+
> - Your organization must allow third‑party apps to sign in using OAuth. Check **Organization settings** > **Security** > **Policies** and enable **Third party application access via OAuth** if it's not already on.
35+
> - 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 run into authentication errors when signing in through Slack.
3436
3537
## Add the Azure Repos app to your Slack workspace
3638

@@ -75,9 +77,6 @@ If you use [Slack](https://slack.com), you can use the [Azure Repos app for Slac
7577

7678
:::image type="content" source="media/integrations-slack/signed-in-confirmation.png" alt-text="Screenshot sign-in confirmation in chat.":::
7779

78-
> [!NOTE]
79-
> 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 see an error if they attempt to sign in through Slack: `Configuration failed. Please make sure that the organization exists and that you have sufficient permissions.`
80-
8180
To start monitoring all Git repositories in a project, use the following slash command inside a channel:
8281

8382
```slash command
@@ -217,11 +216,11 @@ If these steps don't resolve your authentication issue, reach out to us at [Deve
217216

218217
## Conditions and limitations
219218

220-
- You can use the Azure Repos app for Slack only with Azure DevOps Services.
221-
- Notifications aren't supported inside direct messages.
222-
- To create subscriptions in a channel, you must be a project admin or a team admin as described in the Prerequisites section.
223-
- To use the app, **Third party application access via OAuth** must be enabled in Azure DevOps **Organization settings** > **Security** > **Policies**.
224-
- If your organization uses Microsoft Entra ID, external guests might be unable to sign in via Slack; use a native tenant account when authenticating.
219+
- The Azure Repos app for Slack works with Azure DevOps Services (cloud) only — it isn't available for Azure DevOps Server.
220+
- Notifications are sent to channels (not to direct messages).
221+
- To create channel subscriptions be a Project or Team Administrator.
222+
- Your organization must allow third‑party apps to sign in via OAuth. Check **Organization settings** > **Security** > **Policies** and enable **Third party application access via OAuth** if needed.
223+
- If your organization uses Microsoft Entra ID, sign in with an account that is a native member of that tenant — guest or external accounts can experience authentication issues when signing in through Slack.
225224

226225
## Related articles
227226

0 commit comments

Comments
 (0)