milmilNotifications & Bot
Set up push notifications and interactive bot commands via Telegram, Discord, or webhooks.
Overview
milmil can send push notifications and accept interactive bot commands through Telegram, Discord, and generic webhooks. Both features are configured in Settings > Notifications.
Each platform card has two independent toggles:
- Push Notifications — one-way alerts for downloads, errors, and system events
- Bot Commands — interactive commands like
/schedule,/search,/downloads
Telegram Setup
Create a Bot
- Open Telegram and search for @BotFather
- Send
/newbot - Enter a display name (e.g.
milmil) - Enter a username ending in
bot(e.g.milmil_media_bot) - BotFather replies with a Bot Token — copy it
Get Your Chat ID
- Send any message to your new bot
- Open in browser:
https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates - Find
"chat":{"id": 123456789}— that number is your Chat ID
Configure in milmil
- Go to Settings > Notifications > Telegram
- Paste the Bot Token
- Enter the Chat ID
- Enable Push Notifications and/or Bot Commands
- Click Save
Webhook Mode (Optional)
By default the bot uses long polling (works behind NAT/firewalls). If your server has a public URL, you can switch to webhook mode for lower latency.
Enter a Webhook URL (e.g. https://your-domain.com/api/v1/bot/telegram/webhook). Leave blank to use polling.
Allowed Chat IDs
Restrict which Telegram chats can send commands to the bot. Enter comma-separated chat IDs. Leave blank to allow only the configured Chat ID.
Event Routing
Configure which events go to which platforms using the event routing matrix below the platform cards.
| Event | Description |
|---|---|
| Download Started | RSS rule triggers a new download |
| Download Completed | Download finishes successfully |
| Download Failed | Download encounters an error |
| Library Scan Complete | Library scan finishes processing |
| System Error | Background job fails unexpectedly |
Bot Commands
| Command | Description |
|---|---|
/start | Welcome message and command list |
/schedule | Weekly airing schedule |
/search <query> | Search anime |
/detail <id> | Anime details with cover and score |
/downloads | Active downloads with progress |
/subscribe <anime> | Set up auto-download subscription |
/status | System overview |
/mylist [status] | Your anime collection |
/continue | Recently watched, continue watching |
Commands support inline buttons for quick actions like subscribing, pausing downloads, and viewing details.