From 7174bd309c9da10d6a24872bd6b9fdcb3461db74 Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Mon, 28 Jul 2025 17:22:41 -0700
Subject: [PATCH 1/3] create Slack app page
---
ai/slack-app.mdx | 25 +++++++++++++++++++++++++
docs.json | 5 +++--
2 files changed, 28 insertions(+), 2 deletions(-)
create mode 100644 ai/slack-app.mdx
diff --git a/ai/slack-app.mdx b/ai/slack-app.mdx
new file mode 100644
index 000000000..eef7d05d2
--- /dev/null
+++ b/ai/slack-app.mdx
@@ -0,0 +1,25 @@
+---
+title: "Slack app"
+description: "Add a bot that searches your docs to answer questions in your Slack workspace"
+icon: "slack"
+---
+
+
+ The Slack app is available for [Pro and Enterprise plans](https://mintlify.com/pricing?ref=slack-app).
+
+
+The Slack app adds a bot to your Slack workspace that searches your documentation to answer users' questions. The bot responds to direct messages, @mentions, and to any questions in a dedicated `#ask-ai` channel.
+
+## Setting up the Slack app
+
+
+ If your Slack Workspace Owner requires admin approval to install apps, ask them to approve the Mintlify Slack app before you add it.
+
+
+1. Navigate to the [Integrations](https://dashboard.mintlify.com/settings/organization/integrations) page of your dashboard.
+2. Select **Connect** in the Slack integration card.
+3. Complete prompts from Slack to add the app to your workspace.
+4. Test that the bot is working and responds when you:
+ - Send a direct message to the Mintlify app.
+ - Mention the bot with `@mintlify` in a channel.
+ - Create an `#ask-ai` channel, add the bot, and ask a question.
diff --git a/docs.json b/docs.json
index cac92589a..d596b957c 100644
--- a/docs.json
+++ b/docs.json
@@ -43,12 +43,13 @@
"guides/assistant",
"ai/llmstxt",
"ai/contextual-menu",
- "ai/markdown-export",
"mcp",
+ "ai/markdown-export",
"guides/geo",
"guides/claude-code",
"guides/cursor",
- "guides/windsurf"
+ "guides/windsurf",
+ "ai/slack-app"
]
},
{
From 6ceb32d082dcea023c734612aaa4c75124bda0ed Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Mon, 28 Jul 2025 17:26:24 -0700
Subject: [PATCH 2/3] more natural language
---
ai/slack-app.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/ai/slack-app.mdx b/ai/slack-app.mdx
index eef7d05d2..6a5853253 100644
--- a/ai/slack-app.mdx
+++ b/ai/slack-app.mdx
@@ -18,7 +18,7 @@ The Slack app adds a bot to your Slack workspace that searches your documentatio
1. Navigate to the [Integrations](https://dashboard.mintlify.com/settings/organization/integrations) page of your dashboard.
2. Select **Connect** in the Slack integration card.
-3. Complete prompts from Slack to add the app to your workspace.
+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 Mintlify app.
- Mention the bot with `@mintlify` in a channel.
From 2743ef59f1368d672fcc3f85dbcf274d3f1556de Mon Sep 17 00:00:00 2001
From: Nick K
Date: Mon, 28 Jul 2025 19:56:34 -0700
Subject: [PATCH 3/3] Add extra clarity around the Slack channel needing to be
named ask-ai
---
ai/slack-app.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/ai/slack-app.mdx b/ai/slack-app.mdx
index 6a5853253..60df9324b 100644
--- a/ai/slack-app.mdx
+++ b/ai/slack-app.mdx
@@ -8,7 +8,7 @@ icon: "slack"
The Slack app is available for [Pro and Enterprise plans](https://mintlify.com/pricing?ref=slack-app).
-The Slack app adds a bot to your Slack workspace that searches your documentation to answer users' questions. The bot responds to direct messages, @mentions, and to any questions in a dedicated `#ask-ai` channel.
+The Slack app adds a bot to your Slack workspace that searches your documentation to answer users' questions. The bot responds to direct messages, @mentions, and to any questions in a channel specifically named `#ask-ai`.
## Setting up the Slack app