Discord Integration

​

Overview

​

Features

• Server and channel messaging
• Direct message support
• Rich embeds and formatting
• File attachments
• Thread support
• Slash commands
• Role-based permissions

​

Setup

​

1. Create Discord Application

1. Go to Discord Developer Portal
2. Click “New Application”
3. Name your application (e.g., “Praxos”)
4. Navigate to “Bot” section
5. Click “Add Bot”
6. Copy the bot token

​

2. Configure Bot Permissions

• Read Messages/View Channels
• Send Messages
• Send Messages in Threads
• Embed Links
• Attach Files
• Read Message History
• Add Reactions

​

3. Configure Praxos

DISCORD_BOT_TOKEN=your_discord_bot_token
DISCORD_APPLICATION_ID=your_application_id

​

4. Invite Bot to Server

1. Go to OAuth2 > URL Generator in Developer Portal
2. Select scopes: bot, applications.commands
3. Select permissions from step 2
4. Copy generated URL
5. Open URL and select server to add bot

​

5. Start Using

• Direct Messages: Send DM to bot
• Channel Messages: Mention bot using @Praxos
• Slash Commands: Use /ask or other configured commands

​

Bot Commands

​

Advanced Features

​

Slash Commands

# Example slash command registration
/schedule [task] [time] - Schedule a task
/search [query] - Search across integrations
/notion [action] - Interact with Notion

​

Embeds

┌─────────────────────────────┐
│ 📊 Task Summary             │
├─────────────────────────────┤
│ Completed: 8                │
│ Pending: 3                  │
│ Due Today: 2                │
└─────────────────────────────┘

​

Thread Support

• Automatic thread creation for long conversations
• Context maintained within threads
• Clean channel organization

​

Role-Based Access

• Admin-only commands
• Channel-specific permissions
• User-level restrictions

​

Configuration

​

Environment Variables

# Required
DISCORD_BOT_TOKEN=your_bot_token
DISCORD_APPLICATION_ID=your_app_id

# Optional
DISCORD_COMMAND_PREFIX=!
DISCORD_MAX_MESSAGE_LENGTH=2000
DISCORD_ALLOWED_GUILDS=guild_id1,guild_id2

​

Server Settings

• Active channels
• Command prefix
• Response behavior
• Notification preferences

​

Troubleshooting

​

Bot Appears Offline

• Check token is correct
• Verify intents are enabled in Developer Portal
• Check bot has proper permissions

​

Commands Not Working

• Ensure bot has “Use Application Commands” permission
• Re-sync slash commands
• Check bot role hierarchy

​

Missing Permissions

# Check bot permissions
/permissions @Praxos

​

Next Steps