Connect AeonSage to Telegram for instant access to your AI assistant from anywhere.
Overview Features Feature Status Send messages ✅ Receive messages ✅ Inline queries ✅ File attachments ✅ Voice messages ✅ Group chats ✅ Thread support ✅
Quick Setup
Create a Telegram Bot
Open Telegram and search for @BotFather
Send /newbot
Follow the prompts:
Bot name: AeonSage (or your preferred name)
Bot username: Must end with _bot (e.g., my_aeon_bot)
Copy the bot token (format: 123456789:ABCdefGhIjKlMnoPqRsTuVwXyZ)
Add Channel to AeonSage aeonsage channel add telegram --token 123456789:ABCdefGhIjKlMnoPqRsTuVwXyZ
Or add to config.json: { "channels" : { "telegram" : { "enabled" : true , "token" : "123456789:ABCdefGhIjKlMnoPqRsTuVwXyZ" } } }
Start the Gateway You should see: [INFO] Telegram channel connected [INFO] Bot username: @your_aeon_bot
Get Your Access Code Send /start to your bot on Telegram. It will respond with an access code prompt.
Check Gateway logs for the access code:
aeonsage logs --channel telegram
Send the access code to the bot
You’re authenticated! Start chatting with your AI.
Configuration Full Configuration Reference { "channels" : { "telegram" : { "enabled" : true , "token" : "${TELEGRAM_BOT_TOKEN}" , "allowedUsers" : [], "allowedGroups" : [], "commands" : { "enabled" : true , "prefix" : "/" }, "features" : { "voice" : true , "files" : true , "inline" : true }, "rateLimit" : { "windowMs" : 60000 , "max" : 30 } } } }
Configuration Options Option Type Default Description tokenstring required Bot token from BotFather allowedUsersarray [] Whitelisted user IDs (empty = all allowed) allowedGroupsarray [] Whitelisted group IDs commands.enabledboolean true Enable slash commands commands.prefixstring ”/“ Command prefix features.voiceboolean true Process voice messages features.filesboolean true Process file attachments rateLimit.maxnumber 30 Max messages per minute
Usage Direct Messages Send any message to your bot:
You: What's the weather today? Bot: I don't have real-time weather data, but I can help you check weather websites...
Slash Commands Command Description /startStart the bot and authenticate /helpShow available commands /resetReset conversation context /model [name]Switch AI model /statusShow session status
Voice Messages Voice messages are automatically transcribed using Whisper (if enabled) and processed as text.
To enable voice processing:
{ "channels" : { "telegram" : { "features" : { "voice" : true , "voiceModel" : "whisper-1" } } } }
Group Chats To use in groups:
Add bot to group Configure group permissions :
{ "allowedGroups" : [ -1001234567890 ] }
Mention the bot to trigger responses:
@your_aeon_bot What do you think about this?
In groups, the bot only responds when mentioned. Set group privacy to “Disabled” in BotFather to allow the bot to see all messages.
Security Access Control
Webhook vs Polling Webhook (Recommended)
Long Polling
More efficient for production. Requires HTTPS. { "telegram" : { "webhook" : { "enabled" : true , "url" : "https://your-domain.com/telegram/webhook" , "port" : 8443 } } }
Simpler setup, works behind NAT. Default mode. { "telegram" : { "polling" : { "enabled" : true , "interval" : 1000 } } }
Troubleshooting
Advanced Custom Commands Define custom commands:
{ "commands" : { "custom" : { "weather" : { "description" : "Get weather info" , "handler" : "skills/weather" }, "translate" : { "description" : "Translate text" , "handler" : "skills/translator" } } } }
Inline Mode Enable inline queries:
Enable inline mode in @BotFather :
Configure in AeonSage:
{ "features" : { "inline" : true } }
Users can now query your bot from any chat:
@your_aeon_bot tell me a joke
Next Steps Now that you have Telegram configured, you can explore additional messaging channels to expand your AeonSage deployment. Other popular channels include Discord for community servers and WhatsApp for personal messaging. Check the channels documentation to see all available integration options. 