django-whatsapp-api-wrapper 0.1.0__tar.gz

django_whatsapp_api_wrapper-0.1.0/LICENSE

@@ -0,0 +1,23 @@
+MIT License
+
+Copyright (c) 2025 Edivaldo Delgado
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+

django_whatsapp_api_wrapper-0.1.0/PKG-INFO

@@ -0,0 +1,31 @@
+Metadata-Version: 2.3
+Name: django-whatsapp-api-wrapper
+Version: 0.1.0
+Summary: 
+License: MIT
+Author: Your Name
+Author-email: you@example.com
+Requires-Python: >=3.11,<4.0
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Provides-Extra: dev
+Requires-Dist: build (==1.2.1) ; extra == "dev"
+Requires-Dist: django (>=4.2)
+Requires-Dist: dotenv (>=0.9.9,<0.10.0)
+Requires-Dist: nox (==2024.4.15) ; extra == "dev"
+Requires-Dist: python-dotenv (>=1.0,<2.0)
+Requires-Dist: twine (==5.1.1) ; extra == "dev"
+Description-Content-Type: text/markdown
+
+# django-whatsapp-api-wrapper

django_whatsapp_api_wrapper-0.1.0/README.md

@@ -0,0 +1 @@
+# django-whatsapp-api-wrapper

django_whatsapp_api_wrapper-0.1.0/pyproject.toml

@@ -0,0 +1,41 @@
+[tool.poetry]
+name = "django-whatsapp-api-wrapper"
+version = "0.1.0"
+description = ""
+authors = ["Your Name <you@example.com>"]
+readme = "README.md"
+license = "MIT"
+include = ["LICENSE"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Web Environment",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: Implementation :: CPython",
+    "Topic :: Software Development :: Libraries :: Application Frameworks",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+[[tool.poetry.packages]]
+include = "django_whatsapp_api_wrapper"
+from = "src"
+
+[tool.poetry.dependencies]
+python = "^3.11"
+django = ">=4.2"
+build = { version = "1.2.1", optional = true }
+nox = { version = "2024.4.15", optional = true }
+twine = { version = "5.1.1", optional = true }
+python-dotenv = "^1.0"
+dotenv = "^0.9.9"
+
+[tool.poetry.extras]
+dev = ["build", "nox", "twine"]
+
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"

django_whatsapp_api_wrapper-0.1.0/src/django_whatsapp_api_wrapper/__init__.py

@@ -0,0 +1,12 @@
+# 1. Import Third Party Libraries
+import logging
+import requests
+
+# 2. Import Local Libraries
+from .messages import Message
+from .client import WhatsApp
+
+__all__ = ["WhatsApp", "Message"]
+
+
+

django_whatsapp_api_wrapper-0.1.0/src/django_whatsapp_api_wrapper/admin.py

@@ -0,0 +1,3 @@
+from django.contrib import admin
+
+# Register your models here.

django_whatsapp_api_wrapper-0.1.0/src/django_whatsapp_api_wrapper/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class DjangoWhatsappApiWrapperConfig(AppConfig):
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'django_whatsapp_api_wrapper'

django_whatsapp_api_wrapper-0.1.0/src/django_whatsapp_api_wrapper/client.py

@@ -0,0 +1,51 @@
+import logging
+import requests
+from django.conf import settings
+from .messages import Message
+
+
+class WhatsApp:
+    def __init__(
+        self,
+        token: str = settings.TOKEN,
+        phone_number_id: str = settings.PHONE_NUMBER_ID #Default to the phone number id from the settings,
+    ):
+        """
+        Initialize the WhatsApp Object
+
+        Args:
+            token[str]: Token for the WhatsApp cloud API
+            phone_number_id[str]: Phone number id for the WhatsApp cloud API
+        """
+
+        if token == "":
+            logging.error("Token not provided")
+            raise ValueError("Token not provided but required")
+        if phone_number_id == "":
+            logging.error("Phone number ID not provided")
+            raise ValueError("Phone number ID not provided but required")
+
+        self.PACKAGE_VERSION = settings.PACKAGE_VERSION  # package version
+        self.API_VERSION = settings.API_VERSION  # api version
+
+        self.token = token
+        self.phone_number_id = phone_number_id
+        self.base_url = f"https://graph.facebook.com/{self.API_VERSION}"
+        self.url = f"{self.base_url}/{phone_number_id}/messages"
+        
+        self.headers = {
+            "Content-Type": "application/json",
+            "Authorization": f"Bearer {self.token}",
+        }
+
+    def build_message(self, **kwargs) -> Message:
+        """
+        Build a message object
+
+        Args:
+            data[dict]: The message data
+            content[str]: The message content
+            to[str]: The recipient
+            rec_type[str]: The recipient type (individual/group)
+        """
+        return Message(**kwargs, instance=self)

django_whatsapp_api_wrapper-0.1.0/src/django_whatsapp_api_wrapper/messages/__init__.py

@@ -0,0 +1,60 @@
+import logging
+import requests
+
+class Message:
+    # type: ignore
+    def __init__(
+        self,
+        messaging_product: str = "whatsapp",
+        to: str = "",
+        type: str = "",
+        data: dict = {},
+        instance: "WhatsApp" = None,
+        recipient_type: str = "individual",
+    ):
+        if instance is not None:
+            from .. import WhatsApp
+            assert isinstance(instance, WhatsApp)
+        self.instance = instance
+        self.type = type
+        self.data = data
+        self.messaging_product = messaging_product
+        self.recipient_type = recipient_type
+        self.to = to
+
+    def send(self) -> dict:
+        try:
+            sender = self.instance.phone_number_id
+        except:
+            logging.error("Phone number id not found")
+            
+        payload = {
+            "messaging_product": "whatsapp",
+            "recipient_type": self.recipient_type,
+            "to": self.to,
+        }
+            
+        if self.type == "text":
+            payload.update({
+                "type": "text",
+                "text": self.data,
+            })
+        elif self.type == "template":
+            payload.update({
+                "type": "template",
+                "template": self.data,
+            })
+            
+        print(payload)
+
+        logging.info(f"Sending message to {self.to}")
+        r = requests.post(self.instance.url, headers=self.instance.headers, json=payload)
+        if r.status_code == 200:
+            logging.info(f"Message sent to {self.to}")
+            return r.json()
+        logging.info(f"Message not sent to {self.to}")
+        logging.info(f"Status code: {r.status_code}")
+        logging.error(f"Response: {r.json()}")
+        return r.json()
+    
+    

django_whatsapp_api_wrapper-0.1.0/src/django_whatsapp_api_wrapper/messages/_template.py

@@ -0,0 +1,8 @@
+data = dict(
+    template=dict(
+        name="opa",
+        language=dict(
+            code="pt_BR"
+        )
+    )
+)

django_whatsapp_api_wrapper-0.1.0/src/django_whatsapp_api_wrapper/messages/_text.py

@@ -0,0 +1,11 @@
+def text(self, text: str, preview_url: bool = False) -> dict:
+
+    data = {
+        "messaging_product": "whatsapp",
+        "recipient_type": self.rec,
+        "to": self.to,
+        "type": "text",
+        "text": {"preview_url": preview_url, "body": self.content},
+    }
+    
+    return data

django_whatsapp_api_wrapper-0.1.0/src/django_whatsapp_api_wrapper/shell_example.txt

@@ -0,0 +1,25 @@
+#############################
+#### SEND TEMPLATE ##########
+#############################
+
+from django_whatsapp_api_wrapper import *
+wp = WhatsApp()
+
+language = {"code": "pt_BR"}
+template = {"name": "opa", "language": language}
+data = template
+
+m = wp.build_message(to = "5521980340830", type = "template", data=data)
+m.send()
+
+
+#############################
+#### SEND MESSAGE ###########
+#############################
+
+from django_whatsapp_api_wrapper import *
+wp = WhatsApp()
+
+data = {"preview_url": False, "body": "oPA!!"}
+m3 = wp.build_message(to = "+5521980340830", type = "text", data=data)
+m3.send()

django_whatsapp_api_wrapper-0.1.0/src/django_whatsapp_api_wrapper/tests.py

@@ -0,0 +1,3 @@
+from django.test import TestCase
+
+# Create your tests here.

django_whatsapp_api_wrapper-0.1.0/src/django_whatsapp_api_wrapper/urls.py

@@ -0,0 +1,6 @@
+from django.urls import path
+from .views import whatsapp_webhook
+
+urlpatterns = [
+    path("webhook/", whatsapp_webhook, name="whatsapp_webhook"),
+]

django_whatsapp_api_wrapper-0.1.0/src/django_whatsapp_api_wrapper/views.py

@@ -0,0 +1,38 @@
+import json
+from django.conf import settings
+from django.http import HttpRequest, HttpResponse, JsonResponse
+from django.views.decorators.csrf import csrf_exempt
+
+
+@csrf_exempt
+def whatsapp_webhook(request: HttpRequest) -> HttpResponse:
+    """
+    Webhook endpoint for WhatsApp Cloud API.
+
+    - GET: Verification handshake using hub.mode, hub.challenge, hub.verify_token
+    - POST: Receive event notifications (messages, status updates, etc.)
+    """
+    if request.method == "GET":
+        mode = request.GET.get("hub.mode")
+        token = request.GET.get("hub.verify_token")
+        challenge = request.GET.get("hub.challenge")
+
+        if mode == "subscribe" and token == getattr(settings, "WHATSAPP_VERIFY_TOKEN", None):
+            return HttpResponse(challenge or "", status=200)
+        return HttpResponse(status=403)
+
+    if request.method == "POST":
+        try:
+            payload = json.loads(request.body.decode("utf-8")) if request.body else {}
+        except json.JSONDecodeError:
+            return HttpResponse(status=400)
+
+        # Basic structure check per WhatsApp webhook format
+        # { object, entry: [ { changes: [ { field, value: { messaging_product, metadata, ... } } ] } ] }
+        # For now, echo 200 OK to acknowledge receipt.
+        # You can extend this to process messages, statuses, etc.
+        return JsonResponse({"status": "received"}, status=200)
+
+    return HttpResponse(status=405)
+
+