---

#📚 Table of Contents

• ✨ Overview
• 📖 Documentation
• 🧩 Supported Panels
• 💳 Payment Gateways
• ⚙️ Features
• 🚀 Installation
  • Prerequisites
  • Install
  • Update
  • Remove
  • Non-Interactive (CLI) Usage
• 💎 Free vs. Pro
• 🌍 Languages
• 💵 Support the Project
• 👥 Contributors

---

#✨ Overview

Mirza Bot is a feature-rich Telegram bot for selling VPN subscriptions and automating the entire sales workflow — from purchase and payment to config creation and service management.

It connects directly to your panels, builds configurations automatically, accepts a wide range of payment methods, and gives both customers and admins a clean experience through a Telegram Mini App and a web admin panel.

Whether you're handing out trial accounts or running a large-scale reseller business, Mirza Bot has the tools to run it end to end.

---

#📖 Documentation

The complete user manual lives at mirzabot.com/docs — 61 pages covering every part of the bot, written in Persian (فارسی).

It is not a feature list: every menu is documented with the exact order of the steps the bot asks for, what each field accepts, the error message you get when it rejects your input, and the mistake that most often breaks that feature.

The docs are generated from the bot's own source, so menu names, limits and error strings match the code rather than an older release.

---

#🧩 Supported Panels

Mirza Bot integrates with the most popular VPN and network management panels:

Configs are generated automatically and are compatible with all common protocols.

---

#💳 Payment Gateways

---

#⚙️ Features

#🛒 Sales & Configuration

• ✅ VPN purchase with fully automated config creation
• ✅ Trial / test accounts for new users
• ✅ Compatibility with all common protocols
• ✅ QR codes for fast config import
• ✅ Protocol-based configuration settings
• ✅ Product, panel & gateway management

#👤 User Experience

• ✅ Telegram Mini App for a modern, in-app interface
• ✅ View & manage purchased services:
  • Renew a service
  • Buy additional volume
  • Retrieve config / update subscription links
• ✅ Wallet & balance system
• ✅ Detailed purchase & trial reports
• ✅ Support section, FAQ & customizable tutorials
• ✅ Phone-number verification
• ✅ Mandatory channel membership for purchases

#📈 Growth & Marketing

• ✅ Affiliate / referral system
• ✅ Cashback rewards
• ✅ Discount codes
• ✅ Gift codes
• ✅ Lottery system
• ✅ Agent / reseller system

#🛠️ Administration

• ✅ Web admin panel (login-protected dashboard)
• ✅ Multiple admins support
• ✅ Balance & user management
• ✅ Full text/message customization from the bot
• ✅ Configurable username-generation methods
• ✅ Automatic backups
• ✅ Notification & expiry-reminder services (cron)
• ✅ On-hold configurations

---

#🚀 Installation

#Prerequisites

💡 Start from a fresh server with no existing web server, database, or panel installed.

#Install

Run the following command on your server as root:

curl -o install.sh -L https://raw.githubusercontent.com/mahdiMGF2/mirzabot/main/install.sh && bash install.sh

An interactive menu will appear:

1) Install Mirza
2) Update Mirza
3) Remove Mirza
4) Migrate: Free → Pro (Beta)
5) Renew SSL certificate
6) Help & Parameters
7) Exit

➡️ Select 1 to install the bot, then follow the prompts.

#Update

Run the same command and select 2:

curl -o install.sh -L https://raw.githubusercontent.com/mahdiMGF2/mirzabot/main/install.sh && bash install.sh

#Remove

Run the same command and select 3 to completely remove the bot and its services.

#Non-Interactive (CLI) Usage

You can also drive the installer entirely from the command line — handy for automation and scripted deployments.

Commands

Install parameters

Examples

# Auto-pick the best channel
mirza install --channel auto

# Fully non-interactive install
mirza install --name myvpnbot --token 123:ABC \
              --admin 111 --domain bot.example.com --version 0.1.7

# Update to a specific version or channel
mirza update --version 0.1.6
mirza update --channel release

# Remove
mirza remove

---

#💎 Free vs. Pro

📌 Pro purchase guide: View on Telegram »

---

#🌍 Languages

Mirza Bot ships with full translations for:

🇬🇧 English · 🇮🇷 Persian (فارسی) · 🇷🇺 Russian (Русский) · 🇨🇳 Chinese (中文)

---

#💵 Support the Project

If Mirza Bot helps your business, please consider supporting its development with a crypto donation:

Your support keeps the updates and improvements coming. Thank you! 🙌

---

#👥 Contributors

Thanks to everyone who has contributed to making Mirza Bot better:

---