Bot mode

When you create a character on AICord, it is a webhook-based character by default, but if you want to run it as a Discord bot, you can do that by enabling bot mode for it.

The bot is completely yours, and will be able to do everything AICord currently does - we'll be just hosting it for you & providing the AI service.

Shhh! You might be able to get the Active Developer Discord badge once your bot is active - if you're a badge goblin.

This page guides you through how to get the token and enable bot mode. We're assuming you already have an AICord AI Character set up in your Discord server.

Step 1: Creating a Discord Bot

1. Create Your Discord Application

1. Go to the Discord Developer Portal.

2. Click "New Application".

3. Give it a name (this is just for your own reference in the Developer Portal).

4. Click "Create".

5. You can also give it a name and an image - optionally, you want this to be the same as your character's name and image

2. Turn It Into a Bot

1. Inside your new application, go to the "Bot" tab on the left.

2. Click "Add Bot" → Confirm with "Yes, do it!"

3. Now you’ll see your actual bot user, which is what will appear in Discord servers.

4. Important: The bot’s name and profile picture come from here—not the application name.

3. Set Character’s Display Name and Profile Picture

1. Still in the Bot tab:

   • Click the avatar to upload a profile picture (512x512 is ideal).

   • Click the bot’s username to change it—this is the name that shows up in chat.

2. Save changes. It might take a few minutes to update across Discord.

4. Set Required Bot Permissions

1. In the left sidebar, go to OAuth2 → URL Generator.

2. Under Scopes, check bot.

3. Under Bot Permissions, select the permissions your bot will need. For most AICord bots, we recommend:

   • Administrator - This gives the bot permission to do everything, making your character more capable.

4. Copy the generated URL at the bottom and open it in your browser to invite the bot to your server so you can use it and test it!

Important! Keep your bot token as secure as possible because if your bot has admin and someone gets your token, every server can be destroyed where the bot is in!

5. Enable Privileged Intents

1. In the Bot tab, scroll down to the Privileged Gateway Intents section.

2. Enable the following intents:

   • MESSAGE CONTENT INTENT – required for your bot to read message text, needed for AICord-style interaction.

   • SERVER MEMBERS INTENT – required, your bot needs access to member info (e.g., for personalizing responses).

3. Click Save Changes at the bottom.

6. Get the Bot Token

1. Still in the Bot tab, click "Reset Token" → Confirm → then copy the token.

   • ⚠️ Important: This token is your bot’s password. Don’t share it publicly. If it leaks, regenerate it immediately.

2. Paste this token into the AICord dashboard when editing your bot character (next step).

Step 2: Enabling Bot Mode

1. Edit your AICord character

1. Go to the AICord Dashboard.

2. Ensure that the right server is selected

3. On the side panel, go to "🤖 Characters" → "My Characters"

4. Click "Edit" on the character you want to enable bot mode for

5. Go to the "Bot Mode" section using the side panel

6. Paste your bot's token from the previous step

7. If you're done, click the "Turn on bot" at the bottom of the section!

Bot mode character section on AICord Dashboard

If you've done everything correctly, you should see a notification about it

2. Test Your Bot Character

1. Ensure your bot is added to a Discord server where it has the necessary permissions to operate.

2. Ensure everything works:

• Bot status is online (you might need to refresh Discord or wait some time)

• When you @mention your bot by its username, it responds

• When you reply to it, it also responds

• When you DM it, it says something

Pay attention to any errors or unexpected behaviors and adjust your bot configuration as necessary or contact AICord Developers on the support server if you're unsure about anything!