---

╔══════════════════════════════════════════════════════════════════╗
║  🇵🇰  BLS PAKISTAN SELFIE BYPASS — PRODUCTION SYSTEM             ║
║  Register → Login → Select → Bypass → Scan → Book → Confirm     ║
╚══════════════════════════════════════════════════════════════════╝

---

🧠 What Is This?

BLS Pakistan Selfie Bypass Bot is a production-grade, fully asynchronous Telegram automation system engineered to eliminate manual visa appointment searching on the BLS International Pakistan portal — with a built-in selfie verification bypass engine.

The system handles the complete end-to-end flow — from account creation and login, through country/city/visa selection, selfie checkpoint bypass, real-time slot detection, application filling, and confirmed reservation — with zero manual effort.

Built for people who can't afford to miss a slot. The selfie wall won't stop this bot.

Without this bot:    Register → login → selfie wall → blocked → missed slots → repeat
With this bot:       Launch → Credentials → Bypass → Select → Book → Done. In under 60 seconds.

Keywords: BLS Pakistan appointment bot · BLS selfie bypass · Pakistan visa booking automation · Schengen visa bot Pakistan · Python automation tool · Telegram scheduling engine · BLS Pakistan slot detector

---

🇵🇰 Supported Visa Types & Categories

🔵 Short Stay — Schengen Visa (Type C) · Up to 90 days

#	Category	Purpose
✈️	Tourism	Travel, vacation, leisure in Schengen zone
💼	Business	Meetings, conferences, trade visits
👨‍👩‍👧	Family Visit	Visiting relatives or friends
🏥	Medical	Healthcare & treatment purposes

🟣 Long Stay — National Visa (Type D) · 90+ days

#	Category	Purpose
🎓	Study	University enrollment & academic programs
👔	Work	Employment & labor authorization
🏠	Family Reunion	Join family members residing abroad

---

🏙️ Supported Cities — BLS Pakistan Centers

City	BLS Center	Coverage
🏛️ Islamabad	BLS International — Islamabad	All visa types & categories
🌆 Lahore	BLS International — Lahore	All visa types & categories
🌊 Karachi	BLS International — Karachi	All visa types & categories

---

⚙️ Full Booking Flow — What The Bot Automates

Step	Action	Status
1️⃣	Create Account — Email + Password registration on BLS portal	🤖 Automated
2️⃣	Login — Secure session authentication	🤖 Automated
3️⃣	Selfie Verification Bypass — Defeats identity checkpoint	🛡️ Bypassed
4️⃣	Select Visa Country — e.g. Spain / Italy / France	👤 User Selects
5️⃣	Select City — Islamabad / Lahore / Karachi	👤 User Selects
6️⃣	Select Visa Type — Short Stay (C) / Long Stay (D)	👤 User Selects
7️⃣	Select Category — Tourism / Study / Work / etc.	👤 User Selects
8️⃣	Scan Appointment Dates — Real-time slot detection	🤖 Automated
9️⃣	Fill Application Details — Personal info auto-populated	🤖 Automated
🔟	Confirm Appointment — Reserve & lock the slot	🤖 Automated

---

⚙️ Features

Feature	Details
🛡️ Selfie Bypass Engine	Defeats BLS Pakistan's selfie verification checkpoint automatically
⚡ Real-Time Slot Engine	Detects 3–5 live appointment windows per scan, spread across future dates
🔐 Full Account Automation	Handles registration, login & session management without user intervention
🤖 End-to-End Booking Workflow	Register → Login → Bypass → Country → City → Visa → Slot → Fill → Confirm
🧠 FSM State Machine	Per-user session isolation via aiogram Finite State Machine
🏙️ 3-City Coverage	Islamabad · Lahore · Karachi — all BLS Pakistan centers supported
🌍 Multi-Country Selection	Supports multiple destination countries (Spain, Italy, France, etc.)
🔁 On-Demand Refresh	Users trigger live re-scans at any point in the flow
📊 Urgency Intelligence	Dynamic social-proof signals — active searchers, bookings today, live viewers
🛡️ Input Validation	All selections validated against internal visa/category map — no invalid routes
💳 Payment Integration	Slot reservation + WhatsApp CTA redirect with live countdown timer
📢 Admin Broadcast Engine	Push alerts to all registered users instantly — slots or confirmations
📁 User Registry Export	One-command CSV download of the complete user base
🔐 Role-Based Access Control	Admin panel locked to environment-configured ID allowlist
📋 Production Logging	Full asyncio-aware log pipeline for runtime observability

---

🛠️ Tech Stack

Layer	Technology	Purpose
Language	Python 3.11+	Core runtime
Bot Framework	aiogram 3.x	Async Telegram Bot API
Concurrency	asyncio	Non-blocking event loop
State Engine	aiogram FSM + MemoryStorage	Per-user session management
Web Automation	httpx / aiohttp	Async HTTP requests to BLS portal
Bypass Engine	Custom selfie verification handler	Defeats identity checkpoint
Configuration	python-dotenv	Secure environment loading
Data Layer	Python dataclasses + dict	Structured country/city/visa/category map
Slot Engine	Custom async generator	Real-time appointment slot logic
Export	csv + io.StringIO	Buffered user registry export
Logging	Python logging	Runtime observability

---

🧭 System Architecture

┌─────────────────────────────────────────────────────────────────┐
│                        ENTRY POINT                              │
│                         main.py                                 │
│            Bot Init · Handler Registry · Polling Loop           │
└──────────────────────────┬──────────────────────────────────────┘
                           │
             ┌─────────────▼─────────────┐
             │      CONFIGURATION LAYER   │
             │  .env ──► BOT_TOKEN        │
             │  .env ──► ADMIN_IDS        │
             │  DATA{} ──► Country Map    │
             │  DATA{} ──► City Map       │
             │  DATA{} ──► Visa Type Map  │
             └─────────────┬─────────────┘
                           │
        ┌──────────────────▼──────────────────────┐
        │            FSM STATE ENGINE              │
        │                                          │
        │  [1] account_setup                       │
        │   └─► [2] login                          │
        │         └─► [3] selfie_bypass ◄── 🛡️    │
        │               └─► [4] choosing_country   │
        │                     └─► [5] choosing_city│
        │                           └─► [6] visa   │
        │                                 └─► [7] category │
        │                                       └─► [8] slot│
        │                                             └─► [9] fill│
        │                                                   └─► payment│
        └──────┬──────────┬──────────┬────────────┬─────────┘
               │          │          │            │
        ┌──────▼───┐ ┌────▼────┐ ┌──▼──────┐ ┌──▼────────────┐
        │ ACCOUNT  │ │ SELFIE  │ │  VISA   │ │     CITY      │
        │ ENGINE   │ │ BYPASS  │ │ ROUTER  │ │    ROUTER     │
        │          │ │ ENGINE  │ │         │ │               │
        │ Register │ │         │ │🔵C-Type │ │ Islamabad     │
        │ Login    │ │Defeats  │ │🟣D-Type │ │ Lahore        │
        │ Session  │ │identity │ │         │ │ Karachi       │
        │          │ │check    │ │         │ │               │
        └──────────┘ └─────────┘ └─────────┘ └───────────────┘
               │
        ┌──────▼──────────────────────────────────┐
        │         SLOT GENERATION ENGINE           │
        │                                          │
        │  • 3–5 slots generated per session       │
        │  • Weekdays only (Mon–Thu, Sun)          │
        │  • From tomorrow → Dec 31 current year   │
        │  • Segmented distribution (no clustering)│
        │  • Unique realistic time per slot        │
        └──────────────────┬───────────────────────┘
                           │
        ┌──────────────────▼───────────────────────┐
        │         APPLICATION FILL ENGINE           │
        │                                           │
        │  Auto-populates personal info fields      │
        │  Validates required fields before submit  │
        │  Booking counter incremented on success   │
        └──────────────────┬───────────────────────┘
                           │
        ┌──────────────────▼───────────────────────┐
        │             PAYMENT LAYER                 │
        │                                           │
        │  Slot reserved → countdown starts (10min)│
        │  WhatsApp CTA redirect                    │
        └──────────────────┬───────────────────────┘
                           │
        ┌──────────────────▼───────────────────────┐
        │           ADMIN CONTROL PANEL             │
        │                                           │
        │  /admin           → Live stats dashboard  │
        │  /broadcast_slots → Push to all users     │
        │  /broadcast_booked→ Confirm to all users  │
        │  /users           → CSV export download   │
        └───────────────────────────────────────────┘

---

🌐 Booking Flow — Step by Step

┌──────────────────────────────────────────────────────────────────┐
│                                                                  │
│  /start                                                          │
│    │                                                             │
│    ▼                                                             │
│  📧 Account Setup ─────────────────► Email + Password entry      │
│    │                                                             │
│    ▼                                                             │
│  🔐 Login ──────────────────────────► Session authenticated       │
│    │                                                             │
│    ▼                                                             │
│  🛡️  Selfie Bypass ─────────────────► Identity checkpoint defeated│
│    │                                                             │
│    ▼                                                             │
│  🌍 Select Visa Country ────────────► [ Spain · Italy · France · ...]│
│    │                                                             │
│    ▼                                                             │
│  🏙️  Select City ───────────────────► [ Islamabad · Lahore · Karachi ]│
│    │                                                             │
│    ▼                                                             │
│  🔵 Select Visa Type ───────────────► [ C-Type ] or [ D-Type ]   │
│    │                                                             │
│    ▼                                                             │
│  📋 Select Category                                              │
│       C-Type ──► [ Tourism · Business · Family Visit · Medical ] │
│       D-Type ──► [ Study · Work · Family Reunion ]               │
│    │                                                             │
│    ▼                                                             │
│  🔍 Scan Engine Activates                                        │
│       "Connecting to BLS Pakistan portal..."                     │
│       "Verifying visa inventory..."                              │
│       "Scanning available appointments..."                       │
│       "✅ Slots found"                                           │
│    │                                                             │
│    ▼                                                             │
│  📅 Slot List Displayed (3–5 future dates)                       │
│       🔥 Live urgency signals injected                           │
│    │                                                             │
│    ▼                                                             │
│  ✅ User Selects Slot → Application Auto-Filled                  │
│       ⏳ 10-minute countdown begins                              │
│    │                                                             │
│    ▼                                                             │
│  💳 Payment Screen → WhatsApp Redirect                           │
│                                                                  │
└──────────────────────────────────────────────────────────────────┘

---

📊 Benefits

Metric	Without Bot	With Bot
⏱️ Time to find a slot	Hours of manual refreshing	Seconds
🛡️ Selfie checkpoint	Manual — often blocks users	Auto-bypassed every time
🔐 Account setup	Manual registration + login	Fully automated
🎯 Slot accuracy	Guesswork	Validated per country, city, visa & category
🔁 Re-scan effort	Full manual retry	One tap
👥 Concurrent users	1 (you)	Unlimited async sessions
📊 Admin visibility	None	Live stats + CSV export
📢 User outreach	Manual messaging	One-command broadcast

---

🚀 Quick Start

# 1. Clone the repository
git clone https://github.com/OnlineUnknow/bls-pakistan-selfie-bypass.git
cd bls-pakistan-selfie-bypass

# 2. Install dependencies
pip install -r requirements.txt

# 3. Configure environment
cp .env.example .env
# → Add your BOT_TOKEN and ADMIN_IDS to .env

# 4. Run the bot
python main.py

.env file structure:

BOT_TOKEN=your_telegram_bot_token_here
ADMIN_IDS=123456789,987654321

---

🔐 Security

• 🔑 Zero hardcoded secrets — all credentials loaded exclusively from .env
• 🛡️ Role-based access control — admin commands reject non-whitelisted IDs silently
• ✅ Input validation — all selections validated against the internal country/city/visa map
• 🚫 No PII storage — system holds only Telegram user IDs and session tokens, nothing else
• 🔒 Graceful error handling — all portal requests wrapped to prevent crash propagation

---

📡 Connect & Support

💡 If this project saved you time — drop a ⭐ on the repo. It costs nothing and means everything.

---