Automated WhatsApp Messaging

Python Script to send bulk whatsapp message via chrome!

Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Features
4. Usage
5. Contributing
6. License
7. Contact
8. Acknowledgments

About The Project

The project was first built out of neccesity while sending messages to hundreds of people for an online event conducted by Sigma Xi VIT Later, it was updated to run in automatically and headlessly, so we could use our time more wisely.

If you find this script useful, please leave a ⭐

(back to top)

Built With

• Python
• Selenium

(back to top)

Getting Started

To get a local copy up and running follow these simple example steps.

Prerequisites

Make sure to add both to the PATH

• Python 3
• Git (optional)

To get the repository, either download the ZIP folder from Code and extract it, or clone the repository via git using

git clone https://github.com/Devansh-ops/Automated-WhatsApp-Messaging.git

Installation

Move into the folder

cd Automated-WhatsApp-Messaging

To install dependencies type:

pip install -r requirements.txt

(back to top)

Features

• Modular - can be imported
• Fast - Default run in headless mode
• CLI - Takes input from the terminal
• Error logging and screenshots

(back to top)

Usage

Basic Usage

python script.py <EXCEL SHEET> <TEXT FILE>

You might want to specify the column containing the numbers via the -c flag ( 0-based indexing )

For more usage details, Type python script.py --help

usage: script.py [-h] [-c COLUMN] [-d DELAY] [-s] [-e EXTENSION] [--screenshot SCREENSHOT] [-z] file [message]

positional arguments:
  file                  Path to Excel file containing numbers to send message to
  message               Text file containing message to send

options:
  -h, --help            show this help message and exit
  -c COLUMN, --column COLUMN
                        Column name or number where numbers are located
  -d DELAY, --delay DELAY
                        Time (in seconds) to wait after sending the message. Default = 4
  -s, --string          Treat message as string input
  -e EXTENSION, --extension EXTENSION
                        Change default phone extention. Default is Indian: 91
  --screenshot SCREENSHOT
                        Defines error screenshot folder
  -z, --head            Runs without headless mode

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Clone it locally (git clone https://github.com/<YOUR-USERNAME>/Automated-WhatsApp-Messaging.git)
3. Install the dependencies
4. Create your Feature Branch (git checkout -b feature/AmazingFeature)
5. Commit your Changes (git commit -m 'Add some AmazingFeature')
6. Push to the Branch (git push origin feature/AmazingFeature)
7. Open a Pull Request

(back to top)

License

Distributed under the BSD 3-Clause License. See LICENSE.txt for more information.

(back to top)

Contact

Devansh Sehgal - @covfebeforecode - devanshsehgal@gmail.com

Project Link: https://github.com/Devansh-ops/Automated-WhatsApp-Messaging

(back to top)

Acknowledgments

• Choose an Open Source License
• Img Shields
• PyQRCode
• Best-README-Template

(back to top)