| documentation

Appearance

How To Install ​

This guide will walk you through installing and configuring X Bot for your Telegram group. The setup process differs based on your use case — choose the path that matches your needs.

Prerequisites ​

Before installing X Bot, ensure you have:

  • A Telegram account
  • Admin access to a Telegram group (or ability to create one)
  • An X (Twitter) account you want to track
  • Basic familiarity with Telegram bots and group management

Choose Your Installation Path ​

Select the setup guide that matches your use case:

Crypto Project Setup ​

Goal: Track your project's X engagement and community activity (optionally use for competitions, prizes, or airdrops)

  1. Find and Add the Bot ​

  • Search for @BWS_X_Bot in Telegram
  • Add the bot to your project's main Telegram group
  • Make the bot an admin with the following settings:
    • Admin rights required: Yes
    • Special permissions needed: None

  1. Create Your X Analytics Query ​

The following is a simple example for first-time installation. You can customize tracking later.

Track your official X account:

/add_accounts @YourProjectAccount

Track your project's cashtag:

/add_cashtags $YourToken

Example:

/add_accounts @SolanaProject
/add_cashtags $SOL

What this does:

  • Tracks all posts from your project's X account
  • Monitors posts mentioning your cashtag (e.g., $SOL)
  • Collects engagement metrics (likes, retweets, replies, quotes, bookmarks, impressions)
  • Includes tracked items in leaderboard rankings

  1. Schedule Daily Reports ​

Set up automatic daily analytics reports:

/set_schedule 12:00

What this does:

  • Generates automated reports daily at 12:00 UTC
  • Posts performance screenshots and leaderboards to your group
  • Tracks top accounts, hashtags, cashtags, and mentions
  • Keeps community engaged with regular updates

Tip: Choose a time when your community is most active for maximum engagement.

  1. Verify Installation ​

Force an initial report to verify everything is working:

/recreate

What this does:

  • Creates an immediate performance report based on your configured tracking
  • Shows leaderboards for accounts, hashtags, cashtags, and mentions
  • Confirms tracking is working correctly
  • Gives you a preview of daily automated reports

  1. Add Project Metadata (Optional) ​

Add project information to be featured on the xbot.ninja website:

/set_project_name "Solana"
/set_project_description "High-performance blockchain supporting builders around the world"
/set_project_logo "https://example.com/solana-logo.png"

What this does:

  • Displays your project on the xbot.ninja website for investor and community discovery
  • Helps investors find projects with authentic community traction
  • Showcases your project's performance metrics publicly

  1. Customize Your Reports (Optional) ​

Personalize reports with custom branding.

Set Custom Point Weights (Likes, Retweets, Replies, Quotes, Bookmarks, Impressions):

/set_points 1 2 1.5 3 2 0.001

Set Custom Colors:

/set_colors #FF6B6B #4ECDC4 #45B7D1 #FFA07A #98D8C8 #F7DC6F

Set Custom Titles:

/set_top_title "🏆 Top Community Champions" "#FFD700"

Individual KOL Setup ​

Goal: Get publicly listed on xbot.ninja to showcase your competencies and performance metrics.

  1. Create Your Analytics Group ​

  • Open Telegram and create a new group
  • Name it something like "My X Analytics" or "KOL Performance Tracker"
  • This can be a private group for personal tracking

Tip: Keep this group private or share it with potential clients to showcase your metrics.

  1. Find and Add X Bot ​

  • Search for @BWS_X_Bot in Telegram
  • Add the bot to your newly created group
  • Make the bot an admin with:
    • Admin rights required: Yes
    • Special permissions needed: None

  1. Track Your X Account ​

Monitor your personal X account performance:

/add_accounts @YourTwitterHandle

Example:

/add_accounts @CryptoKOL_Joe

What this does:

  • Tracks all your posts and engagement metrics
  • Builds a verifiable portfolio of your performance
  • Enables discovery on xbot.ninja
  • Provides data for client reports

  1. Add Your Topics ​

Track keywords relevant to your content:

/add_keywords "crypto" "DeFi" "trading" "#Bitcoin" "$BTC"

What this does:

  • Shows which topics you're covering
  • Demonstrates your niche expertise
  • Tracks community engagement with your topics
  • Helps projects find you based on relevant keywords

  1. Enable Regular Reports ​

Get daily performance insights:

/set_schedule 09:00

What this does:

  • Sends daily performance reports at 09:00 UTC
  • Tracks engagement trends over time
  • Helps identify top-performing content
  • Provides data for client reporting

  1. Create Your First Report ​

Generate your first analytics report:

/recreate

What this does:

  • Creates an immediate snapshot of your performance
  • Shows engagement metrics and rankings
  • Verifies tracking is working correctly
  • Gives you shareable proof of your influence

  1. Add Your Profile Metadata (Optional) ​

Add profile information to be featured on the xbot.ninja website:

/set_project_name "Your Name/Brand"
/set_project_description "Crypto KOL specializing in DeFi and trading"
/set_project_logo "https://your-profile-image-url.jpg"

What this does:

  • Displays your KOL profile on xbot.ninja
  • Helps project owners discover and hire you
  • Showcases engagement metrics and expertise publicly

To get publicly listed:

  • Maintain a minimum performance threshold by posting and engaging consistently
  • Build authentic engagement (avoid vanity metrics)
  • Monitor daily reports to track progress toward listing

Note: Featured KOLs are continuously monitored to maintain quality standards.

KOL Team Setup ​

Goal: Track team performance accurately and show clients real, measurable results

  1. Create Team Analytics Group ​

  • Open Telegram and create a new group
  • Name it "KOL Team Analytics" or "[Team Name] Performance Tracker"
  • This will be your shared analytics dashboard

Tip: Make this group private and invite only team members and trusted clients.

  1. Find and Add Bot as Admin ​

  • Search for @BWS_X_Bot in Telegram
  • Add the bot to your team group
  • Make the bot an admin:
    • Admin rights required: Yes
    • Special permissions needed: None

  1. Add Team Members ​

Invite all KOL team members to the group:

  • Click the group name to open group info
  • Tap "Add Members"
  • Select all team members
  • Ensure everyone can see the analytics and reports

  1. Track All Team Accounts ​

Add all team members' X accounts for tracking:

/add_accounts @KOL1 @KOL2 @KOL3

Example:

/add_accounts @CryptoKOL_Alice @DeFiKOL_Bob @TradingKOL_Charlie

What this does:

  • Tracks team members' posts and engagement
  • Creates team-wide leaderboards
  • Enables performance comparisons
  • Provides aggregate metrics for client reports

  1. Set Projects You Work For ​

Monitor client projects with cashtags:

/add_cashtags $PROJECT1 $PROJECT2 $PROJECT3

Example:

/add_cashtags $SOL $AVAX $MATIC

What this does:

  • Tracks team engagement with client tokens
  • Shows which members promote which projects
  • Demonstrates ROI to clients with verifiable metrics
  • Identifies top performers per campaign

  1. Schedule Team Reports ​

Set up daily team performance reports:

/set_schedule 10:00

What this does:

  • Generates daily reports at 10:00 UTC
  • Posts leaderboards showing top team members
  • Tracks trends for each project
  • Provides regular updates for team and clients

Tip: Schedule for team standups or planning meetings.

  1. Create Your First Report ​

Generate your first team analytics report:

/recreate

What this does:

  • Creates an immediate team performance snapshot
  • Shows individual and aggregate metrics
  • Verifies all accounts are tracked correctly
  • Provides shareable data for client presentations

  1. Add Team Metadata (Optional) ​

Feature your team on xbot.ninja:

/set_project_name "Alpha KOL Team"
/set_project_description "Elite crypto KOL team specializing in DeFi, NFTs, and trading"
/set_project_logo "https://your-team-logo-url.jpg"

What this does:

  • Displays your KOL team on xbot.ninja
  • Helps project owners discover and hire your team
  • Showcases team engagement metrics publicly

  1. Customize Team Branding (Optional) ​

Personalize reports with custom titles:

/set_top_title "🏆 Top Team Performers This Month" "#FFD700"
/set_best_title "⭐ Best Tweet of the Period" "#4ECDC4"

  1. Exclude Internal Accounts (Optional) ​

Hide internal/test accounts from leaderboards:

/add_ignore_list @InternalTestAccount @TeamAdminAccount

Verification and Testing ​

  1. Check bot status ​

  • The bot should appear as an admin in your group

  1. Test a command ​

  • Run /help to see all available commands

  1. Generate a report ​

  • Run /recreate to create your first analytics report

  1. Review the output ​

  • Ensure accounts and keywords are tracked correctly

  1. Check scheduled reports ​

  • Wait for your scheduled time to verify automation

Common Issues and Solutions ​

Bot Not Responding

Possible causes:

  • Bot not made admin in the group
  • Bot was removed or banned
  • Network connectivity issues

Solutions:

  1. Verify bot has admin status
  2. Remove and re-add the bot
  3. Check Telegram server status
No Data in Reports

Possible causes:

  • Accounts or keywords not configured
  • Tracking period too short (wait a few hours)
  • X accounts have privacy restrictions

Solutions:

  1. Run /get_accounts and /get_keywords to verify configuration
  2. Wait for X API to collect data (can take a few hours)
  3. Ensure tracked X accounts are public
Reports Not Generating

Possible causes:

  • No schedule set
  • Schedule time in wrong timezone (should be UTC)
  • Insufficient data for report generation

Solutions:

  1. Run /get_schedule to verify configuration
  2. Set schedule with /set_schedule HH:MM (UTC time)
  3. Manually generate report with /recreate to test

Installation takes just a few minutes. Once configured, X Bot runs automatically, providing scheduled analytics to help you track, measure, and improve your X engagement.