🤖 Mirza Bot

A powerful Telegram bot for selling VPN services — with fully automated config creation.

---

📚 Table of Contents

• ✨ Overview
• 🧩 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.

---

🧩 Supported Panels

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

Panel	Panel
🟢 Marzban	🟢 Marzneshin
🟢 Sanaei / Alireza
🟢 S-UI	🟢 Hiddify
🟢 WGDashboard (WireGuard)	🟢 MikroTik
🟢 IBSng	🟢 Pasarguard

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

---

💳 Payment Gateways

Gateway	Type
💵 Card-to-Card	Manual (receipt + admin approval)
🪙 NowPayments	Crypto
🪙 Plisio	Crypto
🪙 Tronado	TRON / crypto
🇮🇷 Zarinpal	Online gateway
🇮🇷 Aqayepardakht	Online gateway
🇮🇷 IranPay	Online gateway

---

⚙️ 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

Requirement	Details
🖥️ OS	A clean Ubuntu 22.04 or 24.04 server
🌐 Domain	A domain name pointed to your server's IP
⚙️ Stack	PHP 8.2, Apache, MySQL, SSL — installed automatically by the script

💡 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

Command	Description
install	Install Mirza
update	Update Mirza (choose channel / version)
remove	Remove Mirza and its services
migrate	Migrate Free → Pro
renew	Renew the bot's SSL certificate
menu	Open the interactive panel (default)

Install parameters

Parameter	Description
--name	Bot username
--token	Telegram bot token
--admin	Admin chat ID
--domain	Domain name (e.g. bot.example.com)
--db-user	Database username
--db-pass	Database password
--version	Specific release tag (e.g. 0.1.7)
--channel	beta · release · auto
-h, --help	Show CLI help and exit

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

	Free 🆓	Pro 💎
Automated VPN sales & config creation	✅	✅
Trial accounts, wallet & service management	✅	✅
All supported panels & payment gateways	✅	✅
Advanced customization & analytics	—	✅
Enhanced management & extra modules	—	✅

📌 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:

---

Made with ❤️ by the Mirza Panel community

💬 Channel · 👥 Group · ⭐ Star on GitHub