WhatsApp Bulk Sender - Professional Edition

A user-friendly GUI application for sending bulk WhatsApp messages with professional templates, built with Flet and Playwright.

Features

🚀 Main Features

• User-Friendly GUI: No technical knowledge required
• Professional Message Templates: Pre-built templates for various use cases
• Bulk Messaging: Send to multiple contacts at once
• Attachment Support: Send images, documents, and other files
• Speed Control: Adjustable sending speed to avoid blocks
• Contact Management: Add contacts manually or import from CSV
• Real-time Progress: Live status updates and progress tracking

📱 Message Templates

• Placement Announcements: Professional placement congratulations
• Course Promotions: Educational course marketing
• Event Invitations: Professional event invites
• Offer Announcements: Special offers and promotions

Installation

1. Clone or download this repository
2. Install dependencies:

   # Run the installation script
   install.bat
   
   # Or manually install
   pip install -r requirements.txt

Usage

Quick Start

1. Run the launcher:

   python launcher.py

2. Choose your tool:

   • Message Generator: Create professional message templates
   • Bulk Sender: Send messages to multiple contacts

Using Message Generator

1. Select a template type
2. Fill in the required fields
3. Add candidates (for placement templates)
4. Preview your message
5. Save to WhatsApp Sender

Using Bulk Sender

1. Add your message: Type or paste your message
2. Add attachment (optional): Browse and select a file
3. Add contacts:
   • Manually add phone numbers
   • Or load from CSV file
4. Adjust speed: Use the slider to control sending speed
5. Start sending: Click "Start Sending"
6. Scan QR code: When prompted, scan the QR code in the browser
7. Monitor progress: Watch real-time status updates

File Structure

bulk_wa_sender/
├── launcher.py              # Main launcher application
├── whatsapp_gui.py         # WhatsApp bulk sender GUI
├── message_generator.py    # Professional message template generator
├── main.py                 # Core WhatsApp automation logic
├── config.py              # Configuration settings
├── contacts.csv           # Contact list (auto-generated)
├── requirements.txt       # Python dependencies
├── install.bat           # Installation script
└── README.md             # This file

Configuration

The application automatically manages configuration, but you can modify config.py for advanced settings:

• MIN_DELAY_SECONDS: Minimum delay between messages
• MAX_DELAY_SECONDS: Maximum delay between messages
• GLOBAL_MESSAGE: Default message template
• GLOBAL_ATTACHMENT_PATH: Default attachment path

CSV Format

For bulk contact import, use this CSV format:

PhoneNumber
+919876543210
+919876543211
+919876543212

Tips for Success

🔥 Best Practices

1. Start Small: Test with a few contacts first
2. Use Realistic Delays: 6-12 seconds between messages
3. Keep Browser Open: Don't close WhatsApp Web during sending
4. Monitor for Blocks: Watch for any WhatsApp restrictions
5. Professional Messages: Use the template generator for better results

⚠️ Important Notes

• Keep WhatsApp Web browser window open during operation
• Don't send too many messages too quickly (risk of being blocked)
• Use proper phone number format with country code (+91 for India)
• Test with a small group before bulk sending
• Respect WhatsApp's terms of service

Professional Message Examples

Placement Announcement

🎓 Heartiest Congratulations!

*AMAZING PLACEMENT - 2025*

*Dinesh S*
SDE Intern | Amazon
Package: 47 LPA

*Irfan Ahamed S*
SDE Intern | Amazon
Package: 47 LPA

*VSB Engineering College*

For admission details, contact us now!

Course Promotion

🚀 *NEW BATCH STARTING SOON!*

📚 Python Full Stack Development
⏰ Starting: August 15, 2025
💰 Fee: ₹25,000

✅ Limited seats available
✅ Placement assistance

Register now! 📞

Troubleshooting

Common Issues

1. QR Code Not Appearing

   • Refresh the browser
   • Clear browser cache
   • Try incognito mode

2. Messages Not Sending

   • Check internet connection
   • Verify phone numbers format
   • Ensure WhatsApp Web is logged in

3. Application Not Starting

   • Run pip install -r requirements.txt
   • Check Python version (3.8+ required)
   • Verify all files are present

4. Attachment Upload Fails

   • Check file size (max 100MB)
   • Verify file path exists
   • Use supported formats

Getting Help

If you encounter issues:

1. Check the console output for error messages
2. Verify all dependencies are installed
3. Ensure WhatsApp Web is accessible
4. Try with a smaller contact list first

Legal Disclaimer

This tool is for educational and legitimate business purposes only. Users are responsible for:

• Complying with WhatsApp's Terms of Service
• Respecting recipient privacy and consent
• Following local laws and regulations
• Not using for spam or harassment

Version History

• v1.0: Initial release with basic functionality
• v2.0: Added Flet GUI interface
• v2.1: Added professional message templates
• v2.2: Enhanced user experience and error handling

---

© 2025 WhatsApp Bulk Sender - Professional Edition

Built with ❤️ for legitimate business communication