Discord

Connecting Talon to Discord requires creating a bot application in the Discord Developer Portal, enabling the correct gateway intents, and inviting the bot to your server with the right permissions.

Setup

1. Create an Application

Go to discord.com/developers/applications and sign in.

Click New Application, give it a name (this becomes the bot’s display name), and click Create.

2. Create a Bot and Get the Token

In the left sidebar, click Bot.

Click Add Bot and confirm. Once created:

• Click Reset Token to generate your bot token.
• Copy the token immediately — you cannot view it again after leaving the page.

Note

Treat your bot token like a password. Anyone who has it can control your bot and read messages it receives. Never commit it to source control.

3. Enable the MESSAGE_CONTENT Intent

Still on the Bot settings page, scroll down to Privileged Gateway Intents.

Toggle on Message Content Intent. Without this, your bot receives message events but cannot read the actual text of messages.

Click Save Changes.

4. Invite the Bot to Your Server

In the left sidebar, click OAuth2, then URL Generator.

Under Scopes, check:

• bot

Under Bot Permissions, check:

• Read Messages / View Channels
• Send Messages
• Read Message History

Copy the generated URL at the bottom of the page, open it in your browser, and select the server you want to add the bot to.

5. Add to Config

{
  "channels": {
    "discord": {
      "accounts": {
        "my-server": {
          "bot_token": "MTIzN..."
        }
      }
    }
  }
}

Restart Talon. The bot will come online in your server and respond to messages in any channel it can see.

Configuration Fields

Field	Required	Description
bot_token	Yes	The bot token from the Discord Developer Portal
allow_from	No	List of Discord user IDs (as strings) allowed to message the bot
model	No	Override the default AI model for this account

Restricting Access

Use allow_from with Discord user IDs to control who can interact with the bot. You can find a user ID by enabling Developer Mode in Discord settings (Appearance > Developer Mode), then right-clicking a user and selecting Copy User ID.

{
  "channels": {
    "discord": {
      "accounts": {
        "my-server": {
          "bot_token": "MTIzN...",
          "allow_from": ["123456789012345678"]
        }
      }
    }
  }
}

Tip

In a shared server, set allow_from to prevent other server members from interacting with your personal AI bot.

Message Length

Discord enforces a 2000 character limit per message. Talon automatically splits long responses into multiple sequential messages so the full reply is always delivered.

Multiple Servers

Add multiple entries under accounts to connect Talon to several Discord servers at once, each with its own bot or the same bot added to different servers:

{
  "channels": {
    "discord": {
      "accounts": {
        "personal-server": {
          "bot_token": "MTIzN...",
          "allow_from": ["123456789012345678"]
        },
        "team-server": {
          "bot_token": "MTIzN...",
          "allow_from": ["123456789012345678", "876543210987654321"]
        }
      }
    }
  }
}