Skip to content
This repository has been archived by the owner on Aug 14, 2024. It is now read-only.

Commit

Permalink
fix: Update MS Teams installation instructions (#1094)
Browse files Browse the repository at this point in the history
  • Loading branch information
dashed authored Nov 24, 2023
1 parent cfaacd4 commit 50fe7c0
Showing 1 changed file with 10 additions and 6 deletions.
16 changes: 10 additions & 6 deletions src/docs/integrations/msteams/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ You will need to be a Microsoft Teams Administrator to perform some of the requi

## Create the Sentry App

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.
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):
Expand All @@ -30,8 +30,8 @@ You will need to be a Microsoft Teams Administrator to perform some of the requi
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" >> 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.


## Set up config.yml
Expand All @@ -51,15 +51,19 @@ msteams.client-secret: 'your-bot-secret'
You should see a message in the General channel that says "Welcome to Sentry for Microsoft Teams". If you do not get this message, it means was something went wrong and you'll need to uninstall, fix the problem, and re-install it.
Follow our [documentation on using the Microsoft Teams integration](https://docs.sentry.io/product/integrations/msteams/) to use the integration.
Follow our [documentation on using the Microsoft Teams integration](https://docs.sentry.io/product/integrations/msteams/) to use the integration.
## Troubleshooting
If you're having trouble with installation, try following these steps:
1. Click "Publish to org" in the sidebar.
2. Visit the [manage apps page](https://admin.teams.microsoft.com/policies/manage-apps), and find your app in the list by sorting by "Custom App".
3. Click the title of your app, in this case "Sentry".
4. Publish it to the org-wide app catalog. You should now see it under "Built for your org".
4. Publish it to the org-wide app catalog.
5. After publishing it, you or your admin for your MS Teams org will need to approve the app before it can be installed on MS Teams. Go to the [Manage apps](https://admin.teams.microsoft.com/policies/manage-apps) page, and search for the app (e.g. "Sentry").
6. Click the title of your app, in this case "Sentry", and click "Publish".
7. You should now be able to see the published custom app under the "Built for your org" section in the MS Teams application store.
Expand All @@ -73,4 +77,4 @@ To uninstall the integration, you should uninstall it inside of Teams instead of
![Manage Team](./manage-team.png)
4. Click on "Apps"
5. Click the trash icon to the right of your custom app
6. Press "Uninstall" in the popup
6. Press "Uninstall" in the popup

1 comment on commit 50fe7c0

@vercel
Copy link

@vercel vercel bot commented on 50fe7c0 Nov 24, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Successfully deployed to the following URLs:

develop – ./

develop.sentry.dev
develop-git-master.sentry.dev

Please sign in to comment.