Channels are the bridge between AeonSage and external messaging platforms. Each channel plugin handles the translation between platform-specific APIs and AeonSage’s unified message format.
Supported Channels
AeonSage supports 27+ messaging channels out of the box, with additional channels available through extensions.
Built-in Channels
Extension Channels
Channel Architecture
┌─────────────────────────────────────────────────────────────────┐
│ Channel Plugin System │
│ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ Channel Adapter │ │
│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │
│ │ │ Receive │ │ Format │ │ Send │ │ │
│ │ │ Message │──│ Translate │──│ Message │ │ │
│ │ └─────────────┘ └─────────────┘ └─────────────┘ │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │ │
│ ┌───────────────────────────▼───────────────────────────────┐ │
│ │ Unified Message Format │ │
│ │ { │ │
│ │ channel: "telegram", │ │
│ │ sender: { id, name, ... }, │ │
│ │ content: { text, media, location, ... }, │ │
│ │ metadata: { replyTo, thread, ... } │ │
│ │ } │ │
│ └───────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘
Message Flow
Inbound Messages
Outbound Messages
Channel Configuration
Per-Channel Settings
Each channel supports common and specific configuration options:
Configuration Example
{
"channels": {
"telegram": {
"enabled": true,
"botToken": "YOUR_BOT_TOKEN",
"allowlist": ["123456789"],
"prefix": "!",
"webhookUrl": "https://your-gateway.com/webhook/telegram"
},
"discord": {
"enabled": true,
"botToken": "YOUR_BOT_TOKEN",
"applicationId": "YOUR_APP_ID",
"allowlist": ["123456789012345678"],
"guildId": "YOUR_GUILD_ID"
}
}
}
Allowlist System
The allowlist system controls who can interact with your AeonSage instance.
Allowlist Modes
Managing Allowlists
# Add user to allowlist
aeonsage channels allow add telegram user:123456789
# Add group to allowlist
aeonsage channels allow add discord group:987654321
# List allowlist entries
aeonsage channels allow list telegram
# Remove from allowlist
aeonsage channels allow remove telegram user:123456789
Channel Setup Guides
Each channel has different media limits. AeonSage automatically:
Troubleshooting
Common Channel Issues
Debug Commands
# Check channel status
aeonsage channels status
# Probe channel connectivity
aeonsage channels status --probe
# View channel logs
aeonsage logs --channel telegram
# Test message sending
aeonsage message send telegram:@user "Test message"
Next Steps
Once your channel is configured, you’ll need to set up AI model providers to enable intelligent responses. Configure OpenAI, Anthropic, or run models locally with Ollama for complete privacy.