A professional, human-like Telegram Support automation system built using Telethon. Designed for business lead generation and client management.

• Auto-Reply: Automatically greets and interviews new clients.
• Human Simulation: Random delays and typing indicators to avoid robotic behavior.
• Lead Detection: Automatically qualifies leads and notifies the owner.
• State Management: Tracks conversation flow (Service -> Deadline -> Budget).
• Admin Panel: Control stats, broadcast messages, and blacklist users from the owner account.
• SQLite Database: Persistent storage for users, messages, and leads.

• Python 3.8+
• Telethon (Telegram User API)
• aiosqlite (Async SQLite)
• python-dotenv

project/
│
├── main.py                # Entry point
├── config.json            # Message templates and settings
├── database.db            # SQLite database (auto-generated)
├── requirements.txt       # Dependencies
├── .env                   # API credentials (manual setup)
├── handlers/              # Logic handlers
│   ├── message_handler.py # Conversation logic
│   └── admin_handler.py   # Owner commands
├── database/              # Database manager
├── utils/                 # Helpers and logger
├── sessions/              # Telethon session files
└── logs/                  # System logs

• Python 3.8 or higher.
• API ID and API Hash from my.telegram.org.

1. Clone or download this project.
2. Open terminal in the project directory.
3. Install dependencies:

   pip install -r requirements.txt

1. Rename .env.example to .env.
2. Fill in your API_ID, API_HASH, and OWNER_ID.
3. (Optional) Customize config.json for your specific business tone.

python main.py

Note: On the first run, you will be prompted to enter your phone number and the OTP sent to your Telegram account to create the session.

• /stats - View total users and qualified leads.
• /broadcast <message> - Send a message to all users in the database.
• /blacklist <user_id> - Block a user from the auto-reply system.
• /whitelist <user_id> - Unblock a user.
• /help - View all commands.

• This system uses a real Telegram account. Avoid excessive broadcasting to prevent account limitations.
• The config.json includes delays to simulate human typing. Do not reduce these too much.