From b1e1cc8f942bb3687dab0f6c82fe941982e2d723 Mon Sep 17 00:00:00 2001 From: Leander Rodrigues Date: Wed, 15 Apr 2026 14:34:13 -0400 Subject: [PATCH 1/3] =?UTF-8?q?=E2=9C=A8=20add=20AI=20agent=20feature=20ch?= =?UTF-8?q?anges=20to=20docs?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- develop-docs/integrations/slack/index.mdx | 40 ++++++++++++++++++++--- 1 file changed, 36 insertions(+), 4 deletions(-) diff --git a/develop-docs/integrations/slack/index.mdx b/develop-docs/integrations/slack/index.mdx index 901200e83b54f..138906008bab4 100644 --- a/develop-docs/integrations/slack/index.mdx +++ b/develop-docs/integrations/slack/index.mdx @@ -34,6 +34,10 @@ After you update the `config.yml`, `sentry.conf.py`, or `devlocal.py` you need t configuration section for more information. +## App Settings + +### Interactivity & Shrtcuts + Now that you’ve created your app and updated your Sentry config, you can navigate to **Interactivity & Shortcuts** under **Features**. Toggle on **Interactivity & Shortcuts**. @@ -45,6 +49,8 @@ Request URL: {YOUR_DOMAIN}/extensions/slack/action/ Options Load URL: {YOUR_DOMAIN}/extensions/slack/options-load/ ``` +### OAuth & Permissions + Navigate to **OAuth & Permissions** to configure the Redirect URLs. ![OAuth](./oauth.png) @@ -57,19 +63,20 @@ Click **Add a new Redirect URL**, enter the URL, and click **Add**. Set the URL Click **Save URLs**. -## Scopes +#### Scopes On the same page under **Scopes** you'll need to add **Bot Scopes** and **User Scopes**. Add the following scopes to **Bot Scopes**: - `channels:history`, `groups:history`, and `app_mentions:read` are used to trigger Seer which is - not currently available for self-hosted, meaning they're not required permissions to add. + `app_mentions:read`, `assistant:write`, `channels:history` and `groups:history` are used for Seer + Features which are not currently available for self-hosted. You can freely omit them. | Scope | Reason | | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `assistant:write` | Allow users to use the app as a Slack Agent. | | `app_mentions:read` | Receive `app_mention` events when the bot is mentioned (e.g. @Sentry) in a message. | | `channels:read` | List and validate public channels when configuring alert-rule destinations, and resolve channel names to IDs. | | `channels:history` | (Optional) Allows Sentry to read messages from public channels. Sentry uses this to gather context of individual threads for conversations with Seer Explorer. | @@ -99,6 +106,8 @@ Add the following scopes to **User Scopes**: your app’s OAuth tokens to a list of IP addresses and ranges you provide. +### Event Subscriptions + Navigate to **Event Subscriptions** and toggle “On”. Here you will enter another Request URL: `{YOUR_DOMAIN}/extensions/slack/event/` You’ll see “Verified” when you’ve entered the correct URL. @@ -117,7 +126,8 @@ If it fails to validate, first make sure your Sentry instance is running and Sla Still on the **Event Subscription** page, go to **Subscribe to bot events** and add the following bot user events: -- `app_mention` (Not supported for self-hosted) +- `app_mention` (Not necessary for self-hosted, Seer is not available) +- `assistant_thread_started` (Not necessary for self-hosted, Seer is not available) - `link_shared` - `message.im` @@ -129,12 +139,16 @@ Lastly, still on that page, go to **App Unfurl Domains**, click **Add Domain** t At the bottom of the page, click **Save Changes**. +### App Home + Navigate to **App Home**, under **Features**. Here is where you can edit your bot's display name (this is the name that will be displayed when alerts are triggered). ![Bot](./bot.png) If you plan on having Slack alerts sent to specific users (`@person`) in addition to channels, toggle on the **Messages Tab** under **Show Tabs** in the **App Home** page. +### Slash Commands + Navigate to **Slash Commands** under **Features**. Click **Create New Command** and enter the following values: | Setting | Value | @@ -151,3 +165,21 @@ Navigate to **Slash Commands** under **Features**. Click **Create New Command** At the bottom of the page, click **Save**. Now you can use Slack with Sentry! See our [documentation on installing and configuring the Slack integration for your projects](https://docs.sentry.io/product/integrations/notification-incidents/slack/) to take advantage of multi-channel Alert routing. + +### Agents & AI Apps + + + Seer is not currently available for self-hosted. You can skip this section of settings changes. + + +Navigate to **Agents & AI Apps** under **Features**. + +Enable the Agent or Assistant toggle and add an overview for your users. For example: + +``` +👋 Hey, I'm Seer — Sentry's AI debugging agent. + +I live in your Sentry data and I'm very good at finding out why things are on fire. +``` + +Under **Suggested Prompts**, ensure _Dynamic_ is selected. From d756629346b19d8d11099b072033033bfade283f Mon Sep 17 00:00:00 2001 From: Leander Rodrigues Date: Wed, 15 Apr 2026 14:46:43 -0400 Subject: [PATCH 2/3] =?UTF-8?q?=E2=9C=8F=EF=B8=8F=20typo=20+=20formatting?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- develop-docs/integrations/slack/index.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/develop-docs/integrations/slack/index.mdx b/develop-docs/integrations/slack/index.mdx index 138906008bab4..2bfb061d5ea9a 100644 --- a/develop-docs/integrations/slack/index.mdx +++ b/develop-docs/integrations/slack/index.mdx @@ -36,7 +36,7 @@ After you update the `config.yml`, `sentry.conf.py`, or `devlocal.py` you need t ## App Settings -### Interactivity & Shrtcuts +### Interactivity & Shortcuts Now that you’ve created your app and updated your Sentry config, you can navigate to **Interactivity & Shortcuts** under **Features**. @@ -44,7 +44,7 @@ Toggle on **Interactivity & Shortcuts**. Now you’ll be able to enter your **Request URL** (this is the location of your self-hosted Sentry) and **Options Load URL**: -``` +```plain Request URL: {YOUR_DOMAIN}/extensions/slack/action/ Options Load URL: {YOUR_DOMAIN}/extensions/slack/options-load/ ``` @@ -57,7 +57,7 @@ Navigate to **OAuth & Permissions** to configure the Redirect URLs. Click **Add a new Redirect URL**, enter the URL, and click **Add**. Set the URL to: -``` +```plain {YOUR_DOMAIN}/extensions/slack/setup/ ``` @@ -176,7 +176,7 @@ Navigate to **Agents & AI Apps** under **Features**. Enable the Agent or Assistant toggle and add an overview for your users. For example: -``` +```plain 👋 Hey, I'm Seer — Sentry's AI debugging agent. I live in your Sentry data and I'm very good at finding out why things are on fire. From c0c2592dc545952b3eb2c7328c0bf3d024a5521f Mon Sep 17 00:00:00 2001 From: Leander Rodrigues Date: Wed, 15 Apr 2026 14:54:45 -0400 Subject: [PATCH 3/3] =?UTF-8?q?=E2=9C=8F=EF=B8=8F=20fix?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- develop-docs/integrations/slack/index.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/develop-docs/integrations/slack/index.mdx b/develop-docs/integrations/slack/index.mdx index 2bfb061d5ea9a..15767aff2a841 100644 --- a/develop-docs/integrations/slack/index.mdx +++ b/develop-docs/integrations/slack/index.mdx @@ -44,7 +44,7 @@ Toggle on **Interactivity & Shortcuts**. Now you’ll be able to enter your **Request URL** (this is the location of your self-hosted Sentry) and **Options Load URL**: -```plain +```text Request URL: {YOUR_DOMAIN}/extensions/slack/action/ Options Load URL: {YOUR_DOMAIN}/extensions/slack/options-load/ ``` @@ -57,7 +57,7 @@ Navigate to **OAuth & Permissions** to configure the Redirect URLs. Click **Add a new Redirect URL**, enter the URL, and click **Add**. Set the URL to: -```plain +```text {YOUR_DOMAIN}/extensions/slack/setup/ ``` @@ -76,7 +76,7 @@ Add the following scopes to **Bot Scopes**: | Scope | Reason | | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `assistant:write` | Allow users to use the app as a Slack Agent. | +| `assistant:write` | Enables accessing the app as a personal Slack Agent. | | `app_mentions:read` | Receive `app_mention` events when the bot is mentioned (e.g. @Sentry) in a message. | | `channels:read` | List and validate public channels when configuring alert-rule destinations, and resolve channel names to IDs. | | `channels:history` | (Optional) Allows Sentry to read messages from public channels. Sentry uses this to gather context of individual threads for conversations with Seer Explorer. | @@ -176,7 +176,7 @@ Navigate to **Agents & AI Apps** under **Features**. Enable the Agent or Assistant toggle and add an overview for your users. For example: -```plain +```text 👋 Hey, I'm Seer — Sentry's AI debugging agent. I live in your Sentry data and I'm very good at finding out why things are on fire.