{"id":26771793,"url":"https://github.com/the-real-virus/whatsapp-bot","last_synced_at":"2026-04-09T09:36:50.690Z","repository":{"id":285003793,"uuid":"956771789","full_name":"The-Real-Virus/Whatsapp-Bot","owner":"The-Real-Virus","description":"An advanced Python script that automates sending WhatsApp messages using pywhatkit. It allows users to send text, images, or videos to multiple contacts, with scheduled or instant delivery.","archived":false,"fork":false,"pushed_at":"2025-03-28T20:49:24.000Z","size":0,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-28T21:31:41.800Z","etag":null,"topics":["ai","automation","bash","bot","coding","ctf","cyber-security","ethical-hacking","github","linux","networking","open-source","pentesting","programming","python","readteam","scripting","software","tools","whatsapp"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/The-Real-Virus.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2025-03-28T20:46:48.000Z","updated_at":"2025-03-28T20:51:44.000Z","dependencies_parsed_at":"2025-03-28T21:31:44.779Z","dependency_job_id":"8776ac07-5e99-4434-a594-e0d9cb3f9ab3","html_url":"https://github.com/The-Real-Virus/Whatsapp-Bot","commit_stats":null,"previous_names":["the-real-virus/whatsapp-bot"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/The-Real-Virus%2FWhatsapp-Bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/The-Real-Virus%2FWhatsapp-Bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/The-Real-Virus%2FWhatsapp-Bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/The-Real-Virus%2FWhatsapp-Bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/The-Real-Virus","download_url":"https://codeload.github.com/The-Real-Virus/Whatsapp-Bot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246117898,"owners_count":20726091,"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":["ai","automation","bash","bot","coding","ctf","cyber-security","ethical-hacking","github","linux","networking","open-source","pentesting","programming","python","readteam","scripting","software","tools","whatsapp"],"created_at":"2025-03-29T00:19:32.741Z","updated_at":"2025-12-30T23:19:10.990Z","avatar_url":"https://github.com/The-Real-Virus.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 💀Whatsapp-Bot💀\n\n## 📜 Description  \n\nThis script automates WhatsApp Web messaging using the `pywhatkit` library. It supports:  \n✔ **Bulk messaging** (send to multiple contacts).  \n✔ **Scheduled or instant messages**.  \n✔ **Custom intervals \u0026 repetitions**.  \n✔ **Media support** (images \u0026 videos).  \n✔ **CSV import** (upload contact lists).  \n\nIt’s designed for automation, making it perfect for reminders, notifications, or announcements!  \n\n## 🚀Step-by-Step Guide in Linux Terminal !\n\nStep 1: Update \u0026 upgrade your system  \n\u003esudo apt update  \n\n\u003esudo apt upgrade  \n\nStep 2: install Dependencies  \n\u003epip install pywhatkit --break-system-packages  \n\n\u003esudo apt install python3-pandas  \n\nStep 3: Clone the repository  \n\u003egit clone https://github.com/The-Real-Virus/Whatsapp-Bot.git  \n\nStep 4: Go to the Tool Directory where u clone it  \n\u003ecd Whatsapp-Bot  \n\nStep 5: After Completing the process now u can run script  \n\u003epython3 bot.py  \n\n## 🔑 Features  \n\n✅ **Bulk messaging** → Send to multiple contacts.  \n✅ **Schedule messages** → Set delivery time per contact.  \n✅ **Send images/videos** → Automate media sharing.  \n✅ **Instant messaging option** → Send right away.  \n✅ **Custom intervals \u0026 repetitions** → Avoid spam detection.  \n✅ **CSV file support** → Load contact lists easily.  \n✅ **Error handling** → Prevents crashes \u0026 invalid inputs.  \n\n---\n\n## 💡 Tips !  \n\n- Ensure your **WhatsApp Web is logged in** before running the script.  \n- Use **international format** (`+1234567890`) for phone numbers.  \n- If using **CSV**, make sure it contains a `Phone` column.  \n- **For bulk messaging**, use `sendwhatmsg_instantly()` to avoid long scheduling delays.  \n- To send **group messages**, use `sendwhatmsg_to_group()`.  \n\n---\n\n## 🤝 Follow the Prompts !  \n\n### 1️⃣ **Run the Script:**  \n\n### 2️⃣ **Choose Contacts:**\n✔ Manually enter numbers **or**  \n✔ Upload a CSV file with contacts  \n\n### 3️⃣ **Select Message Type:**  \n✔ **Text Message**  \n✔ **Image or Video Message**  \n\n### 4️⃣ **Schedule or Send Instantly:**  \n✔ Choose time for each contact **or**  \n✔ Send instantly with custom delay  \n\n---\n\n## ⚙️ Troubleshooting  \n\n**Issue** | **Solution**  \n--- | ---  \nMessage not sending? | Ensure WhatsApp Web is open and logged in.  \nLong delay before sending? | Use `sendwhatmsg_instantly()` instead of `sendwhatmsg()`.  \nError reading CSV? | Ensure the file contains a **\"Phone\"** column with valid numbers.  \nInvalid phone number? | Use **+country_code** (e.g., `+1234567890`).  \nScript exits unexpectedly? | Check for missing dependencies (`pip install pywhatkit pandas`).  \n\n---\n\n## 🛠️MODIFICATION \n\nIF U WANT TO MODIFY OR USE THE SCRIPT IN UR PROJECTs , CONSIDER GIVING CREDITS !  \n\n## 📂 Example Output  \n\n\t```\n\t📞 Enter phone numbers (or type 'done' to finish):  \n\t+1234567890  \n\t+9876543210  \n\tdone  \n\n\tEnter the message: Hello! This is an automated test message.  \n\t⏰ Enter the hour (24-hour format, e.g., 14 for 2 PM): 15  \n\tEnter the minute: 30  \n\tEnter number of repetitions: 3  \n\tEnter time interval (in seconds): 10  \n\n\t📤 Sending messages...  \n\t📨 Sending to +1234567890 (Message 1/3)...  \n\t✅ Message sent successfully!  \n\t📨 Sending to +9876543210 (Message 1/3)...  \n\t✅ Message sent successfully!  \n\t```\n\n# ⚠️Disclaimer !\nThis tool is intended for ethical and educational use only.  \nDo not use it for illegal activities. The author is not responsible for any misuse.  \nThis script is intended for educational purposes and authorized testing only.  \nUnauthorized use of this script is illegal and unethical.  \nEnsure you have explicit permission before testing any system.  \n- Obtain explicit permission before testing any system.  \n- Adhere to all applicable laws and regulations.  \n- Respect user privacy and data.  \n- By using this script, you agree to take full responsibility for your actions.  \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthe-real-virus%2Fwhatsapp-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthe-real-virus%2Fwhatsapp-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthe-real-virus%2Fwhatsapp-bot/lists"}