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
@@ -39,13 +39,16 @@ events in their Slack channel. Conversations in the Slack channel can be used to
39
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
40
|**Policies**| To receive notifications: [**Third party application access via OAuth** policy enabled for the organization](../../organizations/accounts/change-application-access-policies.md). |
41
41
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
+
42
45
## Add the Azure Boards app to your Slack workspace
43
46
44
47
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
48
46
49
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
54
@@ -55,19 +58,22 @@ To use the app, you must first link your Azure Boards project to your Slack chan
55
58
56
59
1. Once the app gets installed in your Slack workspace, connect and authenticate yourself to Azure Boards.
57
60
58
-
61
+
62
+
63
+
> [!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.`
59
65
60
66
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
67
62
-
```
63
-
/azboards link [project url]
64
-
```
68
+
```
69
+
/azboards link [project url]
70
+
```
65
71
66
-
For example:
72
+
For example:
67
73
68
-
```
69
-
/azboards link https://dev.azure.com/myorg/myproject
70
-
```
74
+
```
75
+
/azboards link https://dev.azure.com/myorg/myproject
76
+
```
71
77
72
78
Once the project is linked, you can create work items using `/azboards create` command or use message actions.
73
79
@@ -83,48 +89,46 @@ filters to customize your Slack channel. To easily set up subscriptions, your re
83
89
84
90
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
91
86
-
87
92
## Add area paths
88
93
89
94
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
95
91
96
- 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
111
107
-
108
112
## Create a work item with a command
109
113
110
114
1. With the Azure Boards app, you can create work items from your channel. The app supports custom work items as well.
111
115
112
116
- To create a work item, use `/azboards create`.
113
117
114
-
115
-
118
+
119
+
116
120
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
126
-
```
127
-
128
+
```
129
+
/azboards create 'user story' Push cloud monitoring alerts to mobile devices
130
+
```
131
+
128
132
129
133
## Create a work item from message actions
130
134
@@ -133,19 +137,19 @@ access to the discussion that led to the creation of the work item.
133
137
134
138
- To create work items using message actions
135
139
136
-
> [!div class="mx-imgBorder"]
137
-
> 
140
+
> [!div class="mx-imgBorder"]
141
+
> 
138
142
139
143
140
144
## Manage Azure Boards subscriptions
141
145
142
146
1. To view, add and remove subscriptions for a channel, use the `/azboards subscriptions` command:
143
147
144
-
```
145
-
/azboards subscriptions
146
-
```
148
+
```
149
+
/azboards subscriptions
150
+
```
147
151
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.
152
+
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
153
150
154
> [!NOTE]
151
155
> Team administrators can't remove or modify subscriptions created by Project administrators.
@@ -182,13 +186,13 @@ The following table lists all the `/azboards` commands you can use in your Slack
182
186
|/azboards signout | Sign out from your Azure Boards organization|
183
187
|/azboards unlink | Unlink a project from this channel|
184
188
|/azboards feedback | Report a problem or suggest a feature |
189
+
|/azboards help | Get help on the commands |
185
190
186
191
### Manage work in private channels
187
192
188
193
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
194
`/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
195
191
-
192
196
## Troubleshoot errors
193
197
194
198
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 +209,13 @@ Select the `Sign in` button and you get redirected to a consent page like the on
205
209
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
210
207
211
212
+
## Conditions and limitations
213
+
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**.
218
+
208
219
## Related content
209
220
210
221
- [Define area paths and assign to a team](../../organizations/settings/set-area-paths.md)
@@ -30,6 +30,7 @@ If you use [Slack](https://slack.com), you can use the [Azure Repos app for Slac
30
30
> [!NOTE]
31
31
> * You can only link the Azure Repos app for Slack to a project hosted on Azure DevOps Services.
32
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.
33
34
34
35
## Add the Azure Repos app to your Slack workspace
35
36
@@ -74,6 +75,9 @@ If you use [Slack](https://slack.com), you can use the [Azure Repos app for Slac
74
75
75
76
:::image type="content" source="media/integrations-slack/signed-in-confirmation.png" alt-text="Screenshot sign-in confirmation in chat.":::
76
77
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
+
77
81
To start monitoring all Git repositories in a project, use the following slash command inside a channel:
78
82
79
83
```slash command
@@ -136,7 +140,7 @@ When a user subscribes to a repository using the `/azrepos subscribe` command, a
136
140
The following steps demonstrate how to customize subscriptions.
137
141
138
142
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.
143
+
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
144
3. Select the **Add subscription** button.
141
145
4. Select the required repository and the desired event.
142
146
5. Select the appropriate filters.
@@ -190,6 +194,7 @@ The following table lists all the `/azrepos commands` you can use in your Slack
190
194
| /azrepos signout | Sign out from your Azure Repos organization |
191
195
| /azrepos feedback | Report a problem or suggest a feature |
192
196
| /azrepos unsubscribe all [project url]| Remove all repositories (belonging to a project) and their associated subscriptions from a channel |
197
+
| /azrepos help | Get help on the commands |
193
198
194
199
### Notifications in private channels
195
200
@@ -210,6 +215,14 @@ Select the `Sign in` button and you're redirected to a consent page like the one
210
215
211
216
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
217
218
+
## Conditions and limitations
219
+
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.
225
+
213
226
## Related articles
214
227
215
228
-[Integrate Azure Boards with Slack](../../boards/integrations/boards-slack.md)
0 commit comments