whatsapp-python
Readme
Free, open-source Python wrapper for the WhatsApp Cloud API.
Forked from Neurotech-HQ/heyoo
Docs are available in the wiki section on GitHub.
The main reason why I decided to fork the original library is that it uses an old version of the API and doesn't support many features.
In this library I added app events (to listen to incoming messages) and implemented an easier way to send/receive messages and media by creating the Messageobject.
I fixed some bugs and added some features, but the library still needs a lot of work to be done even if it's working and usable.
To install the library you can either use pip (latest release version):
pip install whatsapp-python
or git (latest development version):
git clone https://github.com/filipporomani/whatsapp.git
cd whatsapp
python3 setup.py install
To use the WhatsApp API you need to create a Facebook Business account and a WhatsApp Business account.
To create an account, I recomend to follow this video
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! I'm not responsible for any costs you may have using the API.
A suggestion I can give you is to use a test number (you can get one for free and use it for testing purposes only).
All the prices are available in the WhatsApp API docs
Neurotech-HQ/heyooYou can ignore this if it's your first time using the library.
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..
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.
FAQs
Open source Python wrapper for the WhatsApp Cloud API
We found that whatsapp-python demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
NIST's new AI Risk Management Framework aims to enhance the security and reliability of generative AI systems and address the unique challenges of malicious AI exploits.
Security News
This episode of the Risky Biz podcast discusses how the rise of small open source packages and the shift towards individual maintainers makes the ecosystem more vulnerable to supply chain attacks.
Product
Streamline your login process and enhance security by enabling Single Sign-On (SSO) on the Socket platform, now available for all customers on the Enterprise plan, supporting 20+ identity providers.