🚀 Client Catch Bot (v1.0)

Client Catch Bot is a professional Telegram-based solution designed for automated lead generation and business inquiry management. It streamlines the communication between service providers and potential clients by capturing project requirements and storing them securely.

---

✨ Key Features

• 🎯 Automated Lead Funnel: Guides users through a structured 4-step survey (Service -> Description -> Budget -> Timeline).
• 📊 Interactive Portfolio: A dedicated section to showcase your work using Inline buttons with external links.
• 🗄️ Database Integration: Every lead is automatically saved into a local leads.db file (SQLite).
• ⚡ Instant Notifications: The administrator receives a beautifully formatted HTML report as soon as a client submits a request.
• 🛠 Service Catalog: Detailed breakdown of your offerings (Web Dev, Bot Dev, Marketing) with pricing.
• 🔐 Secure Configuration: All sensitive API keys are managed through a protected environment file.

---

🔄 How the Bot Works (FSM Logic)

The bot uses a Finite State Machine to ensure a smooth user experience:

1. Start ⮕ User clicks /start and receives a professional greeting.
2. Navigation ⮕ User explores services, views the portfolio, or contacts the admin.
3. Lead Capture (Get a Quote) ⮕ User enters the data collection funnel:
   • Step 1: Selects a Service category.
   • Step 2: Provides Project Details.
   • Step 3: Specifies the Budget.
   • Step 4: Sets a desired Deadline.
4. Finalize ⮕ Data is saved to SQL, the admin is notified, and the user gets a success confirmation.

---

🛠 Tech Stack

• Language: Python 3.10+
• Framework: Aiogram 3.x (Modern Asynchronous Framework)
• Database: SQLite3
• Environment Management: Python-dotenv

---

🚀 Installation & Launch Guide

Follow these steps to get the bot running on any machine:

1. Setup Dependencies

Open your terminal in the project folder and run:

pip install aiogram python-dotenv

2. Configure Environment
Create a new file named .env in the root directory of the project.

3. Edit .env File
Open the .env file with any text editor and paste your credentials:
BOT_TOKEN=your_bot_father_token_here
ADMIN_ID=your_telegram_numeric_id_here

4.Launch
Start the bot by running the following command:
python main.py

👤 Developer
Volodymyr Telegram Bot Developer & Digital Entrepreneur 
Contact: @volodymyr_koval7