# 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.deva.me/guides/connect-discord.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.