> ## Documentation Index
> Fetch the complete documentation index at: https://v1-docs.adapt.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Discord

> Connect Discord to Adapt to read and send messages in the channels and servers your bot can access

Connect Discord to Adapt by creating a Discord application with a bot, so Adapt can read and send messages in the channels and servers the bot can access.

## Set up credentials

**1. Open the Discord Developer Portal**

Go to [discord.com/developers/applications](https://discord.com/developers/applications) and sign in.

**2. Create an application**

Click **New Application**, enter a name, and click **Create**. You land on the **General Information** page.

**3. Copy your Application (Client) ID**

On the **General Information** page, copy the **Application ID**. This is your client ID.

**4. Create the bot and copy its token**

Open the **Bot** page, click **Reset Token**, then copy the token immediately. The token is shown only once, so store it right away.

**5. Enable the intents you need**

On the **Bot** page, under **Privileged Gateway Intents**, enable the intents your use case requires (for example **Message Content Intent** to read message text), then click **Save Changes**.

**6. Invite the bot to your server**

Go to **OAuth2 > URL Generator**, select the `bot` scope (and `applications.commands` for slash commands), choose the bot permissions you need such as **Read Messages** and **Send Messages**, then open the generated URL, pick your server, and click **Authorize**. You need the **Manage Server** permission on that server.

> [!NOTE]
>
> Intents must be enabled in the Developer Portal for the bot to receive the matching events. Bots in 100 or more servers require Discord verification to use privileged intents.

## Connect to Adapt

**1. Open Integrations**

In Adapt, go to **Settings > Integrations**.

**2. Find Discord**

Search for **Discord** and select it from the catalog.

**3. Start the connection**

Click **Connect** to open the connection form.

**4. Add your credentials**

Enter the values you gathered above, then click **Add connection**:

| Secret Name | Value |
| - | - |
| `DISCORD_TOKEN` | Your bot token |
| `DISCORD_CLIENT_ID` | Your application's client ID (optional) |

You can rename the connection and choose whether it is shared with your
organization or kept personal to you.

**5. Test the connection**

Ask Adapt to list the channels your bot can access.

### Security

* Credentials are encrypted at rest with AES-256
* The bot can only access the servers it has been invited to and the channels its permissions allow
* If your bot token is exposed, reset it immediately in the Developer Portal to invalidate the old one
* Never share or commit your bot token

## Capabilities

Adapt can read and send messages and read the channels and servers your bot has access to, scoped to the bot's permissions and intents.

### Examples

```
Summarize the latest messages in my Discord support channel.
```

```
Send a message to the #announcements channel in my server.
```

```
List the channels my Discord bot can access.
```

```
What questions came up in my Discord community this week?
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.