whatsapp-cloud-api-py 0.1.1__tar.gz → 0.2.0__tar.gz

{whatsapp_cloud_api_py-0.1.1 → whatsapp_cloud_api_py-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: whatsapp-cloud-api-py
-Version: 0.1.1
+Version: 0.2.0
 Summary: Async Python SDK for WhatsApp Business Cloud API with Pydantic V2
 Project-URL: Homepage, https://github.com/HeiCg/whatsapp-cloud-api-py
 Project-URL: Repository, https://github.com/HeiCg/whatsapp-cloud-api-py
@@ -26,12 +26,22 @@ Description-Content-Type: text/markdown
 
 # whatsapp-cloud-api-py
 
-Community-built async Python SDK for the WhatsApp Business Cloud API.
+Community-built async Python SDK for the WhatsApp Business Cloud API, powered by [Kapso](https://kapso.ai).
 
 > **Note:** This is an **independent Python implementation** — not a port or fork. It was inspired by the excellent [`@kapso/whatsapp-cloud-api`](https://github.com/gokapso/whatsapp-cloud-api-js) (TypeScript), but written from scratch in Python with its own architecture, design choices, and API surface.
 
 Built with **httpx** (HTTP/2 + connection pooling), **Pydantic V2** (Rust-powered validation), and optional **pyventus** event-driven webhooks.
 
+## Prerequisites
+
+This SDK connects to Meta's WhatsApp Cloud API through [Kapso's](https://kapso.ai) managed proxy. You'll need a **Kapso API key** before getting started:
+
+1. Create an account at [kapso.ai](https://kapso.ai)
+2. Connect your WhatsApp Business account
+3. Generate an API key from the dashboard
+
+See the [Kapso docs](https://docs.kapso.ai/docs/introduction) for detailed setup instructions.
+
 ## Features
 
 - **Fully async** — all I/O uses `async`/`await` with httpx
@@ -69,7 +79,7 @@ import asyncio
 from whatsapp_cloud_api import WhatsAppClient, TextMessage
 
 async def main():
-    async with WhatsAppClient(access_token="YOUR_TOKEN") as client:
+    async with WhatsAppClient(access_token="YOUR_KAPSO_API_KEY") as client:
         response = await client.messages.send_text(TextMessage(
             phone_number_id="PHONE_NUMBER_ID",
             to="5511999999999",
@@ -562,24 +572,22 @@ except GraphApiError as e:
 ```python
 from whatsapp_cloud_api import WhatsAppClient
 
-# Default: graph.facebook.com, v23.0, HTTP/2, 30s timeout
-client = WhatsAppClient(access_token="TOKEN")
+# Default: api.kapso.ai, v23.0, HTTP/2, 30s timeout
+client = WhatsAppClient(access_token="YOUR_KAPSO_API_KEY")
 
-# Custom configuration
+# Custom timeout
 client = WhatsAppClient(
-    access_token="TOKEN",
-    base_url="https://graph.facebook.com",
-    graph_version="v23.0",
+    access_token="YOUR_KAPSO_API_KEY",
     timeout=60.0,
 )
 
 # Bring your own httpx client
 import httpx
 custom_http = httpx.AsyncClient(http2=True, timeout=60.0)
-client = WhatsAppClient(access_token="TOKEN", http_client=custom_http)
+client = WhatsAppClient(access_token="YOUR_KAPSO_API_KEY", http_client=custom_http)
 
 # Always use as async context manager
-async with WhatsAppClient(access_token="TOKEN") as client:
+async with WhatsAppClient(access_token="YOUR_KAPSO_API_KEY") as client:
     await client.messages.send_text(...)
 ```
 

{whatsapp_cloud_api_py-0.1.1 → whatsapp_cloud_api_py-0.2.0}/README.md

@@ -1,11 +1,21 @@
 # whatsapp-cloud-api-py
 
-Community-built async Python SDK for the WhatsApp Business Cloud API.
+Community-built async Python SDK for the WhatsApp Business Cloud API, powered by [Kapso](https://kapso.ai).
 
 > **Note:** This is an **independent Python implementation** — not a port or fork. It was inspired by the excellent [`@kapso/whatsapp-cloud-api`](https://github.com/gokapso/whatsapp-cloud-api-js) (TypeScript), but written from scratch in Python with its own architecture, design choices, and API surface.
 
 Built with **httpx** (HTTP/2 + connection pooling), **Pydantic V2** (Rust-powered validation), and optional **pyventus** event-driven webhooks.
 
+## Prerequisites
+
+This SDK connects to Meta's WhatsApp Cloud API through [Kapso's](https://kapso.ai) managed proxy. You'll need a **Kapso API key** before getting started:
+
+1. Create an account at [kapso.ai](https://kapso.ai)
+2. Connect your WhatsApp Business account
+3. Generate an API key from the dashboard
+
+See the [Kapso docs](https://docs.kapso.ai/docs/introduction) for detailed setup instructions.
+
 ## Features
 
 - **Fully async** — all I/O uses `async`/`await` with httpx
@@ -43,7 +53,7 @@ import asyncio
 from whatsapp_cloud_api import WhatsAppClient, TextMessage
 
 async def main():
-    async with WhatsAppClient(access_token="YOUR_TOKEN") as client:
+    async with WhatsAppClient(access_token="YOUR_KAPSO_API_KEY") as client:
         response = await client.messages.send_text(TextMessage(
             phone_number_id="PHONE_NUMBER_ID",
             to="5511999999999",
@@ -536,24 +546,22 @@ except GraphApiError as e:
 ```python
 from whatsapp_cloud_api import WhatsAppClient
 
-# Default: graph.facebook.com, v23.0, HTTP/2, 30s timeout
-client = WhatsAppClient(access_token="TOKEN")
+# Default: api.kapso.ai, v23.0, HTTP/2, 30s timeout
+client = WhatsAppClient(access_token="YOUR_KAPSO_API_KEY")
 
-# Custom configuration
+# Custom timeout
 client = WhatsAppClient(
-    access_token="TOKEN",
-    base_url="https://graph.facebook.com",
-    graph_version="v23.0",
+    access_token="YOUR_KAPSO_API_KEY",
     timeout=60.0,
 )
 
 # Bring your own httpx client
 import httpx
 custom_http = httpx.AsyncClient(http2=True, timeout=60.0)
-client = WhatsAppClient(access_token="TOKEN", http_client=custom_http)
+client = WhatsAppClient(access_token="YOUR_KAPSO_API_KEY", http_client=custom_http)
 
 # Always use as async context manager
-async with WhatsAppClient(access_token="TOKEN") as client:
+async with WhatsAppClient(access_token="YOUR_KAPSO_API_KEY") as client:
     await client.messages.send_text(...)
 ```
 

{whatsapp_cloud_api_py-0.1.1 → whatsapp_cloud_api_py-0.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "whatsapp-cloud-api-py"
-version = "0.1.1"
+version = "0.2.0"
 description = "Async Python SDK for WhatsApp Business Cloud API with Pydantic V2"
 requires-python = ">=3.11"
 license = "MIT"

{whatsapp_cloud_api_py-0.1.1 → whatsapp_cloud_api_py-0.2.0}/src/whatsapp_cloud_api/client.py

@@ -15,8 +15,8 @@ if TYPE_CHECKING:
     from .resources.phone_numbers import PhoneNumbersResource
     from .resources.templates.resource import TemplatesResource
 
-_DEFAULT_BASE_URL = "https://graph.facebook.com"
-_DEFAULT_VERSION = "v23.0"
+_DEFAULT_BASE_URL = "https://api.kapso.ai/meta/whatsapp"
+_DEFAULT_VERSION = "v24.0"
 
 
 class WhatsAppClient:
@@ -71,7 +71,7 @@ class WhatsAppClient:
 
     @property
     def _auth_headers(self) -> dict[str, str]:
-        return {"Authorization": f"Bearer {self._access_token}"}
+        return {"X-API-Key": self._access_token}
 
     # ── core request ─────────────────────────────────────────────
 

{whatsapp_cloud_api_py-0.1.1 → whatsapp_cloud_api_py-0.2.0}/tests/test_client.py

@@ -9,7 +9,7 @@ import respx
 from whatsapp_cloud_api.client import WhatsAppClient
 from whatsapp_cloud_api.errors import GraphApiError
 
-BASE = "https://graph.facebook.com/v23.0"
+BASE = "https://api.kapso.ai/meta/whatsapp/v24.0"
 
 
 class TestUrl:
@@ -28,11 +28,11 @@ class TestUrl:
 
     def test_custom_base_url(self):
         client = WhatsAppClient(access_token="tok", base_url="https://custom.api.com/")
-        assert client._url("path") == "https://custom.api.com/v23.0/path"
+        assert client._url("path") == "https://custom.api.com/v24.0/path"
 
     def test_custom_version(self):
         client = WhatsAppClient(access_token="tok", graph_version="v22.0")
-        assert client._url("path") == "https://graph.facebook.com/v22.0/path"
+        assert client._url("path") == "https://api.kapso.ai/meta/whatsapp/v22.0/path"
 
 
 class TestRequest:
@@ -78,7 +78,7 @@ class TestRequest:
         )
         async with WhatsAppClient(access_token="my-token") as client:
             await client.get("test")
-        assert route.calls[0].request.headers["authorization"] == "Bearer my-token"
+        assert route.calls[0].request.headers["x-api-key"] == "my-token"
 
     @respx.mock
     async def test_post_with_json(self):
@@ -163,7 +163,7 @@ class TestFetchMethods:
         async with WhatsAppClient(access_token="secret-tok") as client:
             resp = await client.fetch_authenticated(url)
         assert resp.content == b"bytes"
-        assert route.calls[0].request.headers["authorization"] == "Bearer secret-tok"
+        assert route.calls[0].request.headers["x-api-key"] == "secret-tok"
 
 
 class TestCachedProperties:

{whatsapp_cloud_api_py-0.1.1 → whatsapp_cloud_api_py-0.2.0}/tests/test_messages_resource.py

@@ -22,7 +22,7 @@ from whatsapp_cloud_api.resources.messages.models import (
 )
 from whatsapp_cloud_api.resources.messages.resource import MessagesResource
 
-BASE = "https://graph.facebook.com/v23.0"
+BASE = "https://api.kapso.ai/meta/whatsapp/v24.0"
 PHONE = "1234567890"
 MSG_URL = f"{BASE}/{PHONE}/messages"
 

{whatsapp_cloud_api_py-0.1.1 → whatsapp_cloud_api_py-0.2.0}/tests/test_resources_flows.py

@@ -14,7 +14,7 @@ from whatsapp_cloud_api.resources.flows import (
     UpdateFlowAssetInput,
 )
 
-BASE = "https://graph.facebook.com/v23.0"
+BASE = "https://api.kapso.ai/meta/whatsapp/v24.0"
 WABA = "waba123"
 
 

{whatsapp_cloud_api_py-0.1.1 → whatsapp_cloud_api_py-0.2.0}/tests/test_resources_media.py

@@ -8,7 +8,7 @@ import respx
 from whatsapp_cloud_api.client import WhatsAppClient
 from whatsapp_cloud_api.resources.media import MediaResource, MediaUploadInput
 
-BASE = "https://graph.facebook.com/v23.0"
+BASE = "https://api.kapso.ai/meta/whatsapp/v24.0"
 
 
 class TestUpload:
@@ -155,4 +155,4 @@ class TestDownload:
         assert data == b"auth-bytes"
         # With use_auth=True, the first call already has auth headers
         req = cdn_route.calls[0].request
-        assert "Bearer tok" in req.headers.get("authorization", "")
+        assert req.headers.get("x-api-key") == "tok"

{whatsapp_cloud_api_py-0.1.1 → whatsapp_cloud_api_py-0.2.0}/tests/test_resources_phone_numbers.py

@@ -17,7 +17,7 @@ from whatsapp_cloud_api.resources.phone_numbers import (
     VerifyCodeInput,
 )
 
-BASE = "https://graph.facebook.com/v23.0"
+BASE = "https://api.kapso.ai/meta/whatsapp/v24.0"
 PHONE = "1234567890"
 
 

{whatsapp_cloud_api_py-0.1.1 → whatsapp_cloud_api_py-0.2.0}/tests/test_resources_templates.py

@@ -15,7 +15,7 @@ from whatsapp_cloud_api.resources.templates.models import (
 )
 from whatsapp_cloud_api.resources.templates.resource import TemplatesResource
 
-BASE = "https://graph.facebook.com/v23.0"
+BASE = "https://api.kapso.ai/meta/whatsapp/v24.0"
 WABA = "waba123"