2026-03-24 17:02:11 +08:00
2025-10-18 14:44:50 +08:00
2026-03-24 17:02:11 +08:00

🤖 Fakabot - Professional Telegram Auto-Delivery Bot

GitHub release GitHub stars GitHub forks GitHub issues License Python Telegram Docker

🚀 Automated Delivery System | Multiple Payment Methods | Redis High-Performance Cache

💳 Alipay · WeChat · USDT | 🐳 Docker One-Click Deploy | 100x Performance Boost

Use Cases: Digital Products · Online Courses · Software Licenses · Memberships

🎬 Live Demo · 📱 Contact · 📖 Documentation

中文文档 | English


⚠️ Important Notice

The current version has removed built-in authorization checks, so license.key is no longer required for deployment.

  • Startup no longer depends on license files
  • Core business flows (payment/order/delivery) remain unchanged
  • Older license-related setup steps in this document are legacy notes

Core Features

💳 Payment System

Supports 4 mainstream payment methods:

Payment Method Features Settlement Speed
Alipay Face-to-face payment, QR code Real-time
WeChat Pay Native payment, QR code Real-time
USDT (TOKEN188) TRC20/ERC20, on-chain verification 1-3 minutes
USDT (Lemon Pay) Multi-chain support, low fees Seconds

Features:

  • Automatic payment confirmation · Payment callback handling · Order status sync · Payment timeout handling

🎯 Auto-Delivery System

Delivery Methods:

  • 📝 Text content (activation codes, accounts, etc.)
  • 🔗 Download links (files, resources, etc.)
  • 👥 Group invitations (Telegram groups, channels)

Features:

  • Instant delivery after payment
  • 🔄 Automatic retry on failure
  • 📊 Delivery record tracking
  • 🔒 One-time invitation links (auto-revoke after use)

Performance Optimization

Redis Cache System:

  • 💾 Product info cache (5 min)
  • ⚙️ Config cache (10 min)
  • 👤 User session cache (1 hour)
  • 📈 100x performance improvement

Rate Limiting:

  • 🛡️ User payment limit (5 times/5 min)
  • 🚫 IP callback limit (100 times/min)
  • ⏱️ User command limit (20 times/min)

📊 Order Management

Admin Features:

  • 📋 Order list (all, pending, completed, failed)
  • 🔍 Order search (by ID, user, product)
  • 💰 Order statistics (amount, quantity)

👥 User Management

User System:

  • 👤 User profiles (ID, username, registration time)
  • 📊 Purchase history (order count, total amount)

🛍️ Product Management

Product Features:

  • Add/edit/delete products
  • 📦 Inventory management (auto-deduct, low stock alert)
  • 💰 Price management
  • 📊 Sales statistics

🎨 Admin Panel

Management Interface:

  • 📊 Dashboard (today's orders, revenue, users)
  • 📈 Monthly statistics
  • ⚙️ System settings (payment config, notification config)
  • 🔔 Message notifications

🚀 Quick Start

🎉 First-Time Setup

💡 For: First-time deployment after purchasing license

Step 1: Clone Project

git clone https://github.com/GUGEGEBAIDU/fakabot.git
cd fakabot

Step 2: Configure

# Copy config example
cp config.json.example config.json

# Edit config
vim config.json

Required fields:

{
  "BOT_TOKEN": "Your Bot Token",  // Get from @BotFather
  "ADMIN_ID": 123456789,          // Your Telegram ID (from @userinfobot)
  "DOMAIN": "https://yourdomain.com",  // Optional
  "PAYMENTS": {
    // Payment configuration
  }
}

Get Bot Token:

  1. Find @BotFather
  2. Send /newbot
  3. Follow prompts to create bot
  4. Get Token

Get Admin ID:

  1. Find @userinfobot
  2. Send any message
  3. Get your ID

Step 3: Save License Key (Important!)

# Paste your complete license key
echo "your_license_key" > license.key

# Example:
echo "M0001|1738310400|abc123def456..." > license.key

Notes:

  • License key must be complete, no extra spaces or newlines
  • Filename must be license.key
  • File location in project root directory

Step 4: Start Service

# Start with Docker Compose
docker-compose up -d

Step 5: Verify

# Check logs
docker-compose logs -f

# Should see:
# ============================================================
# ✅ License verified
# 📝 Customer ID: M0001
# 📅 Expiration: 2025-02-17
# ⏰ Days remaining: 30 days
# ============================================================

Step 6: Test Bot

Search for your bot on Telegram, send /start

If you see welcome message, deployment successful! 🎉


🔄 Renewal Guide

💡 For: License expiring or expired, need renewal

Important: Renewal only requires replacing license key, all data will be preserved!

Step 1: Contact for Renewal

Contact @sonhshu, choose renewal plan:

Plan Price Discount
Monthly 50 USDT -
Quarterly 135 USDT 10%
Yearly 510 USDT 15%

Step 2: Get New License

After payment, you'll receive a file: renewal_license_M0001_xxx.txt

File content example:

Customer ID: M0001
New License: M0001|1740902400|def456...
Renewal Period: 30 days
New Expiration: 2025-03-19

Step 3: SSH to Server

ssh root@your_server_ip

Step 4: Navigate to Project

cd fakabot

Step 5: Replace License

# Method 1: Direct input
echo "new_license_key" > license.key

# Example:
echo "M0001|1740902400|def456..." > license.key

# Method 2: Use editor
vim license.key
# Delete old license, paste new license, save and exit

Step 6: Restart Service

docker-compose restart

Step 7: Verify Renewal

# Check logs
docker-compose logs -f

# Should see:
# ============================================================
# ✅ License verified
# 📝 Customer ID: M0001
# 📅 Expiration: 2025-03-19  ← New expiration date
# ⏰ Days remaining: 30 days
# ============================================================

If you see new expiration date, renewal successful! 🎉

Data Preservation After Renewal

All data preserved:

  • All product configurations
  • All order records
  • All customer data
  • config.json settings
  • Database files

No need to reconfigure anything!


💰 Subscription Pricing

Purchase Options

Plan Duration Price Discount Best For
Monthly 30 days 50 USDT - Trial users
Quarterly 90 days 135 USDT 10% off Regular users
Yearly 365 days 510 USDT 15% off Long-term users

How to Purchase

  1. Contact Customer Service

    • Telegram: @sonhshu
    • Provide your requirements
  2. Make Payment

    • USDT (TRC20): TDZM5DSSq8SrB8QTSBHyNwrcTswtCjKs9t
    • Provide transaction hash
  3. Receive License

    • Get license key file within 5 minutes
    • Includes complete deployment guide
  4. Deploy and Use

    • Follow documentation to deploy
    • Start earning immediately

📞 Contact Us

Customer Service

Technical Support


⚠️ Disclaimer

This project is for learning and legal commercial use only.

By using this project, you agree to:

  • Comply with the laws and regulations of your country/region
  • Use only for legal commercial purposes
  • Take full responsibility for any consequences
  • Not infringe on others' legal rights

Developer Statement:

  • 📢 Developers are not responsible for users' usage behavior
  • 📢 Not liable for any losses caused by using this project
  • 📢 Reserve the right to terminate service and revoke licenses at any time
  • 📢 Reserve the right to refuse service to any user

Strictly Prohibited Uses:

  • Gambling, pornography, or illegal content sales
  • Distribution of content that infringes intellectual property
  • Fraud, pyramid schemes, or illegal activities
  • Money laundering or illegal fund transfers
  • Other activities that violate laws and regulations
  • Online courses and educational content sales
  • Legitimate software license sales
  • Membership subscription services
  • Digital art and music sales
  • E-books and document sales

If users are found using this project for illegal purposes, developers will immediately terminate service and cooperate with relevant authorities.


📄 License

Commercial License

This project uses a commercial license:

Allowed:

  • Personal learning and research
  • Legal commercial use after purchasing license
  • Modification and customization within license scope

Prohibited:

  • Commercial use without authorization
  • Reselling or distributing license keys
  • Removing or modifying the authorization system
  • Use for any illegal purposes

License Terms:

  • License keys are for purchaser's personal use only
  • Non-transferable, non-rentable, non-shareable
  • Violation of license agreement will result in immediate termination
  • Developers reserve the right to pursue legal action

Copyright © 2025 Fakabot Team. All rights reserved.

See Terms of Service for details.


Made with ❤️ by Fakabot Team

Get Started · View Demo · Contact

S
Description
No description provided
Readme MIT 180 KiB
Languages
Python 99.7%
Dockerfile 0.3%