Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/aahnik/wappdriver

Wondering how to send WhatsApp messages using Python using only 3 lines of code? You have come to the right place!
https://github.com/aahnik/wappdriver

hacktoberfest hacktoberfest2020 how-to-send-whatsapp-messages python3 requests selenium-webdriver using-python whatsapp whatsapp-bot whatsapp-web

Last synced: 8 days ago
JSON representation

Wondering how to send WhatsApp messages using Python using only 3 lines of code? You have come to the right place!

Host: GitHub
URL: https://github.com/aahnik/wappdriver
Owner: aahnik
License: mit
Archived: true
Created: 2020-07-20T13:00:49.000Z (about 4 years ago)
Default Branch: main
Last Pushed: 2021-03-29T12:15:19.000Z (over 3 years ago)
Last Synced: 2024-09-21T08:34:08.042Z (12 days ago)
Topics: hacktoberfest, hacktoberfest2020, how-to-send-whatsapp-messages, python3, requests, selenium-webdriver, using-python, whatsapp, whatsapp-bot, whatsapp-web
Language: Python
Homepage: https://aahnik.github.io/wappdriver/
Size: 6.29 MB
Stars: 46
Watchers: 1
Forks: 3
Open Issues: 0
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        # wappdriver

>**UPDATE:**

> **I WILL BE LEAVING WHATSAPP AFTER AUGUST 2021. THIS PACKAGE WILL NO LONGER BE MAINTAINED. SWITCH TO TELEGRAM FOR A EASIER LIFE AND A FREE OFFICIAL API.**

API for WhatsApp Web Automation

Wondering how to send WhatsApp messages using Python using only three lines of code? **You have come to the right place!**

[![Tests](https://img.shields.io/badge/tests-passing-green)](https://aahnik.github.io/wappdriver/docs/Tests.html)

[![Maintenance](https://img.shields.io/maintenance/yes/2020)](https://github.com/aahnik/wappdriver/graphs/commit-activity)

[![GitHub Release](https://img.shields.io/github/v/release/aahnik/wappdriver)](https://github.com/aahnik/wappdriver/releases)

[![CodeFactor](https://www.codefactor.io/repository/github/aahnik/wappdriver/badge)](https://www.codefactor.io/repository/github/aahnik/wappdriver)

[![MIT LICENSE](https://img.shields.io/pypi/l/ansicolortags.svg)](/LICENSE)

[![made-with-python](https://img.shields.io/badge/Made%20with-Python-1f425f.svg)](https://www.python.org/)

## Usage 😎

wappdriver is a python package that helps you automate sending messages through WhatsApp Web.

_It enables you to send WhatsApp messages programmatically, using only three lines of code._

It is very simple to use

```python

from wappdriver import WhatsApp

with WhatsApp() as bot:

    bot.send('aahnik',  # name of recipient

             'hi send by a bot')  # message

# The name of the recipient should be in your contacts

```

Read **[full documentation 📖](https://aahnik.github.io/wappdriver/usage/02_sending_messages/)** to learn how to send emojis, media and files.

## Installation ⏬

You can easily install wappdriver from the [PyPI](https://pypi.org/project/wappdriver/).

```shell

pip install wappdriver

```

For Mac and Linux, you may need to use `pip3`.

## Requirements 🧑‍💻

You must have the following installed in your system for wappdriver to work.

- [Chrome Browser](https://www.google.com/chrome/)

- [Chrome Driver](https://chromedriver.chromium.org/)

Make sure to have matching versions of the Chrome Browser and Chrome Driver.

I recommend using the latest stable release for both to get the best performance.

WappDriver does not support other Browsers. Please use Chrome for a smooth experience.

## Setup ⚙️

After you have installed wappdriver and the requirements stated above, you can start using wappdriver straight away.

When you will run your code for the first time, you will be asked for Chrome Driver Path.

When the WhatsApp web screen loads for the first time, you have to scan the QR code from you smartphone's WhatsApp application, to log into your WhatsApp account. [Learn more](https://aahnik.github.io/wappdriver/usage/01_first_time_setup/).

## Getting Help 💁🏻

First of all, read the [Help Page](https://aahnik.github.io/wappdriver/help/).

You may try to search your question in the search bar on the page.

For further assistance you may [ask a question](https://github.com/aahnik/wappdriver/discussions) in the discussions section.

## Contributing 🤩

Please look at [Code of Conduct](https://github.com/aahnik/wappdriver/blob/master/.github/CODE_OF_CONDUCT.md#contributor-covenant-code-of-conduct) and [Contributing Guidelines](https://github.com/aahnik/wappdriver/blob/master/.github/CONTRIBUTING.md#how-to-contribute-to-wappdriver-).

Please read the explanation of the detailed working of `wappdriver` from the [Developer's Guide.](https://aahnik.github.io/wappdriver/dev/wappdriver/)

## Legal ⚖️

This project is distributed under [MIT License](https://github.com/aahnik/wappdriver/blob/main/LICENSE).

This code is in no way affiliated with, authorized, maintained, sponsored, or endorsed by WhatsApp or any of its affiliates or subsidiaries. This is an independent and unofficial software.