Free, open-source Python wrapper for the WhatsApp Cloud API.

Forked from Neurotech-HQ/heyoo

1. Listening to events (messages, media, etc.)
2. Sending messages
3. Marking messages as read
4. Sending Media (images, audio, video and documents)
5. Sending location
6. Sending interactive buttons
7. Sending template messages
8. Parsing messages and media received

Asynchronous app events are now available!

The docs are available in the wiki

Leave feedbacks/report issues freely on GitHub! I'll be glad to help you!

To install the library you can either use pip (latest release version):

pip install -i https://test.pypi.org/simple/ whatsapp-python==3.0.2.post1 (the production link doesn't actually work, I'm working on this issue - #16)

or git (latest development version):

git clone https://github.com/filipporomani/whatsapp.git
cd whatsapp
python3 setup.py install

The documentation for the library is available under the wiki section on GitHub.

While using third-party API providers of the WhatsApp API may have some monthly fees, using the WhatsApp API provided directly by Facebook is way cheaper, even if the billing docs are pretty hard to understand. The first 1000 chats created are free, then there is a pay-as-you-go fee that is paid for each conversation started.

IMPORTANT: it is now mandatory (at least it was for me) to add a credit card to the whatsapp account to use the service. I eventually got billed for using a non-test number (~1,20€), so be carefull using the API!

All the prices are available in the WhatsApp API docs

Any version >1.1.2 is incompatible with the original heyoo library! Be careful updating! Read the docs first! Any version <=1.1.2 is fully compatible with the original heyoo library and doesn't include any breaking change.. You can ignore this warning if it's your first time using the library.

Switching from heyoo to whatsapp-python doesn't require any change for versions up to 1.1.2: just uninstall heyoo, install whatsapp-python==1.1.2 and change the import name from heyoo to whatsapp. For version which are GREATER THEN 1.1.2, messages have became objects, so you need to change your code to use the new methods.

Note: docs for version 1.1.2 are available in the dedicated wiki page.

If you are facing any issues or have any questions, please open an issue on the GitHub repository

This is an opensource project published under the MIT License: LICENSE.

1. WhatsApp Cloud API official documentation