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.
Quick Filter Setup (Simple)
Named Filters: All commands support optional filter=name
parameter to manage multiple filters.
Without this parameter, commands default to the 'default' filter.
/add_accounts
Add accounts to track
Description Add X (Twitter) accounts to monitor in your filter.
Usage /add_accounts [filter=name] @user1 @user2 ...
Examples
/add_accounts @CryptoHayes @IncomeSharks
- Add to default filter/add_accounts filter=crypto @CryptoHayes
- Add to 'crypto' filter/add_accounts filter=team @teammember1 @teammember2
- Add to 'team' filter
/remove_accounts
Remove tracked accounts
Description Remove specific accounts from monitoring.
Usage /remove_accounts [filter=name] @user1 @user2 ...
Examples
/remove_accounts @CryptoHayes
- Remove from default filter/remove_accounts filter=crypto @CryptoHayes
- Remove from 'crypto' filter
/clear_accounts
Clear all tracked accounts
Description Remove all accounts from the filter.
Usage /clear_accounts [filter=name]
Examples
/clear_accounts
- Clear default filter accounts/clear_accounts filter=crypto
- Clear 'crypto' filter accounts
/add_keywords
Add keywords to track
Description Add keywords or hashtags to monitor.
Usage /add_keywords [filter=name] "keyword1" "keyword2" ...
Examples
/add_keywords "DeFi" "#crypto"
- Add to default filter/add_keywords filter=crypto "bitcoin" "ethereum"
- Add to 'crypto' filter/add_keywords filter=team "our project" "#OurToken"
- Add to 'team' filter
Note Use quotes for multi-word phrases.
/remove_keywords
Remove keywords
Description Remove specific keywords from monitoring.
Usage /remove_keywords [filter=name] "keyword1" "keyword2" ...
Examples
/remove_keywords "DeFi"
- Remove from default filter/remove_keywords filter=crypto "bitcoin"
- Remove from 'crypto' filter
/clear_keywords
Clear all keywords
Description Remove all keywords from the filter.
Usage /clear_keywords [filter=name]
Examples
/clear_keywords
- Clear default filter keywords/clear_keywords filter=crypto
- Clear 'crypto' filter keywords
/add_mentions
Add mentions to track
Description Monitor posts that mention specific accounts.
Usage /add_mentions [filter=name] @user1 @user2 ...
Examples
/add_mentions @BWSCommunity @MyProject
- Add to default filter/add_mentions filter=team @OurProject @OurToken
- Add to 'team' filter
/remove_mentions
Remove mentions
Description Stop monitoring mentions of specific accounts.
Usage /remove_mentions [filter=name] @user1 @user2 ...
Examples
/remove_mentions @BWSCommunity
- Remove from default filter/remove_mentions filter=team @OurProject
- Remove from 'team' filter
/clear_mentions
Clear all mentions
Description Remove all mentions from the filter.
Usage /clear_mentions [filter=name]
Examples
/clear_mentions
- Clear default filter mentions/clear_mentions filter=team
- Clear 'team' filter mentions
/add_excludes
Add content exclusions
Description Exclude specific types of content from monitoring.
Usage /add_excludes [filter=name] type1 type2 ...
Options retweet
, nativeretweets
, quote
, replies
Examples
/add_excludes retweet replies
- Add to default filter/add_excludes filter=crypto retweet
- Add to 'crypto' filter
/remove_excludes
Remove exclusions
Description Stop excluding specific content types.
Usage /remove_excludes [filter=name] type1 type2 ...
Examples
/remove_excludes retweet
- Remove from default filter/remove_excludes filter=crypto retweet
- Remove from 'crypto' filter
/clear_excludes
Clear all exclusions
Description Remove all content exclusions.
Usage /clear_excludes [filter=name]
Examples
/clear_excludes
- Clear default filter exclusions/clear_excludes filter=crypto
- Clear 'crypto' filter exclusions
/add_ignore
Ignore users
Description Ignore posts from specific users (spam/bot accounts).
Usage /add_ignore [filter=name] @user1 @user2 ...
Examples
/add_ignore @spambot1 @botaccount
- Add to default filter/add_ignore filter=crypto @spambot1
- Add to 'crypto' filter
/remove_ignore
Stop ignoring users
Description Remove users from the ignore list.
Usage /remove_ignore [filter=name] @user1 @user2 ...
Examples
/remove_ignore @spambot1
- Remove from default filter/remove_ignore filter=crypto @spambot1
- Remove from 'crypto' filter
/clear_ignore
Clear ignore list
Description Clear the entire ignore list.
Usage /clear_ignore [filter=name]
Examples
/clear_ignore
- Clear default filter ignore list/clear_ignore filter=crypto
- Clear 'crypto' filter ignore list
/show_filter
View current filter
Description Display a specific filter configuration.
Usage /show_filter [filter=name]
Examples
/show_filter
- Show default filter/show_filter filter=crypto
- Show 'crypto' filter/show_filter filter=team
- Show 'team' filter
Response Shows all accounts, keywords, mentions, exclusions, and ignored users for the specified filter.
/list_filters
List all filters
Description Show all filters including the default and any named filters.
Usage /list_filters
Response Lists all available filters with their names and basic statistics.
Advanced Filtering (Named Filters)
/set_x_filtering
Create named filter
Description Create a custom named filter with specific parameters.
Usage /set_x_filtering filter_name [parameters]
Parameters
filter_name
- Custom name for your filterfrom:@username
- Monitor specific userskeywords:word1,word2
- Monitor keywordsmention:@username
- Monitor mentions
Example
/set_x_filtering crypto_kols from:@CryptoHayes keywords:BWS,DeFi mention:@BWSCommunity
/get_x_filtering
View all filters
Description Display all configured filters.
Usage /get_x_filtering
/delete_x_filtering
Delete filters
Description Delete specific or all filters.
Usage /delete_x_filtering [filter_name|*]
Example /delete_x_filtering crypto_kols
or /delete_x_filtering *
Schedule Management
/set_schedule
Set automatic report schedule
Description Set a schedule for automatic report generation. Supports both simple daily schedules and advanced cron expressions.
Usage
- Simple:
/set_schedule HH:MM
- Advanced:
/set_schedule cron(Minutes Hours Day Month Day-of-week Year)
Parameters
HH:MM
- Time in 24-hour format (UTC timezone) for daily schedulecron(...)
- AWS EventBridge cron expression for complex schedules
Examples
/set_schedule 12:30
- Daily at 12:30 PM UTC/set_schedule cron(0 12 ? * MON-FRI *)
- Weekdays at noon UTC/set_schedule cron(0 9 ? * MON *)
- Every Monday at 9 AM UTC/set_schedule cron(0 0 1 * ? *)
- First of each month at midnight 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
Project Settings
/set_project_name
Set your project name
Description: Set the project name for your community. This will be displayed in reports and on the website.
Usage: /set_project_name [name]
Parameters:
name
- The name of your project
Example: /set_project_name My Awesome DeFi Project
Note: Admin only command
/get_project_name
View current project name
Description: Display the currently configured project name.
Usage: /get_project_name
Parameters: None
Response: Shows the current project name or indicates if none is set.
/set_project_description
Set project description
Description: Set a description for your project that explains its goals and purpose.
Usage: /set_project_description [description]
Parameters:
description
- Detailed description of your project
Example: /set_project_description A revolutionary DeFi platform for community governance and yield optimization
Note: Admin only command
/get_project_description
View current project description
Description: Display the currently configured project description.
Usage: /get_project_description
Parameters: None
Response: Shows the current project description or indicates if none is set.
/set_project_logo
Upload project logo
Description: Set a logo for your project. The bot will prompt you to send an image file.
Usage: /set_project_logo
Workflow:
- Send the command
/set_project_logo
- Bot responds asking for the image
- Send your logo image as a photo (not as file)
- Bot confirms upload and provides the public URL
Supported formats: JPG, PNG, GIF (max 20MB)
Note: Admin only command. Logo will be publicly accessible via website URL.
/get_project_logo
View current project logo
Description: Display the URL of the currently configured project logo.
Usage: /get_project_logo
Parameters: None
Response: Shows the current logo URL with a preview link or indicates if none is set.
/set_project_long_description
Set detailed project description
Description: Set a comprehensive, detailed description for your project. This allows for longer explanations than the regular description.
Usage: /set_project_long_description [detailed description]
Parameters:
detailed description
- Comprehensive description of your project, its goals, features, and roadmap
Example: /set_project_long_description Our project is building a revolutionary DeFi ecosystem that combines automated market making with advanced governance mechanisms. We are focused on creating sustainable yield opportunities while maintaining security and decentralization...
Note: Admin only command. Supports very long text (up to 4000 characters).
/get_project_long_description
View detailed project description
Description: Display the currently configured detailed project description.
Usage: /get_project_long_description
Parameters: None
Response: Shows the detailed project description or indicates if none is set.
/set_project_urls
Set project URLs
Description: Set multiple project URLs including website, social media, documentation, and other relevant links.
Usage: /set_project_urls [url1] [url2] [url3] ...
Parameters:
urls
- One or more URLs separated by spaces or commas
Examples:
/set_project_urls https://myproject.com https://twitter.com/myproject https://discord.gg/myproject
/set_project_urls website.com, docs.website.com, github.com/myproject
Note: Admin only command. URLs without protocol (http/https) will automatically have https:// added.
/get_project_urls
View project URLs
Description: Display all currently configured project URLs.
Usage: /get_project_urls
Parameters: None
Response: Shows a numbered list of all project URLs or indicates if none are set.
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.