https://github.com/sage-rebirth/python-whatsapp-automation
This script automates sending WhatsApp messages to contacts listed in a CSV file using pywhatkit. It reads the message from a text file, logs all actions to both the console (with color) and a log file, and handles errors gracefully.
https://github.com/sage-rebirth/python-whatsapp-automation
automation python python-app python3 pywhatkit whatsapp whatsapp-automation whatsapp-web
Last synced: about 1 month ago
JSON representation
This script automates sending WhatsApp messages to contacts listed in a CSV file using pywhatkit. It reads the message from a text file, logs all actions to both the console (with color) and a log file, and handles errors gracefully.
- Host: GitHub
- URL: https://github.com/sage-rebirth/python-whatsapp-automation
- Owner: SAGE-Rebirth
- Created: 2025-05-14T10:08:34.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-14T10:12:47.000Z (about 1 year ago)
- Last Synced: 2025-05-14T11:29:21.510Z (about 1 year ago)
- Topics: automation, python, python-app, python3, pywhatkit, whatsapp, whatsapp-automation, whatsapp-web
- Language: Python
- Homepage:
- Size: 4.88 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# WhatsApp Automation with pywhatkit
## Table of Contents
- [Features](#features)
- [Project Structure](#project-structure)
- [Prerequisites](#prerequisites)
- [Setup Instructions](#setup-instructions)
- [Notes](#notes)
- [Troubleshooting](#troubleshooting)
- [License](#license)
## Features
- Send WhatsApp messages to a list of contacts from a CSV file
- Message content is loaded from a text file (`message/send.txt`)
- Robust error handling and logging (console + file)
- Colorized logs in the console using `colorama`
- Easy to configure and extend
## Project Structure
```
├── app.py # Main automation script
├── requirements.txt # Python dependencies
├── automation.log # Log file (auto-generated)
├── uploads/
│ └── contacts.csv # Contacts CSV (Name, Phone)
├── message/
│ └── send.txt # Message to send
```
## Prerequisites
- Python 3.8+
- Google Chrome browser (required by pywhatkit)
- WhatsApp Web account (logged in on Chrome)
## Setup Instructions
1. **Clone the repository**
```cmd
git clone
cd py-whatsapp
```
2. **Create and activate a virtual environment (optional but recommended)**
```cmd
python -m venv gui-env
gui-env\Scripts\activate
```
3. **Install dependencies**
```cmd
pip install -r requirements.txt
```
4. **Prepare your contacts CSV**
- Place your contacts in `uploads/contacts.csv` with columns: `Name`, `Phone` (phone numbers in international format, e.g., `+1234567890`).
5. **Write your message**
- Edit `message/send.txt` and write the message you want to send.
6. **Run the automation**
```cmd
python app.py
```
- The script will open WhatsApp Web in Chrome and send the message to each contact.
- All logs will be shown in the console and saved to `automation.log`.
## Notes
- Make sure you are logged into WhatsApp Web in Chrome before running the script.
- The script waits a few seconds between messages to avoid spamming.
- Only phone numbers in international format (starting with `+`) will be processed.
## Troubleshooting
- If you encounter issues with Chrome or WhatsApp Web, ensure Chrome is installed and up to date.
- Check `automation.log` for detailed error messages.
## License
This project is for educational and personal automation use only.