How filatovuu/notifycat-telegram-bot works
Telegram Parser Bot lets users manage channel-and-keyword subscriptions through a Telegram bot, then monitors those channels with a Telethon user session and sends matching-message alerts by private message. The bot also provides role-limited access, administration of users and subscriptions, private-chat access requests, and support workflows. Redis stores subscriptions and authorization data; bot conversation state is in memory. The graph reflects README capabilities and shown imports/calls; some startup wiring and unsampled admin flows are documented but not verified in source excerpts.
Main entry points: bot_commands.py User commands · bot_messages.py Message workflows · bot_callbacks.py Button callbacks · bot_app.py Bot application
Components 19
Bot interaction
- Service startup
main.py - Bot application
bot/bot_app.py - User commands
bot/bot_commands.py - Message workflows
bot/bot_messages.py - Button callbacks
bot/bot_callbacks.py - Menus and lists
bot/bot_views.py - Conversation state
bot/bot_state.py - Translations
bot/i18n.py
Access and administration
- Role limits
core/roles.py - New-user notices
bot/admin_notify.py
Channel monitoring
- Telegram user client
services/user_client.py
Persistence and messaging
- Subscription store
storage/store.py - Redis subscriptions
storage/redis_store.py - Redis authorization
storage/redis_store.py - Notification sender
services/notifier.py - Runtime configuration
core/config.py
Other components
- Telegram user
- Telegram admin
- Telegram platform
Connections 39
- Telegram user → Bot application: uses bot
README.md - Telegram admin → Bot application: administers
README.md - Service startup → Bot application: starts
main.py - Service startup → Telegram user client: starts
main.py - Service startup → Runtime configuration: loads
main.py - Bot application → User commands: registers
bot/bot_app.py - Bot application → Message workflows: registers
bot/bot_app.py - Bot application → Button callbacks: registers
bot/bot_app.py - Telegram user → User commands: sends commands
README.md - Telegram user → Message workflows: sends messages
README.md - Telegram user → Button callbacks: uses buttons
README.md - User commands → Menus and lists: shows menus
bot/bot_commands.py - Message workflows → Menus and lists: shows menus
bot/bot_messages.py - Button callbacks → Menus and lists: shows lists
bot/bot_callbacks.py - User commands → Conversation state: updates
bot/bot_commands.py - Message workflows → Conversation state: updates
bot/bot_messages.py - Button callbacks → Conversation state: updates
bot/bot_callbacks.py - User commands → Redis authorization: checks access
bot/bot_commands.py - Message workflows → Redis authorization: manages requests
bot/bot_messages.py - Button callbacks → Redis authorization: manages access
bot/bot_callbacks.py - User commands → Role limits: checks limits
bot/bot_commands.py - Message workflows → Role limits: checks limits
bot/bot_messages.py - Button callbacks → Role limits: checks roles
bot/bot_callbacks.py - User commands → New-user notices: formats notice
bot/bot_commands.py - Message workflows → Telegram user client: checks channel access
bot/bot_messages.py - User commands → Redis subscriptions: manages subscriptions
bot/bot_commands.py - Message workflows → Redis subscriptions: manages subscriptions
bot/bot_messages.py - Button callbacks → Redis subscriptions: manages subscriptions
bot/bot_callbacks.py - Menus and lists → Redis subscriptions: reads metadata
bot/bot_views.py - Telegram user client → Redis subscriptions: reads subscriptions
services/user_client.py - Telegram user client → Notification sender: sends alerts
README.md - Notification sender → Telegram platform: sends messages
services/notifier.py - Bot application → Notification sender: registers application
bot/bot_app.py - Bot application → Telegram platform: serves bot
README.md - Redis subscriptions → Redis authorization: shares Redis
storage/redis_store.py - User commands → Translations: localizes text
bot/bot_commands.py - Message workflows → Translations: localizes text
bot/bot_messages.py - Button callbacks → Translations: localizes text
bot/bot_callbacks.py - Menus and lists → Translations: localizes labels
bot/bot_views.py