# π€ Fakabot - Professional Telegram Auto-Delivery Bot
[](https://github.com/GUGEGEBAIDU/fakabot/releases)
[](https://github.com/GUGEGEBAIDU/fakabot/stargazers)
[](https://github.com/GUGEGEBAIDU/fakabot/network)
[](https://github.com/GUGEGEBAIDU/fakabot/issues)
[]()
[]()
[](https://t.me/sonhshu)
[]()
### π 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](https://t.me/fakawan_bot) Β· π± [Contact](https://t.me/sonhshu) Β· π [Documentation](#-quick-start)
[δΈζζζ‘£](README.md) | English
---
## β οΈ Important Notice
This project requires a **license key** to run. The code includes a built-in authorization system that cannot be bypassed.
- β
License keys use signature verification and cannot be forged
- β
Automatic reminder 7 days before expiration
- β
Automatic stop after expiration
- β
Support remote renewal without redeployment
---
## β¨ 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
```bash
git clone https://github.com/GUGEGEBAIDU/fakabot.git
cd fakabot
```
#### Step 2: Configure
```bash
# Copy config example
cp config.json.example config.json
# Edit config
vim config.json
```
**Required fields**:
```json
{
"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](https://t.me/BotFather)
2. Send `/newbot`
3. Follow prompts to create bot
4. Get Token
**Get Admin ID**:
1. Find [@userinfobot](https://t.me/userinfobot)
2. Send any message
3. Get your ID
#### Step 3: Save License Key (Important!)
```bash
# 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
```bash
# Start with Docker Compose
docker-compose up -d
```
#### Step 5: Verify
```bash
# 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](https://t.me/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
```bash
ssh root@your_server_ip
```
#### Step 4: Navigate to Project
```bash
cd fakabot
```
#### Step 5: Replace License
```bash
# 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
```bash
docker-compose restart
```
#### Step 7: Verify Renewal
```bash
# 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](https://t.me/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
- **Telegram**: [@sonhshu](https://t.me/sonhshu)
- **Demo Bot**: [@fakawan_bot](https://t.me/fakawan_bot)
- **Response Time**: 24/7 online
### Technical Support
- **GitHub Issues**: [Submit Issue](https://github.com/GUGEGEBAIDU/fakabot/issues)
- **Documentation**: [Complete Documentation](https://github.com/GUGEGEBAIDU/fakabot#readme)
---
## β οΈ 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
### Legal Use Examples:
- β
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](TERMS_OF_SERVICE.md) for details.
---
Made with β€οΈ by Fakabot Team
[Get Started](#-quick-start) Β· [View Demo](https://t.me/fakawan_bot) Β· [Contact](https://t.me/sonhshu)