whatsapp-python 3.0.6__tar.gz → 3.1.0__tar.gz

{whatsapp_python-3.0.6 → whatsapp_python-3.1.0}/.gitignore

@@ -2,6 +2,7 @@
 __pycache__/
 *.py[cod]
 *$py.class
+test.py
 
 # C extensions
 *.so

whatsapp_python-3.1.0/.version

@@ -0,0 +1 @@
+3.1.0

{whatsapp_python-3.0.6 → whatsapp_python-3.1.0}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2023 FILIPPO ROMANI
+Copyright (c) 2023-2024 FILIPPO ROMANI
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

whatsapp_python-3.1.0/PKG-INFO

@@ -0,0 +1,112 @@
+Metadata-Version: 2.3
+Name: whatsapp-python
+Version: 3.1.0
+Summary: Open source Python wrapper for the WhatsApp Cloud API
+Project-URL: Homepage, https://github.com/filipporomani/whatsapp
+Project-URL: Bug Tracker, https://github.com/filipporomani/whatsapp/issues
+Project-URL: Download, https://github.com/filipporomani/whatsapp/releases/latest
+Author-email: Filippo Romani <mail@filipporomani.it>
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.10
+Requires-Dist: fastapi
+Requires-Dist: python-dotenv
+Requires-Dist: requests
+Requires-Dist: requests-toolbelt
+Requires-Dist: unicorn
+Description-Content-Type: text/markdown
+
+<div align="center">
+  <img src="https://gist.githubusercontent.com/boywithkeyboard/e8dc5b1810bd29e1d70346ca11d7f09d/raw/7f7eeea482f5047e62944e54182aa26c89cc299a/whatsapp_python.svg" alt="logo" width="128px">
+  <h1>whatsapp-python</h1>
+  <p>Free, open-source Python wrapper for the <a href="https://developers.facebook.com/docs/whatsapp/cloud-api">WhatsApp Cloud API</a>.<br>Forked from <a href="https://github.com/Neurotech-HQ/heyoo">Neurotech-HQ/heyoo</a>.</p>
+  <img src="https://img.shields.io/badge/made%20in-italy-008751.svg?style=flat-square" alt="Made in Italy">
+  <a href="https://pepy.tech/project/whatsapp-python"><img src="https://static.pepy.tech/personalized-badge/whatsapp-python?period=total&units=none&left_color=grey&right_color=blue&left_text=Downloads" alt="Downloads"></a>
+  <a href="https://pepy.tech/project/whatsapp-python"><img src="https://pepy.tech/badge/whatsapp-python/month" alt="Monthly Downloads"></a>
+  <a href="https://pepy.tech/project/whatsapp-python"><img src="https://pepy.tech/badge/whatsapp-python/week" alt="Weekly Downloads"></a>
+</div>
+
+## Installation
+
+To install the library you can either use pip (latest release version):
+
+``pip install whatsapp-python``
+
+However I personally recomend you to install the GitHub version (always up to date)
+
+```bash
+git clone https://github.com/filipporomani/whatsapp.git
+cd whatsapp
+python3 setup.py install
+```
+
+Documentation is available in the [wiki section](https://github.com/filipporomani/whatsapp/wiki) on GitHub.
+
+## Why choose this library?
+
+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 `Message`object.
+
+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.
+
+### Supported features:
+
+- Listening to events (messages, media, etc.)
+- Sending messages
+- Marking messages as read
+- Sending Media (images, audio, video and documents)
+- Sending location
+- Sending interactive buttons
+- Sending template messages
+- Parsing messages and media received
+
+## Obtaining the WhatsApp API credentials
+
+To use the WhatsApp API you need to create a Facebook Business account and a WhatsApp Business account.
+
+> [!TIP]  
+> To create an account, I recommend to follow [this video](https://youtu.be/d6lNxP2gadA).
+
+## Pricing of the API
+
+Whereas using third-party providers of the WhatsApp API can result in monthly fees, using the WhatsApp API[^1] offered directly by Facebook is much cheaper, even if the billing documentation is quite difficult to understand.
+
+> [!CAUTION]  
+> It is now mandatory to add a credit card to the WhatsApp account (at least for me) in order to use the service. I was even charged a fee for using a non-test phone number (~€1.20), so be careful when using the API! I'm not responsible for any costs you may face by using the API.
+
+All the prices are available in the [**WhatsApp API docs**](https://developers.facebook.com/docs/whatsapp/pricing).
+
+> [!TIP]  
+> One recommendation I can give you is to use a test number (you can get a free phone number and use it for testing purposes only).
+
+## Migrating from `Neurotech-HQ/heyoo`
+
+*You 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 breaking changes.
+
+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 versions GREATER THAN 1.1.2, messages have became objects, so you need to change your code to use the new methods.
+
+> [!NOTE]  
+> Documentation for version 1.1.2 can be found [here](https://github.com/filipporomani/whatsapp/wiki/v1.1.2).
+
+## Contributing
+
+If you are facing any issues or have any questions, please [open a new issue](https://github.com/filipporomani/whatsapp/issues/new/choose)!
+
+*This is an open source project published under the [MIT License](LICENSE).*
+
+[^1]: https://developers.facebook.com/docs/whatsapp/cloud-api

whatsapp_python-3.1.0/README.md

@@ -0,0 +1,85 @@
+<div align="center">
+  <img src="https://gist.githubusercontent.com/boywithkeyboard/e8dc5b1810bd29e1d70346ca11d7f09d/raw/7f7eeea482f5047e62944e54182aa26c89cc299a/whatsapp_python.svg" alt="logo" width="128px">
+  <h1>whatsapp-python</h1>
+  <p>Free, open-source Python wrapper for the <a href="https://developers.facebook.com/docs/whatsapp/cloud-api">WhatsApp Cloud API</a>.<br>Forked from <a href="https://github.com/Neurotech-HQ/heyoo">Neurotech-HQ/heyoo</a>.</p>
+  <img src="https://img.shields.io/badge/made%20in-italy-008751.svg?style=flat-square" alt="Made in Italy">
+  <a href="https://pepy.tech/project/whatsapp-python"><img src="https://static.pepy.tech/personalized-badge/whatsapp-python?period=total&units=none&left_color=grey&right_color=blue&left_text=Downloads" alt="Downloads"></a>
+  <a href="https://pepy.tech/project/whatsapp-python"><img src="https://pepy.tech/badge/whatsapp-python/month" alt="Monthly Downloads"></a>
+  <a href="https://pepy.tech/project/whatsapp-python"><img src="https://pepy.tech/badge/whatsapp-python/week" alt="Weekly Downloads"></a>
+</div>
+
+## Installation
+
+To install the library you can either use pip (latest release version):
+
+``pip install whatsapp-python``
+
+However I personally recomend you to install the GitHub version (always up to date)
+
+```bash
+git clone https://github.com/filipporomani/whatsapp.git
+cd whatsapp
+python3 setup.py install
+```
+
+Documentation is available in the [wiki section](https://github.com/filipporomani/whatsapp/wiki) on GitHub.
+
+## Why choose this library?
+
+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 `Message`object.
+
+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.
+
+### Supported features:
+
+- Listening to events (messages, media, etc.)
+- Sending messages
+- Marking messages as read
+- Sending Media (images, audio, video and documents)
+- Sending location
+- Sending interactive buttons
+- Sending template messages
+- Parsing messages and media received
+
+## Obtaining the WhatsApp API credentials
+
+To use the WhatsApp API you need to create a Facebook Business account and a WhatsApp Business account.
+
+> [!TIP]  
+> To create an account, I recommend to follow [this video](https://youtu.be/d6lNxP2gadA).
+
+## Pricing of the API
+
+Whereas using third-party providers of the WhatsApp API can result in monthly fees, using the WhatsApp API[^1] offered directly by Facebook is much cheaper, even if the billing documentation is quite difficult to understand.
+
+> [!CAUTION]  
+> It is now mandatory to add a credit card to the WhatsApp account (at least for me) in order to use the service. I was even charged a fee for using a non-test phone number (~€1.20), so be careful when using the API! I'm not responsible for any costs you may face by using the API.
+
+All the prices are available in the [**WhatsApp API docs**](https://developers.facebook.com/docs/whatsapp/pricing).
+
+> [!TIP]  
+> One recommendation I can give you is to use a test number (you can get a free phone number and use it for testing purposes only).
+
+## Migrating from `Neurotech-HQ/heyoo`
+
+*You 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 breaking changes.
+
+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 versions GREATER THAN 1.1.2, messages have became objects, so you need to change your code to use the new methods.
+
+> [!NOTE]  
+> Documentation for version 1.1.2 can be found [here](https://github.com/filipporomani/whatsapp/wiki/v1.1.2).
+
+## Contributing
+
+If you are facing any issues or have any questions, please [open a new issue](https://github.com/filipporomani/whatsapp/issues/new/choose)!
+
+*This is an open source project published under the [MIT License](LICENSE).*
+
+[^1]: https://developers.facebook.com/docs/whatsapp/cloud-api

{whatsapp_python-3.0.6 → whatsapp_python-3.1.0}/pyproject.toml

@@ -4,11 +4,11 @@ build-backend = "hatchling.build"
 
 [project]
 name="whatsapp-python"
-version="3.0.6"
+version="3.1.0"
 authors = [{name="Filippo Romani", email="mail@filipporomani.it"}]
 description="Open source Python wrapper for the WhatsApp Cloud API"
 readme = "README.md"
-requires-python = ">=3.8"
+requires-python = ">=3.10"
 classifiers=[
     "Development Status :: 4 - Beta",
     "Intended Audience :: Developers",
@@ -21,6 +21,7 @@ classifiers=[
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
 ]
+dependencies = ["fastapi", "unicorn","requests_toolbelt", "requests", "python-dotenv"]
 
 [project.urls]
 "Homepage" = "https://github.com/filipporomani/whatsapp"

{whatsapp_python-3.0.6 → whatsapp_python-3.1.0}/whatsapp/__init__.py

@@ -5,7 +5,7 @@ from __future__ import annotations
 
 import requests
 import logging
-from fastapi import FastAPI, Request
+from fastapi import FastAPI, HTTPException, Request
 from uvicorn import run as _run
 from .constants import VERSION
 from . import ext
@@ -16,10 +16,10 @@ from .ext._send_media import send_image, send_video, send_audio, send_location,
 from .ext._media import upload_media, query_media_url, download_media, delete_media
 from .ext._buttons import send_button, create_button, send_reply_button
 from .ext._static import is_message, get_mobile, get_author, get_name, get_message, get_message_id, get_message_type, get_message_timestamp, get_audio, get_delivery, get_document, get_image, get_interactive_response, get_location, get_video, changed_field
-
+import json
 
 class WhatsApp(object):
-    def __init__(self, token: str = "", phone_number_id: str = "", logger: bool = True, update_check: bool = True):
+    def __init__(self, token: str = "", phone_number_id: str = "", logger: bool = True, update_check: bool = True, verify_token: str = ""):
         """
         Initialize the WhatsApp Object
 
@@ -71,8 +71,10 @@ class WhatsApp(object):
         self.phone_number_id = phone_number_id
         self.base_url = "https://graph.facebook.com/v18.0"
         self.url = f"{self.base_url}/{phone_number_id}/messages"
+        self.verify_token = verify_token
+        
 
-        async def base():
+        async def base(*args):
             pass
         self.message_handler = base
         self.other_handler = base
@@ -91,12 +93,12 @@ class WhatsApp(object):
 
         @self.app.get("/")
         async def verify_endpoint(r: Request):
-            if r.query_params.get("hub.verify_token") == self.token:
+            if r.query_params.get("hub.verify_token") == self.verify_token:
                 logging.info("Verified webhook")
                 challenge = r.query_params.get("hub.challenge")
                 self.verification_handler(challenge)
                 self.other_handler(challenge)
-                return str(challenge)
+                return int(challenge)
             logging.error("Webhook Verification failed")
             await self.verification_handler(False)
             await self.other_handler(False)
@@ -104,19 +106,32 @@ class WhatsApp(object):
 
         @self.app.post("/")
         async def hook(r: Request):
-            # Handle Webhook Subscriptions
-            data = await r.json()
-            if data is None:
-                return {"success": False}
-            logging.info("Received webhook data: %s", data)
-            changed_field = self.instance.changed_field(data)
-            if changed_field == "messages":
-                new_message = self.instance.is_message(data)
-                if new_message:
-                    msg = Message(instance=self.instance, data=data)
-                    await self.message_handler(msg)
-                    await self.other_handler(msg)
-            return {"success": True}
+            try:
+                # Handle Webhook Subscriptions
+                data = await r.json()
+                if data is None:
+                    return {"success": False}
+                logging.info("Received webhook data: %s", data)
+                data_str = json.dumps(data, indent=4)
+                logging.debug(f"Received webhook data: {data_str}")
+                
+                changed_field = self.changed_field(data)
+                if changed_field == "messages":
+                    new_message = self.is_message(data)
+                    if new_message:
+                        msg = Message(instance=self, data=data)
+                        await self.message_handler(msg)
+                        await self.other_handler(msg)
+                return {"success": True}
+            except Exception as e:
+                logging.error(f"Error parsing message: {e}")
+                raise HTTPException(status_code=500, detail={
+                    "success": False,
+                    "error": str(e)
+                })
+
+                
+            
 
     # all the files starting with _ are imported here, and should not be imported directly.
 
@@ -137,6 +152,23 @@ class WhatsApp(object):
     changed_field = staticmethod(changed_field)
     get_author = staticmethod(get_author)
 
+    send_button = send_button
+    create_button = create_button
+    send_reply_button = send_reply_button
+    send_image = send_image
+    send_video = send_video
+    send_audio = send_audio
+    send_location = send_location
+    send_sticker = send_sticker
+    send_document = send_document
+    upload_media = upload_media
+    query_media_url = query_media_url
+    download_media = download_media
+    delete_media = delete_media
+    send_template = send_template
+    send_custom_json = send_custom_json
+    send_contacts = send_contacts
+
     authorized = property(authorized)
 
     def create_message(self, **kwargs) -> Message:
@@ -184,6 +216,10 @@ class WhatsApp(object):
 
 class Message(object):
     def __init__(self, id: int = None, data: dict = {}, instance: WhatsApp = None, content: str = "", to: str = "", rec_type: str = "individual"):  # type: ignore
+        self.instance = instance
+        self.url = self.instance.url
+        self.headers = self.instance.headers
+        
         try:
             self.id = instance.get_message_id(data)
         except:
@@ -239,9 +275,6 @@ class Message(object):
                 self.interactive = self.instance.get_interactive_response(data)
             except:
                 pass
-
-        self.instance = instance
-        self.url = self.instance.url
-        self.headers = self.instance.headers
+        
 
     from .ext._message import send, reply, mark_as_read

{whatsapp_python-3.0.6 → whatsapp_python-3.1.0}/whatsapp/constants.py

@@ -1,3 +1,3 @@
 # internal use only - numbers and . only 
 
-VERSION = "3.0.6"
+VERSION = "3.1.0"

whatsapp_python-3.0.6/.version

@@ -1 +0,0 @@
-3.0.6

whatsapp_python-3.0.6/PKG-INFO

@@ -1,111 +0,0 @@
-Metadata-Version: 2.1
-Name: whatsapp-python
-Version: 3.0.6
-Summary: Open source Python wrapper for the WhatsApp Cloud API
-Project-URL: Homepage, https://github.com/filipporomani/whatsapp
-Project-URL: Bug Tracker, https://github.com/filipporomani/whatsapp/issues
-Project-URL: Download, https://github.com/filipporomani/whatsapp/releases/latest
-Author-email: Filippo Romani <mail@filipporomani.it>
-License-File: LICENSE
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3.6
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Topic :: Software Development :: Build Tools
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-
-# [whatsapp-python](https://pypi.org/project/whatsapp-python/)
-
-![Made in Italy](https://img.shields.io/badge/made%20in-italy-008751.svg?style=flat-square)
-[![Downloads](https://static.pepy.tech/personalized-badge/whatsapp-python?period=total&units=none&left_color=grey&right_color=blue&left_text=Downloads)](https://pepy.tech/project/whatsapp-python)
-[![Downloads](https://pepy.tech/badge/whatsapp-python/month)](https://pepy.tech/project/whatsapp-python)
-[![Downloads](https://pepy.tech/badge/whatsapp-python/week)](https://pepy.tech/project/whatsapp-python)
-
-Free, open-source Python wrapper for the [WhatsApp Cloud API](https://developers.facebook.com/docs/whatsapp/cloud-api).
-
-Forked from [Neurotech-HQ/heyoo](https://github.com/Neurotech-HQ/heyoo)
-
-## Supported features
-
-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
-
-## Docs 
-
-Docs are available in the [**wiki**](https://github.com/filipporomani/whatsapp/wiki) section on GitHub.
-
-## Why choose this library?
-
-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 `Message`object.
-
-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.
-
-## Installation
-
-To install the library you can either use pip (latest release version):
-
-``pip install whatsapp-python``
-
-or git (latest development version):
-
-```bash
-git clone https://github.com/filipporomani/whatsapp.git
-cd whatsapp
-python3 setup.py install
-```
-
-## Obtaining the WhatsApp API credentials
-
-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](https://youtu.be/d6lNxP2gadA?si=_hbis7aP7MoKkck0)**
-
-## Costs of the API
-
-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**](https://developers.facebook.com/docs/whatsapp/pricing)
-
-## Switching from `Neurotech-HQ/heyoo`
-*You 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**](https://github.com/filipporomani/whatsapp/wiki/v1.1.2).
-
-
-
-
-## Issues
-
-If you are facing any issues or have any questions, please open an issue on the [**GitHub repository**](https://github.com/filipporomani/whatsapp/issues)
-
-## Contributing
-
-This is an opensource project published under the ```MIT License```: [**LICENSE**](LICENSE).
-
-## References
-
-1. [WhatsApp Cloud API official documentation](https://developers.facebook.com/docs/whatsapp/cloud-api/)

whatsapp_python-3.0.6/README.md

@@ -1,89 +0,0 @@
-# [whatsapp-python](https://pypi.org/project/whatsapp-python/)
-
-![Made in Italy](https://img.shields.io/badge/made%20in-italy-008751.svg?style=flat-square)
-[![Downloads](https://static.pepy.tech/personalized-badge/whatsapp-python?period=total&units=none&left_color=grey&right_color=blue&left_text=Downloads)](https://pepy.tech/project/whatsapp-python)
-[![Downloads](https://pepy.tech/badge/whatsapp-python/month)](https://pepy.tech/project/whatsapp-python)
-[![Downloads](https://pepy.tech/badge/whatsapp-python/week)](https://pepy.tech/project/whatsapp-python)
-
-Free, open-source Python wrapper for the [WhatsApp Cloud API](https://developers.facebook.com/docs/whatsapp/cloud-api).
-
-Forked from [Neurotech-HQ/heyoo](https://github.com/Neurotech-HQ/heyoo)
-
-## Supported features
-
-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
-
-## Docs 
-
-Docs are available in the [**wiki**](https://github.com/filipporomani/whatsapp/wiki) section on GitHub.
-
-## Why choose this library?
-
-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 `Message`object.
-
-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.
-
-## Installation
-
-To install the library you can either use pip (latest release version):
-
-``pip install whatsapp-python``
-
-or git (latest development version):
-
-```bash
-git clone https://github.com/filipporomani/whatsapp.git
-cd whatsapp
-python3 setup.py install
-```
-
-## Obtaining the WhatsApp API credentials
-
-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](https://youtu.be/d6lNxP2gadA?si=_hbis7aP7MoKkck0)**
-
-## Costs of the API
-
-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**](https://developers.facebook.com/docs/whatsapp/pricing)
-
-## Switching from `Neurotech-HQ/heyoo`
-*You 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**](https://github.com/filipporomani/whatsapp/wiki/v1.1.2).
-
-
-
-
-## Issues
-
-If you are facing any issues or have any questions, please open an issue on the [**GitHub repository**](https://github.com/filipporomani/whatsapp/issues)
-
-## Contributing
-
-This is an opensource project published under the ```MIT License```: [**LICENSE**](LICENSE).
-
-## References
-
-1. [WhatsApp Cloud API official documentation](https://developers.facebook.com/docs/whatsapp/cloud-api/)