You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
> * Azure Boards and Slack integration is only supported for Azure DevOps Services.
32
-
> * Notifications are currently not supported inside direct messages.
31
+
> - Notifications are sent to channels—they don't appear in direct messages.
33
32
34
33
## Prerequisites
35
34
36
35
| Category | Requirements |
37
36
|--------------|-------------|
38
-
|**Access levels**|**Contributor** for the project. |
39
-
|**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. |
40
-
|**Policies**| To receive notifications: [**Third party application access via OAuth** policy enabled for the organization](../../organizations/accounts/change-application-access-policies.md). |
37
+
| Platform | Azure Boards and the Azure Boards Slack app work only with Azure DevOps Services (cloud); they're not supported on Azure DevOps Server. |
38
+
| Access levels |**Contributor** for the project. |
39
+
| 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. |
40
+
| Organization policies | To receive notifications, the organization must have the [**Third party application access via OAuth** policy](../../organizations/accounts/change-application-access-policies.md) enabled. |
41
+
| Microsoft Entra account | If your organization is connected to a Microsoft Entra ID tenant, sign in with an account that's a native member of that tenant; guest or external accounts can experience authentication errors when signing in through Slack. |
41
42
42
43
## Add the Azure Boards app to your Slack workspace
43
44
44
45
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).
45
46
46
47
2. Once added, a welcome message displays from the app as shown in the following image.
3. Use the `/azboards` Slack handle to interact with the app. A list of commands is provided later in this article, [Command reference](#command-reference).
51
52
@@ -55,19 +56,19 @@ To use the app, you must first link your Azure Boards project to your Slack chan
55
56
56
57
1. Once the app gets installed in your Slack workspace, connect and authenticate yourself to Azure Boards.
57
58
58
-
59
+
59
60
60
61
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:
61
62
62
-
```
63
-
/azboards link [project url]
64
-
```
63
+
```
64
+
/azboards link [project url]
65
+
```
65
66
66
-
For example:
67
+
For example:
67
68
68
-
```
69
-
/azboards link https://dev.azure.com/myorg/myproject
70
-
```
69
+
```
70
+
/azboards link https://dev.azure.com/myorg/myproject
71
+
```
71
72
72
73
Once the project is linked, you can create work items using `/azboards create` command or use message actions.
73
74
@@ -83,48 +84,46 @@ filters to customize your Slack channel. To easily set up subscriptions, your re
83
84
84
85
In case your team's area path doesn't appear in the Area path dropdown menu, follow the instructions mentioned in the next section, [Add area paths](#add-area-paths). Area paths added using the `/azboards addAreapath` command and area paths for which subscriptions are created in the Slack channel always appear in the Area path dropdown along with recently accessed area paths.
85
86
86
-
87
87
## Add area paths
88
88
89
89
You can add areas that your team works on to the channel so that they're always available for creating work items and subscriptions. This action is important mainly for the teams with more than 100 area paths.
90
90
91
91
- Use the following command to add area paths from your project to the Slack channel.
- If you choose project name as your area path, then you receive notifications for all the area paths in the project. It's logically equivalent to choosing 'Any' area path.
106
106
107
-
108
107
## Create a work item with a command
109
108
110
109
1. With the Azure Boards app, you can create work items from your channel. The app supports custom work items as well.
111
110
112
111
- To create a work item, use `/azboards create`.
113
112
114
-
115
-
113
+
114
+
116
115
2. You can create work items directly from a command by passing work item type and title as parameters. Work items get created only if they don't have any fields to be mandatorily filled.
/azboards create 'user story' Push cloud monitoring alerts to mobile devices
125
+
```
123
126
124
-
```
125
-
/azboards create 'user story' Push cloud monitoring alerts to mobile devices
126
-
```
127
-
128
127
129
128
## Create a work item from message actions
130
129
@@ -133,19 +132,18 @@ access to the discussion that led to the creation of the work item.
133
132
134
133
- To create work items using message actions
135
134
136
-
> [!div class="mx-imgBorder"]
137
-
> 
138
-
135
+
> [!div class="mx-imgBorder"]
136
+
> 
139
137
140
138
## Manage Azure Boards subscriptions
141
139
142
140
1. To view, add and remove subscriptions for a channel, use the `/azboards subscriptions` command:
143
141
144
-
```
145
-
/azboards subscriptions
146
-
```
142
+
```
143
+
/azboards subscriptions
144
+
```
147
145
148
-
This command lists all the current subscriptions for the channel and allows you to add new subscriptions and remove existing ones. As part of adding subscriptions, you can also customize what you get notified on by using various filters.
146
+
This command lists all the current subscriptions for the channel and allows you to add new subscriptions and remove existing ones. As part of adding subscriptions, you can also customize what you get notified on by using various filters.
149
147
150
148
> [!NOTE]
151
149
> Team administrators can't remove or modify subscriptions created by Project administrators.
@@ -182,13 +180,13 @@ The following table lists all the `/azboards` commands you can use in your Slack
182
180
|/azboards signout | Sign out from your Azure Boards organization|
183
181
|/azboards unlink | Unlink a project from this channel|
184
182
|/azboards feedback | Report a problem or suggest a feature |
183
+
|/azboards help | Get help on the commands |
185
184
186
185
### Manage work in private channels
187
186
188
187
The Azure Boards app for Slack can help you create work items and monitor the work item activity in your private channels as well. To invite the bot to your private channel, enter
189
188
`/invite @azboards`. After you post that, you can create work items and manage your notifications in the same way as you would for a public channel.
190
189
191
-
192
190
## Troubleshoot errors
193
191
194
192
If you're experiencing the following errors when using the [Azure Boards App for Slack](https://azchatopprodcus1.azchatops.visualstudio.com/_slack/installboardsapp), follow the procedures in this section.
@@ -205,6 +203,12 @@ Select the `Sign in` button and you get redirected to a consent page like the on
205
203
If these steps don't resolve your authentication issue, reach out to us at [Developer Community](https://developercommunity.visualstudio.com/spaces/21/index.html).
206
204
207
205
206
+
## Conditions and limitations
207
+
208
+
- The Azure Boards app for Slack works only with Azure DevOps Services (cloud); it isn't supported on Azure DevOps Server.
209
+
- Notifications go to channels only (they don't appear in direct messages).
210
+
- To create channel subscriptions, be a Project or Team Administrator (see the [Prerequisites](#prerequisites) section).
211
+
208
212
## Related content
209
213
210
214
- [Define area paths and assign to a team](../../organizations/settings/set-area-paths.md)
@@ -25,11 +25,16 @@ If you use [Slack](https://slack.com), you can use the [Azure Repos app for Slac
25
25
26
26
| Category | Requirements |
27
27
|--------------|-------------|
28
-
|**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).|
28
+
| 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). |
30
+
| Organization policies | 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. |
31
+
| 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. |
29
32
30
33
> [!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.
34
+
> - Notifications are sent to channels—they don't appear in direct messages.
35
+
> - To create channel subscriptions be a Project or Team Administrator (see the [Prerequisites](#prerequisites) section).
36
+
> - 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.
37
+
> - 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.
33
38
34
39
## Add the Azure Repos app to your Slack workspace
35
40
@@ -136,7 +141,7 @@ When a user subscribes to a repository using the `/azrepos subscribe` command, a
136
141
The following steps demonstrate how to customize subscriptions.
137
142
138
143
1. Run the `/azrepos subscriptions` command.
139
-
2. In the list of subscriptions, if there's a subscription that is unwanted or must be modified (Example: creating noise in the channel), select the **Remove** button.
144
+
2. In the list of subscriptions, if there's a subscription that's unwanted or must be modified (Example: creating noise in the channel), select the **Remove** button.
140
145
3. Select the **Add subscription** button.
141
146
4. Select the required repository and the desired event.
142
147
5. Select the appropriate filters.
@@ -190,6 +195,7 @@ The following table lists all the `/azrepos commands` you can use in your Slack
190
195
| /azrepos signout | Sign out from your Azure Repos organization |
191
196
| /azrepos feedback | Report a problem or suggest a feature |
192
197
| /azrepos unsubscribe all [project url]| Remove all repositories (belonging to a project) and their associated subscriptions from a channel |
198
+
| /azrepos help | Get help on the commands |
193
199
194
200
### Notifications in private channels
195
201
@@ -210,6 +216,14 @@ Select the `Sign in` button and you're redirected to a consent page like the one
210
216
211
217
If these steps don't resolve your authentication issue, reach out to us at [Developer Community](https://developercommunity.visualstudio.com/spaces/21/index.html).
212
218
219
+
## Conditions and limitations
220
+
221
+
- The Azure Repos app for Slack works with Azure DevOps Services (cloud) only—it isn't available for Azure DevOps Server.
222
+
- Notifications are sent to channels (not to direct messages).
223
+
- To create channel subscriptions be a Project or Team Administrator.
224
+
- 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.
225
+
- 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.
226
+
213
227
## Related articles
214
228
215
229
-[Integrate Azure Boards with Slack](../../boards/integrations/boards-slack.md)
0 commit comments