🤖 Portfolio Telegram Bot

An interactive Telegram bot built with Python and Aiogram 3, designed for web developers and freelancers to showcase their portfolio, services, and capture client leads directly into an admin chat.

---

📁 Project Structure

bot.py — Main entry point, handlers, and polling initialization.

• config.py — Environment configuration and configuration validation.
• data.py — Static profile information, services description, and FAQ data.
• keyboards.py — Inline keyboard layouts and pagination helpers.
• states.py — FSM states definition for the lead collection form.
• requirements.txt — Project dependencies list.

---

✨ Features

• Interactive Menu: Quick navigation between profile details, services, portfolio, FAQ, and contacts.
• Dynamic Portfolio Browser: Inline pagination to flip through project case studies smoothly.
• Lead Intake Form: A multi-step questionnaire using Finite State Machine (FSM) to collect project type, budget, deadline, and description.
• Admin Notifications: Instantly sends structured client leads to the developer's private Telegram chat.

---

🛠 Tech Stack

• Language: Python 3.10+
• Framework: aiogram (v3.13.1) — asynchronous Telegram Bot API framework.
• Configuration: python-dotenv for secure environment variable management.

---

1. Configure Environment Variables

Create a .env file in the root directory of the project and add your credentials:

BOT_TOKEN=your_telegram_bot_token_here
ADMIN_ID=your_telegram_user_id_here

2. Install Dependencies

pip install -r requirements.txt

3. Run the Bot

python bot.py

4. Clone the Repository

git clone [https://github.com/xelturon/portfolio_bot.git](https://github.com/xelturon/portfolio_bot.git)
cd portfolio_bot