🍷 Telegram Dating Bot

A full-featured, premium Dating Bot for Telegram built with Node.js, Telegraf, and MongoDB. This bot provides a seamless Tinder-like experience directly within Telegram, complete with profile creation, matching algorithms, monetization via Telegram Stars, and safety features.

---

📱 Demo

App demo video: profile creation and matching flow

Profile Creation	Swiping & Matching	Premium Features
Sending a message	Swiping and getting a match	Buying more swipes with Stars

Swipe, match, and explore premium features

---

✨ Features

👤 User Profiles

• Comprehensive Setup: Users can set their Name, Age, Gender, Bio, and upload 2-3 Photos.
• Preferences: Users specify who they are looking for (Men/Women) and their intention (Serious, Casual, Friendship, Exploring).
• Profile Management: Easy-to-use commands to View (/profile), Edit (/edit), or Delete (/delete) profiles.

💘 Matching System

• Smart Queue: Shows candidates based on gender preferences and excludes already seen profiles.
• Bidirectional Matching: A match is only created when both users like each other.
• Direct Messaging: Users can send a message directly to a candidate, which also counts as a "Like".
• Notifications: Instant notifications for Likes and Matches.

💰 Monetization (Telegram Stars)

• Daily Limits: Users get 20 free swipes every day.
• In-App Purchases: Integrated with Telegram Stars for seamless payments.
  • 40 Swipes: 4 Stars
  • 80 Swipes: 10 Stars
• Revenue Generation: Ready-to-deploy monetization strategy.

🛡️ Safety & Moderation

• Reporting System: Users can report inappropriate profiles directly from the card view.
• Privacy First: Usernames are only revealed after a mutual match.
• Block Handling: Graceful handling of users who block the bot.

---

🛠️ Tech Stack

• Runtime: Node.js
• Framework: Telegraf (Telegram Bot API)
• Database: MongoDB (Atlas recommended)
• Payments: Telegram Stars (XTR)

---

🚀 Installation

Prerequisites

• Node.js (v16 or higher)
• MongoDB Connection URI
• Telegram Bot Token (from @BotFather)

Steps

1. Clone the repository

   git clone https://github.com/Eul45/telegram-connect-bot.git
   cd telegram-connect-bot

2. Install dependencies

   npm install

3. Configure Environment Variables Create a .env file in the root directory and add your credentials:

   # Telegram Bot Token from BotFather
   BOT_TOKEN=your_bot_token_here
   
   # MongoDB Connection String
   MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net/datingbot

4. Start the Bot

   npm start

📖 Usage Commands

Command	Description
/start	Initialize the bot and see the welcome message.
/create	Start the profile creation wizard.
/match	Start swiping and finding matches.
/profile	View your own profile as others see it.
/edit	Edit specific parts of your profile (Photos, Bio, etc.).
/matches	View your mutual matches and people who liked you.
/delete	Permanently delete your profile and data.
/help	View safety tips and information.

📂 Project Structure

telegram-dating-bot/
├── index.js           # Main bot logic and entry point
├── package.json       # Dependencies and scripts
├── .env               # Environment variables
└── README.md          # Project documentation

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the project
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

This project is licensed under the ISC License.