The ConnectX Engine is a sophisticated automation tool designed to streamline bulk messaging and real-time interactions on the WhatsApp Web platform. Developed as a core communication asset within the Codiom initiative, this project utilizes Selenium to manage complex browser-level events and dynamic DOM interactions.

As a Software Engineering student at Istanbul Aydın University, I architected this system to address the challenges of high-volume messaging, focusing on anti-detection patterns and high-reliability delivery protocols.

• ⚡ Automated Message Dispatch: Programmatic sending of text and media to targeted contact lists.
• 📂 Bulk Contact Management: Efficient handling of large-scale contact datasets for organized outreach.
• 🛠️ Stealth Interaction Logic: Integrated randomized wait-sequences to mimic human typing and browsing behavior, minimizing account risk.
• 📱 Headless Operations: Full support for headless browser execution for server-side automation tasks.
• 💾 Telemetry & Logging: Automated auditing of message status, delivery times, and execution logs.

The engine follows an Event-Driven Automation pattern, ensuring that each messaging task is validated before execution.

To maintain account integrity and avoid spam filters, the engine calculates adaptive delay intervals: $$T_{delay} = \mu_{base} + \text{rand}(0, \sigma)$$ This ensures that the interval between messages remains non-deterministic, effectively bypassing basic automation triggers.

.
├── 📄 main.py               # Application gateway and messaging loop
├── 📄 config.py             # Global settings and wait-time parameters
├── 📁 core/
│   ├── driver_manager.py    # Selenium initialization and profile handling
│   └── whatsapp_logic.py    # Specialized functions for message delivery
├── 📁 contacts/             # Targeted recipient datasets (.csv)
├── 📁 logs/                 # Detailed delivery and system audits
├── 📄 requirements.txt      # Dependency manifest
└── 📄 README.md             # Documentation Hub

Ensure you have a modern Chrome browser and the corresponding ChromeDriver installed and added to your system path.

# Clone the repository
git clone [https://github.com/BerattCelikk/Whatsapp_Bot_with_Selenium.git](https://github.com/BerattCelikk/Whatsapp_Bot_with_Selenium.git)
cd Whatsapp_Bot_with_Selenium

# Initialize virtual environment
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

Update the contacts/ directory with your recipient list and configure your message template in main.py.

python main.py

• AI-Driven Responses: Integrating LLMs (GPT-4) to handle automated incoming replies.
• Media Automation: Support for sending images, PDFs, and voice notes programmatically.
• Scheduling Engine: A robust cron-based scheduler for time-optimized message delivery.
• Multi-Session Support: Managing multiple WhatsApp profiles simultaneously for high-scale operations.