{"id":28143456,"url":"https://github.com/sage-rebirth/python-whatsapp-automation","last_synced_at":"2026-04-29T17:01:37.879Z","repository":{"id":293238150,"uuid":"983391434","full_name":"SAGE-Rebirth/python-whatsapp-automation","owner":"SAGE-Rebirth","description":"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.","archived":false,"fork":false,"pushed_at":"2025-05-14T10:12:47.000Z","size":5,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-14T11:29:21.510Z","etag":null,"topics":["automation","python","python-app","python3","pywhatkit","whatsapp","whatsapp-automation","whatsapp-web"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SAGE-Rebirth.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-14T10:08:34.000Z","updated_at":"2025-05-14T10:17:11.000Z","dependencies_parsed_at":"2025-05-14T11:29:23.562Z","dependency_job_id":"741ac608-0787-46fd-80b5-9dd315739fa8","html_url":"https://github.com/SAGE-Rebirth/python-whatsapp-automation","commit_stats":null,"previous_names":["sage-rebirth/python-whatsapp-automation"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SAGE-Rebirth%2Fpython-whatsapp-automation","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SAGE-Rebirth%2Fpython-whatsapp-automation/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SAGE-Rebirth%2Fpython-whatsapp-automation/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SAGE-Rebirth%2Fpython-whatsapp-automation/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SAGE-Rebirth","download_url":"https://codeload.github.com/SAGE-Rebirth/python-whatsapp-automation/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254227589,"owners_count":22035675,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","python","python-app","python3","pywhatkit","whatsapp","whatsapp-automation","whatsapp-web"],"created_at":"2025-05-14T21:18:14.563Z","updated_at":"2026-04-29T17:01:37.755Z","avatar_url":"https://github.com/SAGE-Rebirth.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WhatsApp Automation with pywhatkit\n\n## Table of Contents\n- [Features](#features)\n- [Project Structure](#project-structure)\n- [Prerequisites](#prerequisites)\n- [Setup Instructions](#setup-instructions)\n- [Notes](#notes)\n- [Troubleshooting](#troubleshooting)\n- [License](#license)\n\n## Features\n- Send WhatsApp messages to a list of contacts from a CSV file\n- Message content is loaded from a text file (`message/send.txt`)\n- Robust error handling and logging (console + file)\n- Colorized logs in the console using `colorama`\n- Easy to configure and extend\n\n## Project Structure\n```\n├── app.py                # Main automation script\n├── requirements.txt      # Python dependencies\n├── automation.log        # Log file (auto-generated)\n├── uploads/\n│   └── contacts.csv      # Contacts CSV (Name, Phone)\n├── message/\n│   └── send.txt          # Message to send\n```\n\n## Prerequisites\n- Python 3.8+\n- Google Chrome browser (required by pywhatkit)\n- WhatsApp Web account (logged in on Chrome)\n\n## Setup Instructions\n\n1. **Clone the repository**\n   ```cmd\n   git clone \u003cyour-repo-url\u003e\n   cd py-whatsapp\n   ```\n\n2. **Create and activate a virtual environment (optional but recommended)**\n   ```cmd\n   python -m venv gui-env\n   gui-env\\Scripts\\activate\n   ```\n\n3. **Install dependencies**\n   ```cmd\n   pip install -r requirements.txt\n   ```\n\n4. **Prepare your contacts CSV**\n   - Place your contacts in `uploads/contacts.csv` with columns: `Name`, `Phone` (phone numbers in international format, e.g., `+1234567890`).\n\n5. **Write your message**\n   - Edit `message/send.txt` and write the message you want to send.\n\n6. **Run the automation**\n   ```cmd\n   python app.py\n   ```\n   - The script will open WhatsApp Web in Chrome and send the message to each contact.\n   - All logs will be shown in the console and saved to `automation.log`.\n\n## Notes\n- Make sure you are logged into WhatsApp Web in Chrome before running the script.\n- The script waits a few seconds between messages to avoid spamming.\n- Only phone numbers in international format (starting with `+`) will be processed.\n\n## Troubleshooting\n- If you encounter issues with Chrome or WhatsApp Web, ensure Chrome is installed and up to date.\n- Check `automation.log` for detailed error messages.\n\n## License\nThis project is for educational and personal automation use only.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsage-rebirth%2Fpython-whatsapp-automation","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsage-rebirth%2Fpython-whatsapp-automation","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsage-rebirth%2Fpython-whatsapp-automation/lists"}