Skip to content

QUICK_START.md

Latest commit

 

History

History
103 lines (77 loc) · 2.32 KB

QUICK_START.md

File metadata and controls

103 lines (77 loc) · 2.32 KB

🚀 Quick Start Guide

Files Overview

  • main.py - Main WhatsApp bulk sender script
  • config.py - Configuration settings (delays, selectors, etc.)
  • contacts.csv - Sample CSV file with contact format
  • requirements.txt - Python dependencies
  • setup.py - Automated setup script
  • setup.bat - Windows setup script
  • setup.sh - Unix/Linux/Mac setup script
  • test_setup.py - Test script to verify installation
  • README.md - Comprehensive documentation

🏃‍♂️ Quick Setup (Choose One)

Option 1: Automated Setup (Recommended)

Windows:

setup.bat

Unix/Linux/Mac:

./setup.sh

Option 2: Manual Setup

  1. Install dependencies:
pip install -r requirements.txt
  1. Install Playwright browsers:
playwright install chromium
  1. Test setup:
python test_setup.py

📝 Usage

  1. Edit contacts.csv with your contacts:
PhoneNumber,Message,AttachmentPath
+1234567890,"Hello! This is a test message.",
+0987654321,"Hi! Please find attached file.",/path/to/file.jpg
  1. Run the script:
python main.py

  1. Scan QR code when WhatsApp Web opens

  2. Monitor progress in console and whatsapp_bulk_sender.log

⚙️ Configuration

Edit config.py to customize:

  • Message delays (30-90 seconds by default)
  • File size limits
  • Browser settings
  • CSS selectors

🔧 Troubleshooting

  • Dependencies missing? Run python test_setup.py
  • QR code timeout? Scan within 2 minutes
  • Invalid numbers? Use international format (+country_code_number)
  • Attachments failing? Check file paths and size limits

📊 Features

✅ Automated WhatsApp Web interaction
✅ CSV contact management
✅ File attachments (images, videos, PDFs)
✅ Human-like delays (30-90 seconds)
✅ Comprehensive logging
✅ Error handling and recovery
✅ Safe stop/resume capability

⚠️ Important Notes

  • Test with few contacts first
  • Comply with WhatsApp Terms of Service
  • Use responsibly and ethically
  • Keep backups of your data

🆘 Need Help?

  1. Check whatsapp_bulk_sender.log for detailed errors
  2. Run python test_setup.py to verify setup
  3. Read the full README.md for comprehensive documentation

Happy messaging! 📱✨