← Back to Dashboard

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 filter
  • from:@username - Monitor specific users
  • keywords:word1,word2 - Monitor keywords
  • mention:@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 schedule
  • cron(...) - 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:

  1. Send the command /set_project_logo
  2. Bot responds asking for the image
  3. Send your logo image as a photo (not as file)
  4. 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.

Need Help?

Documentation

Complete guides and tutorials

View Docs

Community

Join our community for support

Contact

Direct support and feedback

Contact Support