> For the complete documentation index, see [llms.txt](https://docs.deva.me/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.deva.me/guides/connect-discord.md).

# Connect Discord

This guide walks you through connecting Discord to your Genie environment so your team can interact with the AI assistant directly from Discord channels and direct messages.

***

## Prerequisites

* A Genie account with a running server
* A Discord server where you have **Manage Server** permission

***

## Step 1: Open Discord Setup in Genie

Go to your Genie dashboard → **Settings** → **Channels** → **Discord** and expand **Discord bot setup instructions**.

You will see a 6-step setup summary and a field to paste your bot token.

![Genie Discord setup page with instructions](/files/KesKzLjffp2zNxrilr6K)

***

## Step 2: Create a Discord Application

1. Go to the [Discord Developer Portal](https://discord.com/developers/applications) and click **New Application**.

![Discord Developer Portal — Applications page](/files/Bf3EoSc7zZU8I8ovTSAV)

2. Name the application (e.g. "Genie"), accept the Terms of Service, and click **Create**.

![Create a new app dialog](/files/Bn13k2M5eQXixf9D60Nm)

You will land on the **General Information** page for your new application.

![Application General Information page](/files/T7PF7DZDnYyHYuCCnoAz)

***

## Step 3: Add a Bot and Copy the Token

1. In the left sidebar, go to **Bot**.

![Bot configuration page](/files/Gbk0lTza3BiZEHJ3OE0y)

2. Under the **Token** section, click **Reset Token** and confirm.

![Reset Token confirmation dialog](/files/iLWmxI8sepNnlcHHLrbI)

3. Copy the newly generated token. You will need this in a later step.

![Bot token displayed — copy it now](/files/ZELiCwPPNBhW4yltU8hI)

***

## Step 4: Enable Privileged Gateway Intents

Scroll down to the **Privileged Gateway Intents** section on the same Bot page. Enable both:

* **Server Members Intent**
* **Message Content Intent**

Click **Save Changes**.

![Privileged Gateway Intents — enable Server Members and Message Content](/files/hj37hI5wMfe6icmieBSB)

***

## Step 5: Generate an Invite URL

1. In the left sidebar, go to **OAuth2** → **URL Generator**.
2. Under **Scopes**, check `bot` and `applications.commands`.

![OAuth2 URL Generator — select scopes](/files/Y2dHKZmXcbkhiTM7luCl)

3. Under **Bot Permissions**, check the following:

* View Channels
* Send Messages
* Embed Links
* Attach Files
* Read Message History
* Add Reactions

![Bot Permissions — select required permissions](/files/0wTkQ8YKWGACYpU51zAL)

4. Copy the **Generated URL** at the bottom of the page.

***

## Step 6: Invite the Bot to Your Server

1. Open the generated URL in your browser. Select the server you want to add the bot to and click **Continue**.

![Discord authorization — select server](/files/mjoRvfGbQfCpveaMm4Oy)

2. Review the permissions and click **Authorize**.

![Discord authorization — confirm permissions](/files/F2CnRHzwRkoxJUK6w9KI)

3. You should see a success message confirming the bot has been added.

![Authorization success — bot added to server](/files/qXS3KpQvKlU5p62rKjHd)

***

## Step 7: Save Token in Genie

Go back to your Genie settings. Paste the bot token you copied earlier into the token field and click **Save & Connect**.

The status should change to **Connected**.

![Discord Connected status in Genie settings](/files/Tr407BTeAbAnnss7RFE4)

***

## Step 8: Pair Your Discord Account

1. Open Discord and send a direct message to the Genie bot (e.g. "Hey!").
2. The bot will respond with a **pairing code** and your Discord user ID.

![Discord DM showing pairing code from Genie bot](/files/a3gTdaIoztP9tuRjiCSa)

3. Go back to Genie settings. Under **Pending Chat Requests**, you will see the pairing request. Click **Approve**.

![Pending chat request with Approve button in Genie settings](/files/cEy9RFUBsCfquubgttH3)

***

## Step 9: Start Chatting

After approval, the bot confirms access in Discord. You can now interact with your AI assistant through direct messages or by @mentioning the bot in channels.

![Working example](/files/7LQUdhfzekxc8nBcY9Md)

***

## Tips

* Mention the bot in any channel it has access to: `@Genie how do I set up a database?`
* DM the bot for private interactions — only you see the responses
* Each user who wants to chat must complete the pairing flow individually
* Consider creating a dedicated `#genie-ai` channel to keep bot conversations organized
* The bot uses your full server context — same files, tools, and configurations as the browser
* All interactions consume credits from the Genie account that connected the bot