WhatsApp Bot is a Python-based application that allows you to send WhatsApp messages using the Twilio API. The bot supports both immediate message delivery and scheduled message sending for future dates and times.
Available in two versions:
- Web Dashboard (Modern UI) - Recommended ⭐
- CLI Interface (Terminal) - Simple & Quick
- ✅ Send WhatsApp messages instantly
- ✅ Schedule messages for future delivery
- ✅ Beautiful web dashboard interface
- ✅ User-friendly command-line interface
- ✅ Secure credential management with environment variables
- ✅ Error handling for failed messages
- ✅ Support for multiple recipients
- ✅ Real-time feedback and notifications
Sensitive credentials are stored in .env file and excluded from version control via .gitignore.
- 🔜 Database support for message history
- 🔜 Batch message sending
- 🔜 Message templates
- 🔜 Web UI dashboard
- 🔜 Webhook support for incoming messages
- 🔜 Advanced scheduling options (recurring messages)
- 🔜 Message delivery status tracking
- 🔜 Multi-user support
- Python 3.7+
- Twilio account with WhatsApp sandbox enabled
- pip (Python package manager)
- Clone the repository
git clone <repository-url>
cd WhatsappBot- Create a virtual environment
python -m venv .venv
.venv\Scripts\activate- Install dependencies
pip install -r requirements.txt- Set up environment variables
Create a
.envfile in the project root:
TWILIO_ACCOUNT_SID=your_account_sid_here
TWILIO_AUTH_TOKEN=your_auth_token_here
Run the application:
python main.pyFollow the prompts to:
- Enter recipient name
- Enter WhatsApp number (with country code)
- Enter message content
- Choose to send now or schedule for later
twilio- Twilio SDKpython-dotenv- Environment variable managementflask- Web framework for dashboard
- None currently documented
This project is open source and available under the MIT License.
Created by Debashish Kashyap
For issues or questions, please open an issue in the repository.
Last Updated: December 5, 2025