diff --git a/develop-docs/integrations/msteams/add-bot-command.png b/develop-docs/integrations/msteams/add-bot-command.png
new file mode 100644
index 0000000000000..411571be6bb94
Binary files /dev/null and b/develop-docs/integrations/msteams/add-bot-command.png differ
diff --git a/develop-docs/integrations/msteams/bot-settings.png b/develop-docs/integrations/msteams/bot-settings.png
new file mode 100644
index 0000000000000..a85382f808204
Binary files /dev/null and b/develop-docs/integrations/msteams/bot-settings.png differ
diff --git a/develop-docs/integrations/msteams/index.mdx b/develop-docs/integrations/msteams/index.mdx
index ead064fed74d6..de67410fe6980 100644
--- a/develop-docs/integrations/msteams/index.mdx
+++ b/develop-docs/integrations/msteams/index.mdx
@@ -14,8 +14,8 @@ You will need to be a Microsoft Teams Administrator to perform some of the requi
 
 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.
 2. Click "New App".
-3. Enter "Sentry" as the name.
-4. Under "Basic Information" use the following values (the rest may be blank):
+3. Name your app (something specific to you to make it easier to find, e.g. `Bob's Sentry`).
+4. Under "Basic Information" use the following values (all other fields are optional and may be left blank):
 
 | Setting                   | Value                       |
 | ------------------------- | --------------------------- |
@@ -28,11 +28,19 @@ You will need to be a Microsoft Teams Administrator to perform some of the requi
 
 
 5. Hit "Save" at the bottom of the page.
-6. On the left hand sidebar click "App features" >> "Bot" >> "Create a new bot" >> "New Bot". You may name this whatever you like.
-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).
+6. On the left hand sidebar click "App features" >> "Bot" >> "Create a new bot" >> "New bot". You may name this whatever you like.
+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).
 8. Go to "Client secrets" and create a secret. Copy the secret as we'll use it later on.
-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.
-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.
+9. To go back, click "Apps" >> Sentry >> "App features" >> "Bot". Then choose the bot you just created from the "Select an existing bot" dropdown.
+10. Enable your bot to "Only send notifications (one-way conversations)" and select "Personal" and "Team" as the scopes.
+
+![Microsoft Teams Bot Settings](./bot-settings.png)
+
+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".
+
+![Microsoft Teams Bot Add a Command](./add-bot-command.png)
+
+12. Hit "Save" at the bottom of the page.
 
 
 ## Set up config.yml
@@ -47,6 +55,12 @@ msteams.client-secret: 'your-bot-secret'
 
 ## Installation
 
+<Alert title="Note" level="info">
+
+We have encountered recent issues with this installation method. For a smoother experience, please refer to the Troubleshooting section for alternative steps.
+
+</Alert>
+
 1. At the top right of the screen click "Preview in Teams".
 2. Select "Add to a team" in the resulting popup, and choose the team(s) you want to install the app on.