# Discord Agent Integration Walkthrough

## Create a Discord Application

1. Go to [Discord Developer Portal](https://discord.com/developers/applications)
2. Click "New Application" and give your application a name

<figure><img src="/files/6XLDuyyO3ZtZkPRJJaWB" alt=""><figcaption></figcaption></figure>

## Configure Discord Bot

1. Click on Bot.
2. Set a username and a nice unique icon for your bot.
3. Toggle "Public Bot" off (if you don't want others to invite it).
4. Enable "Message Content Intent" (for reading messages).
5. Copy the Token (click "Reset Token" if needed, then store it safely).

<figure><img src="/files/dpL9APyzEY9Fe56Rggd7" alt=""><figcaption></figcaption></figure>

## Invite the Bot to your Server

1. Go to the **OAuth2** tab → OAuth2 URL Generator
2. Under OAuth2 URL Generator, check bot

   <figure><img src="/files/F987tcYMKlg3KxAzami4" alt=""><figcaption></figcaption></figure>
3. Under Bot Permissions, check the appropriate text permissions you want. See screenshot fo recommended permissions

   <figure><img src="/files/h7jDAzkORjpz7xALXyeP" alt=""><figcaption></figcaption></figure>
4. Keep integration type to Guild Install
5. Copy the generated URL and paste it on your browser to add the bot to your server

   <div align="left"><figure><img src="/files/HxNyFZ2pHZhpdjiodO59" alt="" width="563"><figcaption></figcaption></figure></div>
6. Authorize your bot on your server &#x20;

   <div align="left"><figure><img src="/files/4eU4JgdNYLZmvCaWOUHf" alt="" width="373"><figcaption></figcaption></figure></div>
7. Make sure you give your bot permissions on the channels you want it to interact with

   <figure><img src="/files/PkjHzadwnmEssvPnqCgt" alt=""><figcaption></figcaption></figure>

## Configure Discord Agent in aigentOS

1. Go to your agent's configuration page. Under aigentOS, click the Discord Tab. Configure accordingly and click Save Agent Settings button

   <figure><img src="/files/vcg80h8DXh0Yr9WklyEc" alt=""><figcaption></figcaption></figure>
2. And then click the Settings Tab

   <figure><img src="/files/sWgS1BttVxu60qjUYbxZ" alt=""><figcaption></figcaption></figure>
3. Paste your Bot Token in the Discord Bot Token text box
4. Add channel IDs you want your Discord agent to interact with. You can copy the channel id by right-clicking the channel in Discord and clicking Copy Channel ID from the context menu. And then paste the channel id in the textbox and click Add.&#x20;

   <div align="left"><figure><img src="/files/UrRjr7Zt5pxsPegUgZog" alt="" width="182"><figcaption></figcaption></figure></div>
5. Click the "Send Test Message" button in to verify that you have the correct channel ID. Remember that the Discord bot you created needs to have the correct permission in the channel you added.


---

# 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.aigent.run/ai-agent-terminal/social-agents/discord-agent-integration-walkthrough.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.