Summary

Neural-WA-Broadcaster is a Python-based WhatsApp automation tool designed for undetectable bulk messaging. It targets businesses and community managers needing to communicate with large audiences, offering a safer alternative to basic spam scripts by mimicking human behavior to avoid account bans.

How It Works

The tool orchestrates WhatsApp Web using PyAutoGUI and Selenium. It processes user-defined configurations (JSON/YAML) for contacts and message templates. A queue manager feeds messages to a human behavior simulator, which applies randomized delays and typing speeds. A safety watchdog monitors for anti-spam patterns, adjusting pacing dynamically. This approach aims to make bulk messaging appear natural, mitigating detection risks.

Quick Start & Requirements

• Install: Clone the repository, then run pip install -r requirements.txt.
• Run: Execute python whatsapp_mass_messenger.py with appropriate arguments (e.g., --contacts, --profile, --dry-run).
• Prerequisites: Python 3.8+, Windows/macOS/Linux, WhatsApp Web account, basic command-line familiarity. macOS requires Accessibility permissions; Ubuntu may need xdotool and xclip.
• Links: Documentation, Community Forum, and Video Tutorials are available within the tool's ecosystem.

Highlighted Details

• Supports sending to 10,000+ contacts.
• Features human-like interaction simulation (randomized delays, typing speed).
• Includes rate limit protection and anti-ban heuristics with 12+ safety checks.
• Offers OpenAI and Claude API integration for AI-powered message personalization.
• Supports multimedia attachments, multiple contact sources (CSV, Excel, etc.), and scheduled campaigns.
• Provides campaign analytics, automatic session recovery, and A/B testing.

Maintenance & Community

The project offers 24/7 customer support via an active community forum and email support. Specific details on core maintainers, sponsorships, or a public roadmap are not detailed in the README.

Licensing & Compatibility

Licensed under the MIT License, permitting free use, modification, and distribution, including integration into commercial projects. Attribution is appreciated but not mandatory. No warranty is provided.

Limitations & Caveats

iOS/iPadOS are not supported. Android (Termux) integration is experimental. Users bear full responsibility for adhering to WhatsApp's Terms of Service and relevant anti-spam legislation; the developers disclaim liability for account suspensions due to misuse. Best practices emphasize obtaining recipient consent.