OctoBot is a WhatsApp messaging automation tool that streamlines your communication workflow. Built with Python, PyQt6 and Selenium. It seamlessly integrates with WhatsApp Web to send personalized messages to multiple contacts from your Excel spreadsheets.
- 📊 Excel Integration - Import contacts directly from Excel files
- 🤖 Automated Messaging - Send bulk messages effortlessly through WhatsApp Web
- 🎨 Modern GUI - Clean, intuitive interface built with PyQt6
- 🌍 Multi-language Support - Available in English, Russian, and Azerbaijani
- ⚡ Fast & Reliable - Efficient message delivery with smart queue management
The first pre-built package is now released! 🎉 You can find the release here.
# Install dependencies
pip install -r requirements.txt
# Launch the application
python src/app.py# Update translation files with new strings
make update-translations
# Compile all translation files (.ts → .qm)
make compile-translations
# Clean compiled translation files
make clean
# Convert .ui files to .py
make convertOctoBot speaks your language:
| Language | Status | Code |
|---|---|---|
| 🇬🇧 English | Default | en |
| 🇷🇺 Russian | Complete | ru |
| 🇦🇿 Azerbaijani | Complete | az |
Contributions are welcome! Feel free to:
- 🐛 Report bugs
- 💡 Suggest new features
- 🔧 Submit pull requests
- 📖 Improve documentation
This tool is intended for legitimate communication purposes only. Please ensure you:
- Have consent from recipients before sending messages
- Comply with WhatsApp's Terms of Service
- Follow local regulations regarding automated messaging
- Use responsibly and ethically
This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.
⭐ Star us on GitHub if you find this project helpful!