whatsapp-cloud-api-py 0.1.1__py3-none-any.whl → 0.2.0__py3-none-any.whl

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.dist-info → whatsapp_cloud_api_py-0.2.0.dist-info}/METADATA

@@ -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.dist-info → whatsapp_cloud_api_py-0.2.0.dist-info}/RECORD

@@ -1,5 +1,5 @@
 whatsapp_cloud_api/__init__.py,sha256=Di8XwNmOvQlumpaSdjxnaZcibLlaGA1PQCoNfzE0aTs,2011
-whatsapp_cloud_api/client.py,sha256=GBihkxZtSRtJ8fYuLj0wRr57isf5HnACGc_CE_nGKEw,5727
+whatsapp_cloud_api/client.py,sha256=QBVbFjvM64JoG3YRWRFw8CQYE9Oy0E-ScTOoROnLGEI,5719
 whatsapp_cloud_api/types.py,sha256=ShfVT4R1ks67A06sZCOymPb9p-0Wxd_NSNuvI08DuNU,5790
 whatsapp_cloud_api/errors/__init__.py,sha256=1GvmVFH0PZdS9YnxidzGmSAIPiPLi1GICAKH8hHAYI0,296
 whatsapp_cloud_api/errors/categorize.py,sha256=oc9l8oCLatvw3Ag-Uwl6j8dUc55wlV_I7WmVgW112zA,2019
@@ -23,7 +23,7 @@ whatsapp_cloud_api/utils/case.py,sha256=Vu2LH15ZuCKqfXZdRn1fPk-ctmQgSaqC3_wz4kwD
 whatsapp_cloud_api/webhooks/__init__.py,sha256=wKf4IE-exZXQ_xUwhkf4J54e7-EGOkvoASmp2Uv5sM0,131
 whatsapp_cloud_api/webhooks/normalize.py,sha256=8tTAmGRvzZ15AmuWXBphOlmoomM86e3SfVpKJKqATmY,2633
 whatsapp_cloud_api/webhooks/verify.py,sha256=DAA2vHtm2vB9AthDZrER6b3jZTU31CaDVUnnvRvOKg0,1033
-whatsapp_cloud_api_py-0.1.1.dist-info/METADATA,sha256=O6IM8STdUUtF5NHSXzYpj36A5hczOrs6sCXNqd15DbA,18857
-whatsapp_cloud_api_py-0.1.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-whatsapp_cloud_api_py-0.1.1.dist-info/licenses/LICENSE,sha256=x8Z_8RMIgoi1dz7Wl4v_0OdmLI-EHdc3kJtE4PbaFT4,1062
-whatsapp_cloud_api_py-0.1.1.dist-info/RECORD,,
+whatsapp_cloud_api_py-0.2.0.dist-info/METADATA,sha256=Xv2-P9pHAKwljtYwr5hhowwYRG0KfnNGKQ1iEkz--38,19280
+whatsapp_cloud_api_py-0.2.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+whatsapp_cloud_api_py-0.2.0.dist-info/licenses/LICENSE,sha256=x8Z_8RMIgoi1dz7Wl4v_0OdmLI-EHdc3kJtE4PbaFT4,1062
+whatsapp_cloud_api_py-0.2.0.dist-info/RECORD,,