Documentation Index
Fetch the complete documentation index at: https://mintlify.com/spacedriveapp/spacebot/llms.txt
Use this file to discover all available pages before exploring further.
Bindings map messaging platform conversations to agents. Each binding defines which agent handles messages from a specific guild, workspace, channel, or user.
Binding Definition
ID of the agent that handles messages matching this binding.[[bindings]]
agent_id = "support"
Messaging platform. Must match a configured messaging adapter.Valid values: discord, slack, telegram, email, twitch, webhook[[bindings]]
agent_id = "main"
channel = "discord"
Named adapter instance for platforms that support multiple instances (Discord, Slack, Telegram, Email, Twitch).If not set, targets the default adapter credentials.[[bindings]]
agent_id = "support"
channel = "discord"
adapter = "support_bot" # Uses messaging.discord.instances[0] where name="support_bot"
Discord
Discord guild (server) ID. Only messages from this guild match this binding.[[bindings]]
agent_id = "community"
channel = "discord"
guild_id = "123456789012345678"
Discord channel IDs. Only messages from these channels (or threads under these channels) match this binding.If empty, all channels in the guild are allowed.[[bindings]]
agent_id = "support"
channel = "discord"
guild_id = "123456789012345678"
channel_ids = ["987654321098765432", "876543210987654321"]
Require explicit @mention or reply-to-bot for inbound messages in guild channels.[[bindings]]
agent_id = "assistant"
channel = "discord"
guild_id = "123456789012345678"
require_mention = true
User IDs allowed to DM the bot through this binding. If empty, DMs are ignored for this binding.[[bindings]]
agent_id = "personal"
channel = "discord"
dm_allowed_users = ["111222333444555666", "777888999000111222"]
Slack
Slack workspace (team) ID. Only messages from this workspace match this binding.[[bindings]]
agent_id = "team"
channel = "slack"
workspace_id = "T01234567"
Slack channel IDs. Only messages from these channels match this binding.If empty, all channels in the workspace are allowed.[[bindings]]
agent_id = "support"
channel = "slack"
workspace_id = "T01234567"
channel_ids = ["C01234567", "C07654321"]
Slack user IDs allowed to DM the bot through this binding.[[bindings]]
agent_id = "personal"
channel = "slack"
dm_allowed_users = ["U01234567", "U07654321"]
Telegram
Telegram chat ID. Only messages from this chat match this binding.[[bindings]]
agent_id = "group"
channel = "telegram"
chat_id = "-1001234567890"
Telegram user IDs allowed to DM the bot through this binding.[[bindings]]
agent_id = "personal"
channel = "telegram"
dm_allowed_users = ["123456789", "987654321"]
Twitch
Twitch channel names (without the # prefix). Only messages from these channels match this binding.[[bindings]]
agent_id = "stream"
channel = "twitch"
channel_ids = ["mystreamer", "otherstreamer"]
Binding Resolution
Bindings are evaluated in order. The first binding that matches an inbound message determines which agent handles it.
If no binding matches, the message is routed to the default agent (the agent with default = true).
Examples
Discord Guild Binding
[[bindings]]
agent_id = "community"
channel = "discord"
guild_id = "123456789012345678"
123456789012345678 to the community agent.
Discord Channel-Specific Binding
[[bindings]]
agent_id = "support"
channel = "discord"
guild_id = "123456789012345678"
channel_ids = ["987654321098765432"]
987654321098765432 to the support agent.
Discord DM Binding
[[bindings]]
agent_id = "personal"
channel = "discord"
dm_allowed_users = ["111222333444555666"]
111222333444555666 to DM the bot, routed to the personal agent.
Discord with Mention Requirement
[[bindings]]
agent_id = "assistant"
channel = "discord"
guild_id = "123456789012345678"
require_mention = true
Slack Workspace Binding
[[bindings]]
agent_id = "team"
channel = "slack"
workspace_id = "T01234567"
T01234567 to the team agent.
Slack Channel-Specific Binding
[[bindings]]
agent_id = "support"
channel = "slack"
workspace_id = "T01234567"
channel_ids = ["C01234567"]
C01234567 are routed to the support agent.
Telegram Chat Binding
[[bindings]]
agent_id = "group"
channel = "telegram"
chat_id = "-1001234567890"
-1001234567890 are routed to the group agent.
Twitch Channel Binding
[[bindings]]
agent_id = "stream"
channel = "twitch"
channel_ids = ["mystreamer"]
mystreamer are routed to the stream agent.
# Support agent handles Discord support channel
[[bindings]]
agent_id = "support"
channel = "discord"
guild_id = "123456789012345678"
channel_ids = ["987654321098765432"]
# Community agent handles rest of Discord guild
[[bindings]]
agent_id = "community"
channel = "discord"
guild_id = "123456789012345678"
# Team agent handles Slack workspace
[[bindings]]
agent_id = "team"
channel = "slack"
workspace_id = "T01234567"
# Default agent handles everything else
[[agents]]
id = "default"
default = true
Named Adapter Instances
# Configure two Discord bot instances
[messaging.discord]
token = "env:DISCORD_TOKEN_MAIN"
[[messaging.discord.instances]]
name = "support_bot"
token = "env:DISCORD_TOKEN_SUPPORT"
# Main bot handles general guild
[[bindings]]
agent_id = "community"
channel = "discord"
guild_id = "111111111111111111"
# No adapter specified = uses default token
# Support bot handles support guild
[[bindings]]
agent_id = "support"
channel = "discord"
adapter = "support_bot"
guild_id = "222222222222222222"