Skip to content
43 changes: 43 additions & 0 deletions ai/discord.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
---
title: "Discord bot"
description: "Add a bot to your Discord server that answers questions based on your documentation."
keywords: ["Discord", "bot", "Q&A", "customer support"]
---

<Info>
Discord integrations are available on [Pro and Custom plans](https://mintlify.com/pricing?ref=discord) with access to the assistant.
</Info>

The Discord bot supports your community with real-time answers from your documentation. The bot uses the Mintlify assistant to search your docs and provide accurate, cited responses, so it is always up-to-date.

Check warning on line 11 in ai/discord.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

ai/discord.mdx#L11

Use 'it's' instead of 'it is'.

The Discord bot responds to `@` mentions and to every message in channels named `#ask-ai`.

Each message sent by the Discord bot counts toward your assistant message usage.

## Add the Discord bot to your server

<Note>
You must have the "Manage Server" permission in Discord to add the bot.
</Note>

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 Discord card, click **Connect**. This opens Discord.
<Frame>
<img src="/images/assistant/discord-connect-light.png" alt="The connect button in light mode." className="block dark:hidden" />
<img src="/images/assistant/discord-connect-dark.png" alt="The connect button in dark mode." className="hidden dark:block" />
</Frame>
1. In Discord, select the server you want to add the bot to.
1. Authorize the bot to access your server.
1. Mention the bot to add it to a channel. The bot's default name is `@Mintlify Bot`.

Check warning on line 31 in ai/discord.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

ai/discord.mdx#L31

Did you really mean 'bot's'?

## Create an `#ask-ai` channel

To help your community quickly get answers to their questions, create a channel named `#ask-ai` and add the bot to it. The bot will respond to every message in that channel. See [Starting Your First Discord Server](https://discord.com/blog/starting-your-first-discord-server) on the Discord blog for more information on creating a channel.

Check warning on line 35 in ai/discord.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

ai/discord.mdx#L35

Avoid using 'will'.

## Manage the Discord bot

Check warning on line 37 in ai/discord.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

ai/discord.mdx#L37

'Manage the Discord bot' should use sentence-style capitalization.

After you add the bot to your server, you can manage or remove the integration from the [Integrations](https://dashboard.mintlify.com/products/assistant/settings/integrations) tab.

Customize the bot's avatar and name to match your brand then let your community know they can mention it to get answers.

Check warning on line 41 in ai/discord.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

ai/discord.mdx#L41

Did you really mean 'bot's'?

TODO: add image of configuration modal
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Bug: TODO comment left in production documentation

A TODO: add image of configuration modal placeholder was left in the documentation. This appears to be an incomplete work note that will be visible to users in the published documentation. The "Manage the Discord bot" section references adding an image that hasn't been included.

Fix in Cursor Fix in Web

1 change: 1 addition & 0 deletions docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -162,6 +162,7 @@
"insights/feedback"
]
},
"ai/discord",
"ai/llmstxt",
"ai/model-context-protocol",
"optimize/seo",
Expand Down
Binary file added images/assistant/discord-connect-dark.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/assistant/discord-connect-light.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.