Slack app

ai/slack-app.mdx

@@ -1,27 +1,45 @@
 ---
 title: "Slack app"
-description: "Add a bot that searches your docs to answers questions in your Slack workspace."
-keywords: ["Slack bot", "workspace", "questions"]
+description: "Add a bot to your Slack workspace that answers questions based on your documentation."
+keywords: ["bot", "workspace", "Q&A", "Slack"]
 ---
 
 <Info>
-  The Slack app is available for [Pro and Custom plans](https://mintlify.com/pricing?ref=slack-app).
+  The Slack app is available for [Pro and Custom plans](https://mintlify.com/pricing?ref=slack-app) with access to the assistant.
 </Info>
 
-The Slack app adds a bot to your Slack workspace that can search your documentation and answer users' questions. The bot responds to direct messages, @mentions, and to any questions in a channel specifically named `#ask-ai`. The bot's name is `@yourprojectname-assistant`. So if your project name is Mintlify, the bot's name is `@mintlify-assistant`.
+The Slack app adds a bot to your workspace that supports your community with real-time answers. The bot uses the Mintlify assistant to search your docs and provide accurate, cited responses, so it is always up-to-date.
 
-The Slack app can incur costs: either using your AI assistant credits or incurring overages.
+The bot responds to `@` mentions and to every message in channels named `#ask-ai`.
+
+Each message sent by the bot counts toward your assistant message usage.
 
 ## Set up the Slack app
 
 <Note>
   If your Slack Workspace Owner requires admin approval to install apps, ask them to approve the Mintlify Slack app before you add it.
 </Note>
 
-1. Navigate to the [Add-ons](https://dashboard.mintlify.com/products/addons) page of your dashboard.
-2. Select **Connect** in the Slack Integration card.
-3. Follow the Slack prompts to add the app to your workspace.
-4. Test that the bot is working and responds when you:
-  - Send a direct message to the bot.
-  - Mention the bot in a channel.
-  - Create an `#ask-ai` channel, add the bot, and ask a question.
+1. Navigate to the [Integrations](https://dashboard.mintlify.com/products/assistant/settings/integrations) tab of the **Assistant Configurations** page in your dashboard.
+1. In the Slack card, click **Connect**. This opens Slack.
+  <Frame>
+    <img src="/images/assistant/slack-connect-light.png" alt="The Connect button in the Slack card in light mode." className="block dark:hidden" />
+    <img src="/images/assistant/slack-connect-dark.png" alt="The Connect button in the Slack card in dark mode." className="hidden dark:block" />
+  </Frame>
+1. Follow the Slack prompts to add the app to your workspace.
+1. Mention the bot to add it to a channel. The bot's default name is TODO:
+
+### Customize the bot's name
+
+1. In Slack, select the Mintlify app in the **Apps** menu.
+1. Click **About**.
+1. Click **Configuration**. This opens the app configuration page in a web browser.
+1. In the **Bot User** section, edit the bot name.
+
+## Create an `#ask-ai` channel
+
+To help your users quickly get answers to their questions, create a channel named `#ask-ai`. The bot will respond to every message in that channel. See [Create a channel](https://slack.com/help/articles/201402297-Create-a-channel) in the Slack Help Center for more information.
+
+## Manage the Slack app
+
+After you add the app to your workspace, you can manage or remove the app from the [Integrations](https://dashboard.mintlify.com/products/assistant/settings/integrations) tab.

docs.json

@@ -162,6 +162,7 @@
                       "insights/feedback"
                     ]
                   },
+                  "ai/slack-app",
                   "ai/llmstxt",
                   "ai/model-context-protocol",
                   "optimize/seo",