Phase 4: Bots & Extensibility

Phase 4 brings the bot framework, slash commands, and incoming webhooks to Dumpster.

Features Implemented

Bot Framework

Feature	Status	Description
Bot CRUD	✅	Create, list, get, update, delete bots
Bot tokens	✅	64-char hex tokens, shown once on create/regenerate
Bot server management	✅	Add/remove bots from servers
Bot WebSocket	✅	`/ws/bot` endpoint for real-time events
Bot message sending	✅	Bots send messages via API with bot auth

Slash Commands

Feature	Status	Description
Command registration	✅	Register commands per bot per server
Command management	✅	CRUD for slash commands
Command autocomplete	✅	`/` triggers popup with registered commands
Server commands API	✅	List all commands for a server

Incoming Webhooks

Feature	Status	Description
Webhook creation	✅	Create webhooks per channel
Webhook execution	✅	Public endpoint (no auth) to send messages
Username/avatar override	✅	Webhook messages can override bot name/avatar
Webhook management	✅	CRUD for webhooks

Example Bots

Bot	Description
Modbot	Auto-delete messages with banned words, `/kick`, `/ban`, `/purge` commands
Welcome bot	Send welcome message when member joins server

API Reference

Bot Management

# Create a bot
POST /api/v1/bots
{ "name": "Modbot", "description": "Moderation bot" }
→ { "id": "...", "token": "abc123...", "name": "Modbot" }

# List my bots
GET /api/v1/bots
→ [{ "id": "...", "name": "Modbot", ... }]

# Add bot to server
POST /api/v1/bots/{id}/servers
{ "server_id": "..." }
→ { "ok": true }

# Regenerate token
POST /api/v1/bots/{id}/regenerate-token
→ { "token": "new_token..." }

Bot WebSocket

# Connect as bot
ws://host/ws/bot?token=abc123...

# Receive events
{ "type": "MESSAGE_CREATE", "payload": { ... } }
{ "type": "SERVER_MEMBER_ADD", "payload": { ... } }

# Send message
{ "type": "SEND_MESSAGE", "payload": { "channel_id": "...", "content": "Hello!" } }

Slash Commands

# Register command
POST /api/v1/bots/{id}/commands
{ "server_id": "...", "name": "kick", "description": "Kick a user" }

# List server commands (for autocomplete)
GET /api/v1/servers/{id}/commands
→ [{ "name": "kick", "description": "Kick a user", "bot_name": "Modbot" }]

Webhooks

# Create webhook
POST /api/v1/channels/{id}/webhooks
{ "name": "GitHub" }
→ { "id": "...", "token": "...", "url": "https://host/webhooks/{id}/{token}" }

# Execute webhook (public, no auth)
POST /webhooks/{id}/{token}
{ "content": "New commit pushed", "username": "GitHub", "avatar_url": "..." }

Running Example Bots

Modbot

cd examples/modbot
BOT_TOKEN=your_bot_token go run main.go

Welcome Bot

cd examples/welcome
BOT_TOKEN=your_bot_token go run main.go

What's Next

Phase 5: TUI Client

Terminal-based chat + voice client
Vim-style keybindings
LiveKit audio integration

Phase 4: Bots & Extensibility

Features Implemented

Bot Framework

Slash Commands

Incoming Webhooks

Example Bots

API Reference

Bot Management

Bot WebSocket

Slash Commands

Webhooks

Running Example Bots

Modbot

Welcome Bot

What's Next

Navigation