Get Started with X Bot
Follow these simple steps to add X Bot to your Telegram group and start tracking X (Twitter) analytics.
Add to Your Group
Add the bot to your Telegram group. No special permissions required!
Essential Configuration
Configure these two essential settings to get started:
Set X Monitoring Filter
/set_x_filtering my_filter keywords:BWS mention:@BWSCommunity
Configure what X (Twitter) content to monitor with keywords and mentions.
Set Daily Report Schedule
/set_schedule 12:30
Set automatic daily report generation time (UTC timezone).
Generate Your First Report
Create your first analytics report manually:
/recreate
This command will generate your first analytics report based on your filters.
Available Commands
Basic Commands
/start
Initialize bot and show welcome message
Description Initializes the bot and displays a welcome message with basic information.
Usage /start
Parameters None
Response In groups shows "X Bot is running", in private chat provides setup guidance.
/help
Display available bot commands
Description Shows all available commands based on your permissions (admin vs regular user).
Usage /help
Parameters None
Response List of commands you can use, organized by category.
Content Monitoring
/set_x_filtering
Configure X monitoring filters
Description Configure what X (Twitter) content to monitor with keywords, users, and mentions.
Usage /set_x_filtering filter_name [parameters]
Parameters
filter_name
- Name for your filter (required)from:@username
- Monitor specific userskeywords:word1,word2
- Monitor specific keywordsmention:@username
- Monitor mentions of users
Example
/set_x_filtering crypto_kols from:@CryptoHayes keywords:BWS,DeFi mention:@BWSCommunity
Documentation View detailed documentation
/get_x_filtering
View current monitoring filters
Description Display all currently configured X monitoring filters.
Usage /get_x_filtering
Parameters None
Response List of all active filters with their configurations.
/delete_x_filtering
Remove monitoring filters
Description Remove specific X monitoring filters or all filters.
Usage /delete_x_filtering [filter_name|all]
Parameters
filter_name
- Name of specific filter to deleteall
- Delete all filters
Example /delete_x_filtering crypto_kols
or
/delete_x_filtering all
Schedule Management
/set_schedule
Set automatic report time (UTC)
Description Set the time for automatic daily report generation (UTC timezone).
Usage /set_schedule HH:MM
Parameters
HH:MM
- Time in 24-hour format (UTC timezone)
Example /set_schedule 12:30
(12:30 PM UTC)
/get_schedule
View current schedule
Description Display the currently configured automatic report schedule.
Usage /get_schedule
Parameters None
Response Shows scheduled time or "No schedule configured".
/delete_schedule
Remove report schedule
Description Remove the automatic report schedule, stopping daily reports.
Usage /delete_schedule
Parameters None
Response Confirmation that schedule has been removed.
Reporting
/recreate
Generate report immediately
Description Force immediate generation of analytics report based on current filters.
Usage /recreate [delete_history]
Parameters
delete_history
- Optional flag to delete existing report history
Example /recreate
or
/recreate delete_history
/report
Display most recent report
Description: Display the most recently generated analytics report.
Usage: /report
Parameters: None
Response: Shows latest report with leaderboards and best posts.
Customization
/set_points
Configure scoring multipliers
Description: Configure point multipliers for different engagement metrics.
Usage:
/set_points likes retweets replies quotes impressions
Parameters:
likes
- Points per like (default: 1)retweets
- Points per retweet (default: 2)replies
- Points per reply (default: 1.5)quotes
- Points per quote tweet (default: 3)impressions
- Points per impression (default: 0.001)
Example: /set_points 5 1 20 10 0.01
/set_colors
Set display colors
Description: Set HTML colors for engagement metrics display in reports.
Usage: /set_colors color1 color2 color3
Parameters:
color1, color2, color3
- HTML color codes (hex format)
Example: /set_colors #536352 #536354 #536351
/set_top_title
Customize leaderboard title
Description: Customize the leaderboard section title and color in reports.
Usage: /set_top_title 'title' color
Parameters:
title
- Custom title text (in quotes)color
- HTML color code for the title
Example: /set_top_title '🏆 Top Performers' #FF0000
Pro Features
/buy
Purchase X Bot Pro Edition
Description: Initiate the purchase process for X Bot Pro Edition subscription.
Usage: /buy
Parameters: None
Response: Provides Stripe checkout link for subscription purchase.
/subscription
Manage billing and subscription
Description: Access Stripe customer portal to manage billing and subscription.
Usage: /subscription
Parameters: None
Response: Provides link to Stripe customer portal for payment management.
/get_credits
Check remaining credits
Description: Check your remaining monthly X Bot credits and usage.
Usage: /get_credits
Parameters: None
Response: Shows current credit balance and monthly allowance.