# π€ 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)
- π Sales statistics (daily, weekly, monthly)
- π° Revenue statistics (by product, by payment method)
- π Data export (CSV, Excel)
### π₯ User Management
**User System**:
- π€ User profiles (ID, username, registration time)
- π Purchase history (order count, total amount)
- π·οΈ User tags (VIP, blacklist, etc.)
- π User notes (remarks, special instructions)
### ποΈ Product Management
**Product Features**:
- β Add/edit/delete products
- π¦ Inventory management (auto-deduct, low stock alert)
- π° Price management (original price, sale price)
- π¨ Product display (name, description, image)
- π Sales statistics (sales count, revenue)
### π¨ Admin Panel
**Management Interface**:
- π Dashboard (today's orders, revenue, users)
- π Data charts (sales trends, revenue trends)
- βοΈ System settings (payment config, notification config)
- π Message notifications (new orders, payment success)
---
## π 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)
---
## π License
This project is a commercial software and requires a license key to run.
**Copyright Β© 2025 Fakabot Team. All rights reserved.**
---
Made with β€οΈ by Fakabot Team
[Get Started](#-quick-start) Β· [View Demo](https://t.me/fakawan_bot) Β· [Contact](https://t.me/sonhshu)