💬 WhatsApp Pro Automation Suite

A modern, elegant, and feature-rich WhatsApp broadcast automation & messaging desktop application built with CustomTkinter & Python.

---

✨ Features

• 🎨 Luxury Glassmorphism UI: High-end translucent cards, custom wallpaper themes (Emerald Glow, Chat Bubbles Dark/Light), dark & light appearance modes, and vibrant typography.
• 🚀 Smart Broadcast & Scheduling:
  • Send personalized messages instantly to multiple contacts or one direct recipient.
  • Schedule delivery for exact hours and minutes, or use quick-add chips (+5m, +15m, +1h).
  • Personalization tags: 👤 {name}, 📅 {date}, ⏰ {time}.
  • Template snippets library for quick message composition.
• 🎭 Rich Media & Stickers Engine:
  • Built-in expandable Emoji Tray (Smileys, Gestures, Hearts, Celebration, Work/Symbols).
  • Built-in Stickers & Animated GIFs Library with preset browser.
  • Send custom attachments (.webp, .gif, .png, .jpg, .jpeg) with captions.
• 👥 Advanced Contact Manager:
  • Categorize contacts into custom groups (VIP, Clients, Friends, General).
  • Search and filter contacts in real time.
  • CSV Import and Export with one click.
  • Dynamic avatar initial badges with distinct color palettes.
• 🛡️ Anti-Ban Safety Engine:
  • Configurable inter-message anti-ban random delays.
  • Configurable page load wait times.
  • Automatic browser tab closure after dispatch.
• 📜 Live Delivery Feed & Analytics:
  • Metric summary cards: Total Logs, Delivered, Failed, and Success Rate (%).
  • Searchable delivery logs with status badges and error diagnostic messages.
  • Export delivery history to CSV.

---

📸 Overview of Tabs

Tab	Purpose
🚀 Send & Broadcast	Multi-recipient selection, message composer, template insert, emoji & sticker picker, time scheduling, and live progress bar.
👥 Contact Directory	Contact CRUD operations, group management, CSV import/export, and search.
📜 Delivery Feed	Real-time broadcast logs, analytics metrics, and delivery status audits.
⚙️ Preferences	Theme switching, wallpaper selection, default country code, safety delays, and browser rules.

---

🚀 Getting Started

1. Prerequisites

• Python 3.9+ installed on your system.
• Google Chrome (or Chromium-based browser) logged into WhatsApp Web.

2. Installation

1. Clone or download this repository:

   git clone https://github.com/your-username/whatsApp_msgbot.py.git
   cd whatsApp_msgbot.py

2. (Optional) Create and activate a virtual environment:

   # Windows (PowerShell)
   python -m venv .venv
   .\.venv\Scripts\Activate.ps1

3. Install the required Python dependencies:

   pip install customtkinter pillow pywhatkit

3. Launch the Application

Run the application:

python msg_sent.py

Note: On your first dispatch, your default browser will open WhatsApp Web. Ensure you are already logged into WhatsApp Web on your browser.

---

📁 Project Structure

whatsApp_msg.py/
├── msg_sent.py           # Main application source code & GUI
├── Contacts.json         # Persisted contact list storage
├── History.json          # Persisted delivery log history
├── Settings.json         # User settings & preferences storage
├── background.jpg        # Emerald Glow wallpaper
├── bg_dark.jpg           # Dark Chat Bubbles wallpaper
├── img.png               # Light Chat Bubbles wallpaper
├── stickers/             # Preset stickers and animated GIF library
│   ├── celebrate.png
│   ├── heart_pulse.gif
│   └── thumbs_up.png
├── README.md             # Project documentation
└── LICENSE               # MIT License

---

🛡️ Anti-Ban Best Practices

1. Avoid spamming: Only send messages to recipients who have agreed to receive communication from you.
2. Use Anti-Ban Delays: Keep the Inter-Message Delay setting at 5–15 seconds to mimic organic messaging behavior.
3. Personalize Content: Use {name} and varied template wording to avoid sending identical bulk messages.
4. Gradual Scaling: Warm up new numbers gradually before sending to large contact lists.

---

📄 License

This project is licensed under the MIT License. Feel free to use, modify, and distribute according to the terms.