Skip to content

Commit 7289691

Browse files
authored
fix(integrations): update MS Teams dev instructions (#11653)
* update ms teams integration instructions * fix naming step
1 parent 1a5f173 commit 7289691

File tree

3 files changed

+20
-6
lines changed

3 files changed

+20
-6
lines changed
60.3 KB
Loading
22 KB
Loading

develop-docs/integrations/msteams/index.mdx

Lines changed: 20 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -14,8 +14,8 @@ You will need to be a Microsoft Teams Administrator to perform some of the requi
1414

1515
1. Visit the [Developer Portal](https://dev.teams.microsoft.com/apps). Note: You may have to sign up for the [MS 365 Developer Program](https://developer.microsoft.com/en-us/microsoft-365/dev-program) if you're having trouble accessing this.
1616
2. Click "New App".
17-
3. Enter "Sentry" as the name.
18-
4. Under "Basic Information" use the following values (the rest may be blank):
17+
3. Name your app (something specific to you to make it easier to find, e.g. `Bob's Sentry`).
18+
4. Under "Basic Information" use the following values (all other fields are optional and may be left blank):
1919

2020
| Setting | Value |
2121
| ------------------------- | --------------------------- |
@@ -28,11 +28,19 @@ You will need to be a Microsoft Teams Administrator to perform some of the requi
2828

2929

3030
5. Hit "Save" at the bottom of the page.
31-
6. On the left hand sidebar click "App features" >> "Bot" >> "Create a new bot" >> "New Bot". You may name this whatever you like.
32-
7. Enter the bot endpoint address as `{YOUR_DOMAIN}/extensions/msteams/webhook/` and hit save. Take note of your bot ID (shown in the URL e.g. https://dev.teams.microsoft.com/bots/{BOT-ID}/configure).
31+
6. On the left hand sidebar click "App features" >> "Bot" >> "Create a new bot" >> "New bot". You may name this whatever you like.
32+
7. Enter the bot endpoint address as `{YOUR_DOMAIN}/extensions/msteams/webhook/` and hit "Save". Take note of your bot ID (shown in the URL, e.g. https://dev.teams.microsoft.com/bots/{BOT-ID}/configure).
3333
8. Go to "Client secrets" and create a secret. Copy the secret as we'll use it later on.
34-
9. To go back click "Apps" >> Sentry >> "App features" >> "Bot" >> and then choose the bot you just created from the "Select an existing bot" dropdown and hit Save.
35-
10. Click "Add a command" and call it anything you like e.g. `/sentry`. Select "Team" as the scope, add it, and again hit Save.
34+
9. To go back, click "Apps" >> Sentry >> "App features" >> "Bot". Then choose the bot you just created from the "Select an existing bot" dropdown.
35+
10. Enable your bot to "Only send notifications (one-way conversations)" and select "Personal" and "Team" as the scopes.
36+
37+
![Microsoft Teams Bot Settings](./bot-settings.png)
38+
39+
11. Click "Add a command" and call it anything you like (e.g. `/sentry`). Give your command a description, select "Personal" and "Team" as the scopes, then click "Add".
40+
41+
![Microsoft Teams Bot Add a Command](./add-bot-command.png)
42+
43+
12. Hit "Save" at the bottom of the page.
3644

3745

3846
## Set up config.yml
@@ -47,6 +55,12 @@ msteams.client-secret: 'your-bot-secret'
4755
4856
## Installation
4957
58+
<Alert title="Note" level="info">
59+
60+
We have encountered recent issues with this installation method. For a smoother experience, please refer to the Troubleshooting section for alternative steps.
61+
62+
</Alert>
63+
5064
1. At the top right of the screen click "Preview in Teams".
5165
2. Select "Add to a team" in the resulting popup, and choose the team(s) you want to install the app on.
5266

0 commit comments

Comments
 (0)