diff --git a/src/docs/product/accounts/early-adopter-features/discord/discord-action-form.png b/src/docs/product/accounts/early-adopter-features/discord/discord-action-form.png new file mode 100644 index 0000000000000..15264374a9fc0 Binary files /dev/null and b/src/docs/product/accounts/early-adopter-features/discord/discord-action-form.png differ diff --git a/src/docs/product/accounts/early-adopter-features/discord/discord-add-issue-alert.png b/src/docs/product/accounts/early-adopter-features/discord/discord-add-issue-alert.png new file mode 100644 index 0000000000000..9e3f70b9cb1ce Binary files /dev/null and b/src/docs/product/accounts/early-adopter-features/discord/discord-add-issue-alert.png differ diff --git a/src/docs/product/accounts/early-adopter-features/discord/discord-developer-mode.png b/src/docs/product/accounts/early-adopter-features/discord/discord-developer-mode.png new file mode 100644 index 0000000000000..610811b91f5ee Binary files /dev/null and b/src/docs/product/accounts/early-adopter-features/discord/discord-developer-mode.png differ diff --git a/src/docs/product/accounts/early-adopter-features/discord/discord-identity-link-page.png b/src/docs/product/accounts/early-adopter-features/discord/discord-identity-link-page.png new file mode 100644 index 0000000000000..b5e1e3cc75efa Binary files /dev/null and b/src/docs/product/accounts/early-adopter-features/discord/discord-identity-link-page.png differ diff --git a/src/docs/product/accounts/early-adopter-features/discord/discord-integration-details.png b/src/docs/product/accounts/early-adopter-features/discord/discord-integration-details.png new file mode 100644 index 0000000000000..f802bd89552a6 Binary files /dev/null and b/src/docs/product/accounts/early-adopter-features/discord/discord-integration-details.png differ diff --git a/src/docs/product/accounts/early-adopter-features/discord/discord-issue-alert.png b/src/docs/product/accounts/early-adopter-features/discord/discord-issue-alert.png new file mode 100644 index 0000000000000..a500d0689c4de Binary files /dev/null and b/src/docs/product/accounts/early-adopter-features/discord/discord-issue-alert.png differ diff --git a/src/docs/product/accounts/early-adopter-features/discord/discord-login.png b/src/docs/product/accounts/early-adopter-features/discord/discord-login.png new file mode 100644 index 0000000000000..a0fbedd50458b Binary files /dev/null and b/src/docs/product/accounts/early-adopter-features/discord/discord-login.png differ diff --git a/src/docs/product/accounts/early-adopter-features/discord/discord-server-select.png b/src/docs/product/accounts/early-adopter-features/discord/discord-server-select.png new file mode 100644 index 0000000000000..415273d193297 Binary files /dev/null and b/src/docs/product/accounts/early-adopter-features/discord/discord-server-select.png differ diff --git a/src/docs/product/accounts/early-adopter-features/discord/index.mdx b/src/docs/product/accounts/early-adopter-features/discord/index.mdx new file mode 100644 index 0000000000000..62c5c2de7f806 --- /dev/null +++ b/src/docs/product/accounts/early-adopter-features/discord/index.mdx @@ -0,0 +1,84 @@ +--- +title: Discord Integration +sidebar_order: 1 +description: "Learn more about Sentry's Discord integration and how you can get notified and manage issues right in Discord." +--- + + + +Get notified and manage issues right in Discord with Sentry's Discord integration. + +## Install + + + +Sentry owner, manager, or admin permissions are required to install this integration. + + + +1. In [sentry.io](https://sentry.io), nagivate to **Settings > Integrations > Discord**. + +1. Click "Add Installation". A pop up window should open. + + ![Install Discord integration](discord-integration-details.png) + +1. Log in to your Discord account. If you're already logged in, this login step will not be displayed. + +1. Use the dropdown menu to select the Discord server you'd like to add Sentry to and click "Continue". + + + You will need to have the "Manage Server" permission enabled for your + Discord account in the server you're trying to add the bot to. + + + ![Select server](discord-server-select.png) + +1. Finally, once the server is selected, click "Authorize". The integration will be created and the Sentry Discord bot will join the selected server. + +Your Discord integration is now available to all projects in your Sentry organization. + +In the next section, we'll walk through configuring Discord notifications. + +## Configure + +Currently our Discord integration supports issue alert rules, with metric alerts and personal notifications planned for future updates to the integration. + +### Issue Alerts + +Follow the steps below to create a new issue alert that sends Discord notifications. + +1. In Sentry, go to **Alerts** and click "Create Alert". + +1. Select "Issues" and then click "Set Conditions". + + ![Create issue alert](discord-add-issue-alert.png) + +1. Configure your issue alert conditions as desired. + +1. To set up Discord notifications, select "Send a Discord notification" in the "THEN" actions dropdown. + +1. Select the Discord server and channel you'd like to send the alert to. You can optionally specify tags here to include in the notification. + + ![Discord issue alert action settings](discord-action-form.png) + + The channel field must be filled in with a Discord channel ID, _not_ a channel name. To get this channel ID, enable Discord's Developer Mode (**Settings -> Advanced -> Developer Mode**). + + ![Discord Developer Mode Setting](discord-developer-mode.png) + + With Developer Mode is enabled, you'll be able to right click on a channel and copy the channel's ID. + +1. Test your configuration by clicking "Send Test Notification". If the bot has access to the given channel, you should see an example notification there. + + ![Discord issue alert](discord-issue-alert.png) + +### Identity Linking + +Having your Discord account linked to your Sentry account allows you to resolve, archive, and assign issues directly in Discord. + +If you're the user who installed the Discord bot to your server, your identity was linked during the install process. You can use the `/link` command to verify this. The bot will tell you which Sentry account your Discord account is linked to. + +All users in any Discord server with the Sentry bot can use the `/link` command to link their accounts. If the account isn't linked yet, the bot will reply with a link to our identity linking page. Make sure you're signed into the desired Sentry account in your browser when you open the link. Click "Link with Discord" to link your accounts. + +![Discord identity linking page](discord-identity-link-page.png) + +To unlink your accounts, use the `/unlink` command. Follow the link and click "Unlink from Discord" diff --git a/src/docs/product/accounts/early-adopter-features/index.mdx b/src/docs/product/accounts/early-adopter-features/index.mdx index 00ea931045991..f2a31e5eb8698 100644 --- a/src/docs/product/accounts/early-adopter-features/index.mdx +++ b/src/docs/product/accounts/early-adopter-features/index.mdx @@ -24,3 +24,4 @@ Limitations: - [Issue Reprocessing](/product/issues/reprocessing/) - [Span Summary](/product/performance/transaction-summary/#span-summary) - [Issue Archiving](/product/accounts/early-adopter-features/issue-archiving/) +- [Discord Integration](/product/accounts/early-adopter-features/discord/) diff --git a/src/docs/product/integrations/notification-incidents/slack/index.mdx b/src/docs/product/integrations/notification-incidents/slack/index.mdx index 46f76820731e8..f20356598b48f 100644 --- a/src/docs/product/integrations/notification-incidents/slack/index.mdx +++ b/src/docs/product/integrations/notification-incidents/slack/index.mdx @@ -58,7 +58,7 @@ You can receive [team alert notifications](/product/alerts/create-alerts/issue-a ### Alert Rules -Set up an alert rule by going to **Alerts** and clicking "Create Alert\*". From here, you can configure alerts to route notifications to your Slack workspace(s). +Set up an alert rule by going to **Alerts** and clicking "Create Alert". From here, you can configure alerts to route notifications to your Slack workspace(s). In [issue alerts](/product/alerts/alert-types/#issue-alerts), select "Send a Slack notification" in the actions dropdown and then select your workspace and channel: