Getting Started
Dashboard Guides
Trading Guides
Reference
Telegram Integration
Need Help?
Join our community for support, updates, and trading discussions.
Telegram Bot Setup
Connect your personal Telegram bot to receive real-time notifications and control ScreenerBot remotely. Use Discovery Mode to find your chat, and optionally protect commands with the same 2FA as your dashboard lockscreen.
Before You Begin
Prerequisites
- Telegram AccountAny Telegram account (mobile or desktop app)
- ScreenerBot RunningDashboard accessible at
localhost:8080
Step 1: Create Your Bot with @BotFather
BotFather is Telegram's official bot for creating and managing bots. It will generate a unique API token for your bot.
Creating Your Telegram Bot
- 1
Open Telegram and search for @BotFather (or click t.me/BotFather)
- 2
Send the command
/newbot - 3
Choose a display name for your bot
Example: "My ScreenerBot"
- 4
Choose a username for your bot
Must end in 'bot'. Example: "my_screenerbot_123_bot"
- 5
Copy the API token that BotFather sends you
Your API Token Format
The token consists of numbers, a colon, and alphanumeric characters
Keep your token secret! Anyone with your bot token can control your bot. Never share it publicly or commit it to version control.
Step 2: Configure in Dashboard
Connect your Telegram bot to ScreenerBot through the dashboard settings. No Chat ID needed – sessions are created automatically when users authenticate.
Dashboard Configuration
- 1
Open ScreenerBot dashboard at
localhost:8080 - 2
Navigate to Settings → Telegram tab
- 3
Enter your Bot Token from BotFather
- 4
Toggle Enable Telegram to ON
Passwordless Sessions
- • No password required – sessions are created automatically when you interact with the bot
- • Sessions timeout after a configurable period (set in Telegram settings)
- • If lockscreen 2FA is enabled in Security settings, expired sessions require the
/logincommand + TOTP code to reactivate - • View and manage active sessions from the dashboard
Chat Discovery Mode (Recommended)
Instead of manually finding your chat ID, ScreenerBot can automatically discover it when you message the bot. This is the easiest way to set up notifications.
How to Use Discovery Mode
- 1
Enter your bot token in the Telegram settings tab
- 2
Click "Start Discovery" – the bot will begin listening for messages
- 3
Open Telegram and send any message to your bot (e.g., "hello")
- 4
The dashboard will show your chat detected with username and chat ID
- 5
Click "Select" to use that chat for notifications
- 6
Done! The chat ID is automatically saved to your settings
Why Use Discovery Mode
- • No need to manually find chat_id using @userinfobot or other methods
- • Works for both private chats and group chats
- • Automatically validates the connection
- • Saves configuration to your settings instantly
Group Chat Discovery
To use ScreenerBot in a group:
- Add the bot to your group
- Start discovery mode in dashboard
- Send a message in the group mentioning the bot
- Select the group chat when it appears
Step 3: Protect Commands with 2FA (Optional)
If you have lockscreen 2FA enabled in your Security settings, you can use the same authentication to protect Telegram bot commands.
2FA Protection for Telegram
2FA is configured in Security settings, not Telegram settings. The Telegram tab shows whether lockscreen 2FA is currently configured. If enabled, it automatically protects Telegram commands too.
How It Works
- 1
Configure 2FA in Security settings (Settings → Security → Enable 2FA)
This protects both your dashboard lockscreen and Telegram commands
- 2
Enable "Require 2FA for Commands" in Telegram settings
This toggle controls whether expired sessions require TOTP verification
- 3
When your session expires, use the
/logincommandThe bot will prompt you to enter your 6-digit authenticator code
- 4
Session reactivated! You can now use bot commands until the session expires again
Session Behavior
- • Without 2FA: Sessions auto-reactivate when you send any command
- • With 2FA enabled: Expired sessions require
/login+ TOTP code - • Session timeout is configurable in Telegram settings
Note: If you haven't configured 2FA in Security settings, the "Require 2FA for Commands" toggle will have no effect. Sessions will auto-reactivate without verification.
How Sessions Work
Telegram uses a passwordless session system. Here's how it works:
Session Lifecycle
Send Command
You message your bot on Telegram
Session Created
Automatic session activation
Session Expires
After configurable timeout period
Reactivate
Auto or via /login if 2FA enabled
Passwordless by default. Sessions are created automatically. 2FA verification is only required when "Require 2FA for Commands" is enabled and your session has expired.
Troubleshooting
"Not receiving notifications"
- • Make sure you've set up a chat ID (use Discovery Mode or enter manually)
- • Check that your session is active in the dashboard
- • If session expired and 2FA is enabled, use /login to reactivate
- • Verify ScreenerBot is running and the dashboard is accessible
"Invalid token"
- • Copy the token again from BotFather
- • Make sure there are no extra spaces before or after the token
- • Ensure you copied the complete token including the colon
"Bot not responding"
- • Confirm ScreenerBot is running (check the dashboard)
- • Check the logs for any error messages
- • Try restarting ScreenerBot