🤖 IS_Connect Bot

A Telegram bot designed to facilitate professional networking within the Information Science community by enabling users to share and discover LinkedIn profiles. Perfect for IS students, alumni, and faculty members.

✨ Features

Core Features

• 🔄 Share LinkedIn profiles with automatic data extraction
• 👥 View community members' profiles in a paginated format
• 📊 Get network statistics and insights
• 🔍 Search profiles by keywords
• 📱 User-friendly button interface

Advanced Features

• 📋 Export profiles to CSV (admin only)
• ⚡ Rate limiting to prevent spam
• 🔐 Profile management (update/delete)
• 🎯 Automatic profile data validation
• 📢 New member notifications

🛠 Technical Stack

• Framework: python-telegram-bot 20.3
• Database: PostgreSQL with SQLAlchemy
• API Integration: LinkedIn API for profile data extraction
• Authentication: Environment-based configuration
• Logging: Rotating file logs with structured formatting

🚀 Quick Start

1. Clone the Repository

   git clone https://github.com/Alph_Mintamir/IS-Connect.git
   cd is-connect-bot

2. Set Up Virtual Environment

   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   pip install -r requirements.txt

3. Configure Environment Create a .env file with:

   TELEGRAM_BOT_TOKEN=your_bot_token
   DB_HOST=localhost
   DB_PORT=5432
   DB_NAME=your_db_name
   DB_USER=your_db_user
   DB_PASSWORD=your_db_password
   LINKEDIN_USERNAME=your_linkedin_email
   LINKEDIN_PASSWORD=your_linkedin_password

4. Initialize Database

   python scripts/db_setup.py

5. Start the Bot

   python bot.py

💡 Usage

1. Start the Bot

   • Search for the bot on Telegram
   • Click "Start" or send /start
   • Use the main menu buttons to navigate

2. Add Your Profile

   • Click "➕ Add Profile"
   • Send your LinkedIn profile URL
   • Format: https://www.linkedin.com/in/username

3. View Community Members

   • Click "👥 View Users"
   • Browse through paginated profiles
   • Click profile links to view on LinkedIn

4. Manage Your Profile

   • "🔄 Update Profile": Modify your information
   • "❌ Delete Profile": Remove your profile

📝 Logging

Logs are stored in logs/bot.log:

• Maximum size: 1MB
• Backup count: 5 files
• Log level: INFO

🛡️ Security Features

• Rate limiting for spam prevention
• SQL injection protection via SQLAlchemy
• Input validation for LinkedIn URLs
• Secure environment variable management

🤝 Contributing

1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Open a Pull Request

📄 License

MIT License - see the LICENSE file for details.

👥 Support

For support, email Alphalencho4@gmail.com or open an issue in the repository.

---

Built with Python and ❤️ for the Information Systems Community