Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 16 additions & 12 deletions ai/slack-app.mdx
Original file line number Diff line number Diff line change
@@ -1,27 +1,31 @@
---
title: "Slack app"
description: "Add a bot that searches your docs to answer questions in your Slack workspace"
description: "Add AI-powered documentation search to your Slack workspace"
icon: "slack"
---

<Info>
The Slack app is available for [Pro and Custom plans](https://mintlify.com/pricing?ref=slack-app).
</Info>

The Slack app adds a bot named `@mintlify` 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 Slack app adds a bot named `@mintlify-assistant` 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 Slack app can incur costs: either using your AI assistant credits or incurring overages.

## Setting up the Slack app
## Installing the Slack app

Check warning on line 15 in ai/slack-app.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

ai/slack-app.mdx#L15

'Installing the Slack app' should use sentence-style capitalization.

<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:
<Steps>
<Step title="Navigate to the Slack app page in your dashboard.">
Go to your [dashboard](https://dashboard.mintlify.com/products/slack) and select the Slack app.
</Step>
<Step title="Select Install Slack app.">
This will redirect you to Slack's authorization page.

Check warning on line 22 in ai/slack-app.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

ai/slack-app.mdx#L22

Avoid using 'will'.
</Step>
<Step title="Follow the Slack prompts to add the app to your workspace.">
</Step>
<Step title="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.
- Mention the bot with `@mintlify-assistant` in a channel.
- Create an `#ask-ai` channel, add the bot, and ask a question.
</Step>
</Steps>
9 changes: 5 additions & 4 deletions docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -53,6 +53,7 @@
"group": "AI optimization",
"pages": [
"guides/assistant",
"ai/slack-app",
"ai/llmstxt",
"ai/contextual-menu",
"ai/model-context-protocol",
Expand Down Expand Up @@ -317,7 +318,7 @@
]
},
{
"group": "Optimisation de lIA",
"group": "Optimisation de l'IA",
"pages": [
"fr/guides/assistant",
"fr/ai/llmstxt",
Expand Down Expand Up @@ -359,7 +360,7 @@
]
},
{
"group": "Pages dAPI",
"group": "Pages d'API",
"pages": [
"fr/api-playground/overview",
"fr/api-playground/openapi-setup",
Expand Down Expand Up @@ -509,10 +510,10 @@
]
},
{
"tab": "Référence de lAPI",
"tab": "Référence de l'API",
"groups": [
{
"group": "Référence de lAPI",
"group": "Référence de l'API",
"pages": [
"fr/api-reference/introduction"
]
Expand Down
Loading