Discord

Connect your Aerostack bot to Discord via the Interactions API. Users interact with your bot through slash commands (/ask and /reset), and responses are delivered as follow-up messages.

Prerequisites

• An Aerostack account with an existing bot (or create one during setup)
• A Discord account with permission to create applications

Step 1: Create a Discord Application

1. Go to the Discord Developer Portal
2. Click New Application and give it a name
3. Navigate to the General Information tab and copy the Application ID and Public Key
4. Navigate to the Bot tab:
   • Click Add Bot (if not already created)
   • Copy the Bot Token (click “Reset Token” if needed)
   • Under Privileged Gateway Intents, no special intents are required for slash commands

Step 2: Invite the Bot to Your Server

1. Navigate to the OAuth2 tab in the Developer Portal
2. Under OAuth2 URL Generator, select the scopes: bot, applications.commands
3. Under Bot Permissions, select: Send Messages, Use Slash Commands
4. Copy the generated URL and open it in your browser
5. Select the server you want to add the bot to and authorize

Step 3: Configure in Aerostack

Via Dashboard

1. Navigate to Bots in the sidebar
2. Click on your bot (or create a new one with platform set to Discord)
3. In the Platform Configuration section, enter:
   • Application ID — from the General Information tab
   • Public Key — from the General Information tab
   • Bot Token — from the Bot tab

Via API

curl -X POST https://api.aerostack.dev/api/bots \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Discord Support Bot",
    "platform": "discord",
    "workspace_id": "YOUR_WORKSPACE_ID",
    "system_prompt": "You are a helpful assistant in a Discord server.",
    "platform_config": {
      "application_id": "1234567890123456789",
      "public_key": "abc123def456...",
      "bot_token": "MTIz...abc"
    }
  }'

Step 4: Activate

Activating does two things:

1. Sets the Interactions Endpoint URL on your Discord application
2. Registers slash commands (/ask and /reset)

curl -X POST https://api.aerostack.dev/api/bots/YOUR_BOT_ID/activate \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Response:

{
  "status": "active",
  "webhook_url": "https://api.aerostack.dev/api/bots/webhook/discord/bt_a1b2c3d4e5f6g7h8i9j0"
}

Step 5: Test

In your Discord server, type /ask followed by your message:

/ask message: What are your business hours?

The bot will show “thinking…” briefly, then respond with the answer.

Use /reset to clear the conversation history and start fresh.

Platform Config Fields

Slash Commands

Aerostack automatically registers two slash commands when a bot is activated:

Guild vs Global Commands

• If guild_ids is provided, commands are registered only to the first guild in the array. This is faster (commands appear instantly).
• If guild_ids is omitted, commands are registered globally. Global commands can take up to 1 hour to propagate across all servers.

Webhook Verification

Discord uses Ed25519 signature verification for all interactions. The public_key from your Discord application is used to verify every incoming request. This verification is mandatory — Discord will not send interactions to an endpoint that fails the verification ping.

Unlike other platforms, you cannot skip signature verification for Discord.

Message Limits

Discord enforces a 2000 character limit per message. If the bot’s response exceeds this, Aerostack automatically splits it into multiple follow-up messages at whitespace boundaries.

Rate Limits

Discord webhooks are rate-limited at 120 requests per minute per bot (higher than other platforms due to the interaction model).

Troubleshooting