whatsapp-watcherlisted

# WhatsApp Watcher Monitor WhatsApp Web for urgent messages containing specific keywords, automatically creating action files in the vault for immediate processing. ## Overview This skill uses Playwright to automate WhatsApp Web, monitoring for urgent messages that contain keywords like "urgent", "asap", "invoice", "payment", or "help". When detected, it creates action files for Claude to process. ## Usage ```bash # Start the WhatsApp watcher python scripts/whatsapp_watcher.py # Test mode (dry run) python scripts/whatsapp_watcher.py --test # Custom check interval (seconds) python scripts/whatsapp_watcher.py --interval 30 ``` ## What It Does 1. **Monitors WhatsApp Web** using Playwright automation 2. **Scans unread chats** for urgent keywords 3. **Creates action files** in `/Needs_Action/WHATSAPP_*.md` 4. **Preserves session** for continuous monitoring 5. **Logs all activity** to `/Logs/whatsapp_watcher.log` ## Prerequisites ### Install Playwright ```bash # Install Playwright pip install playwright # Install browser binaries playwright install chromium ``` ### First Run Setup ```bash # First run will open WhatsApp Web for QR code scan python scripts/whatsapp_watcher.py --setup # Scan QR code with your phone # Session will be saved for future runs ``` ## Configuration ### Environment Variables ```bash # .env file WHATSAPP_SESSION_PATH=./whatsapp_session VAULT_PATH=./AI_Employee_Vault CHECK_INTERVAL=30 # seconds HEADLESS=true # Run browser in background ```