Files
mintlify__docs/ai/discord.mdx
mintlify[bot] cf942375f7 Document Discord bot channel selector (#2362)
* Update ai/discord.mdx

Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>

* Update ai/discord.mdx

Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>

* copy edit and update images

* use `#ask-ai` channel name

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2025-12-17 13:35:52 -08:00

51 lines
2.9 KiB
Plaintext

---
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.
The Discord bot only works in public channels. It replies to `@` mentions or to all messages in a specific channel.
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`.
## Create an `#ask-ai` channel
To help your community quickly get answers to their questions, the bot can reply to every message in a channel that you choose. By default, the bot replies to every message in channels named `#ask-ai`. Create an `#ask-ai` channel and let your community know that the bot will reply to messages in that channel.
If you want the bot to reply to messages in a different channel, select a channel in the Discord bot [configuration menu](https://dashboard.mintlify.com/products/assistant/settings/integrations).
<Frame>
<img src="/images/assistant/discord-configure-light.png" alt="The Discord configuration panel in light mode." className="block dark:hidden" />
<img src="/images/assistant/discord-configure-dark.png" alt="The Discord configuration panel in dark mode." className="hidden dark:block" />
</Frame>
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.
## Manage the Discord bot
After you add the Discord bot to your server, you can manage or remove the bot from the [Integrations](https://dashboard.mintlify.com/products/assistant/settings/integrations) tab in your dashboard.
In the Discord bot configuration menu, customize the bot by changing its avatar or name, and choose which channel it automatically replies to all messages in.