wazzapi 0.1.0__py3-none-any.whl

wazzapi/models/webhooks.py

@@ -0,0 +1,87 @@
+from __future__ import annotations
+
+from datetime import datetime
+from typing import Literal
+
+from .base import WazzapiModel
+
+MessageWebhookEvent = Literal[
+    "message.received",
+    "message.sent",
+    "message.delivered",
+    "message.read",
+    "message.failed",
+]
+DeviceWebhookEvent = Literal["device.connected", "device.disconnected"]
+WebhookEvent = MessageWebhookEvent | DeviceWebhookEvent
+
+
+class PublicWebhookMessageData(WazzapiModel):
+    message_id: str
+    whatsapp_message_id: str | None = None
+    phone_number: str
+    account_name: str | None = None
+    status: str
+    direction: str
+    message_type: str
+    failure_reason: str | None = None
+    reason: str | None = None
+    sent_at: datetime | None = None
+    delivered_at: datetime | None = None
+    read_at: datetime | None = None
+    failed_at: datetime | None = None
+    whatsapp_account_id: str
+    campaign_id: str | None = None
+    batch_id: str | None = None
+
+
+class PublicWebhookDeviceData(WazzapiModel):
+    message_id: str
+    whatsapp_message_id: str | None = None
+    phone_number: str
+    account_name: str | None = None
+    status: str
+    direction: str
+    message_type: str
+    failure_reason: str | None = None
+    reason: str | None = None
+    sent_at: datetime | None = None
+    delivered_at: datetime | None = None
+    read_at: datetime | None = None
+    failed_at: datetime | None = None
+    whatsapp_account_id: str
+    campaign_id: str | None = None
+    batch_id: str | None = None
+
+
+class PublicMessageWebhook(WazzapiModel):
+    id: str
+    event_type: MessageWebhookEvent
+    timestamp: datetime
+    organization_id: str
+    webhook_id: str
+    data: PublicWebhookMessageData
+
+
+class PublicDeviceWebhook(WazzapiModel):
+    id: str
+    event_type: DeviceWebhookEvent
+    timestamp: datetime
+    organization_id: str
+    webhook_id: str
+    data: PublicWebhookDeviceData
+
+
+WebhookPayload = PublicMessageWebhook | PublicDeviceWebhook
+
+
+__all__ = [
+    "DeviceWebhookEvent",
+    "MessageWebhookEvent",
+    "PublicDeviceWebhook",
+    "PublicMessageWebhook",
+    "PublicWebhookDeviceData",
+    "PublicWebhookMessageData",
+    "WebhookEvent",
+    "WebhookPayload",
+]

wazzapi/resources/__init__.py

@@ -0,0 +1,5 @@
+from .contacts import ContactsResource
+from .messages import MessagesResource
+from .templates import TemplatesResource
+
+__all__ = ["ContactsResource", "MessagesResource", "TemplatesResource"]

wazzapi/resources/base.py

@@ -0,0 +1,14 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from ..client import WazzapiClient
+
+
+class BaseResource:
+    def __init__(self, client: "WazzapiClient") -> None:
+        self._client = client
+
+
+__all__ = ["BaseResource"]

wazzapi/resources/contacts.py

@@ -0,0 +1,222 @@
+from __future__ import annotations
+
+from typing import Any
+
+from .. import models
+from .base import BaseResource
+
+
+class ContactsResource(BaseResource):
+    def list(
+        self,
+        *,
+        limit: int | None = None,
+        offset: int | None = None,
+        search: str | None = None,
+        source: str | None = None,
+        group_id: str | None = None,
+        sort_by: str | None = None,
+        sort_order: str | None = None,
+    ) -> models.ContactListResponse:
+        return self._client._request(
+            "GET",
+            "/api/v1/contacts",
+            params={
+                "limit": limit,
+                "offset": offset,
+                "search": search,
+                "source": source,
+                "group_id": group_id,
+                "sort_by": sort_by,
+                "sort_order": sort_order,
+            },
+            response_model=models.ContactListResponse,
+        )
+
+    def create(
+        self,
+        payload: models.ContactCreateRequest | dict[str, Any],
+    ) -> models.ContactResponse:
+        return self._client._request(
+            "POST",
+            "/api/v1/contacts",
+            json_body=payload,
+            response_model=models.ContactResponse,
+        )
+
+    def bulk_delete(
+        self,
+        payload: models.BulkDeleteRequest | dict[str, Any],
+    ) -> models.BulkDeleteResponse:
+        return self._client._request(
+            "POST",
+            "/api/v1/contacts/bulk-delete",
+            json_body=payload,
+            response_model=models.BulkDeleteResponse,
+        )
+
+    def list_groups(
+        self,
+        *,
+        limit: int | None = None,
+        offset: int | None = None,
+    ) -> models.ContactGroupListResponse:
+        return self._client._request(
+            "GET",
+            "/api/v1/contacts/groups",
+            params={"limit": limit, "offset": offset},
+            response_model=models.ContactGroupListResponse,
+        )
+
+    def create_group(
+        self,
+        payload: models.ContactGroupCreateRequest | dict[str, Any],
+    ) -> models.ContactGroupItem:
+        return self._client._request(
+            "POST",
+            "/api/v1/contacts/groups",
+            json_body=payload,
+            response_model=models.ContactGroupItem,
+        )
+
+    def get_group(
+        self,
+        group_id: str,
+        *,
+        limit: int | None = None,
+        offset: int | None = None,
+    ) -> models.ContactGroupMembersResponse:
+        return self._client._request(
+            "GET",
+            f"/api/v1/contacts/groups/{group_id}",
+            params={"limit": limit, "offset": offset},
+            response_model=models.ContactGroupMembersResponse,
+        )
+
+    def update_group(
+        self,
+        group_id: str,
+        payload: models.ContactGroupUpdateRequest | dict[str, Any],
+    ) -> models.ContactGroupItem:
+        return self._client._request(
+            "PATCH",
+            f"/api/v1/contacts/groups/{group_id}",
+            json_body=payload,
+            response_model=models.ContactGroupItem,
+        )
+
+    def delete_group(self, group_id: str) -> None:
+        self._client._request("DELETE", f"/api/v1/contacts/groups/{group_id}")
+        return None
+
+    def add_to_group(
+        self,
+        group_id: str,
+        payload: models.AddToGroupRequest | dict[str, Any],
+    ) -> models.AddToGroupResponse:
+        return self._client._request(
+            "POST",
+            f"/api/v1/contacts/groups/{group_id}/members",
+            json_body=payload,
+            response_model=models.AddToGroupResponse,
+        )
+
+    def remove_from_group(
+        self,
+        group_id: str,
+        payload: models.RemoveFromGroupRequest | dict[str, Any],
+    ) -> models.AddToGroupResponse:
+        return self._client._request(
+            "DELETE",
+            f"/api/v1/contacts/groups/{group_id}/members",
+            json_body=payload,
+            response_model=models.AddToGroupResponse,
+        )
+
+    def import_csv(
+        self,
+        payload: models.CSVImportRequest | dict[str, Any],
+    ) -> models.CSVImportResponse:
+        return self._client._request(
+            "POST",
+            "/api/v1/contacts/import/csv",
+            json_body=payload,
+            response_model=models.CSVImportResponse,
+        )
+
+    def export_csv(
+        self,
+        *,
+        group_id: str | None = None,
+        source: str | None = None,
+    ) -> models.CSVExportResponse:
+        return self._client._request(
+            "GET",
+            "/api/v1/contacts/export/csv",
+            params={"group_id": group_id, "source": source},
+            response_model=models.CSVExportResponse,
+        )
+
+    def sync(
+        self,
+        payload: models.ContactSyncRequest | dict[str, Any],
+    ) -> models.ContactSyncResponse:
+        return self._client._request(
+            "POST",
+            "/api/v1/contacts/sync",
+            json_body=payload,
+            response_model=models.ContactSyncResponse,
+        )
+
+    def sync_status(self) -> list[models.ContactSyncStatusResponse]:
+        return self._client._request(
+            "GET",
+            "/api/v1/contacts/sync/status",
+            response_model=list[models.ContactSyncStatusResponse],
+        )
+
+    def sync_history(
+        self,
+        *,
+        limit: int | None = None,
+        offset: int | None = None,
+    ) -> models.ContactSyncHistoryResponse:
+        return self._client._request(
+            "GET",
+            "/api/v1/contacts/sync/history",
+            params={"limit": limit, "offset": offset},
+            response_model=models.ContactSyncHistoryResponse,
+        )
+
+    def import_template(self) -> dict[str, Any]:
+        return self._client._request(
+            "GET",
+            "/api/v1/contacts/import/template",
+            response_model=dict[str, Any],
+        )
+
+    def get(self, contact_id: str) -> models.ContactResponse:
+        return self._client._request(
+            "GET",
+            f"/api/v1/contacts/{contact_id}",
+            response_model=models.ContactResponse,
+        )
+
+    def update(
+        self,
+        contact_id: str,
+        payload: models.ContactUpdateRequest | dict[str, Any],
+    ) -> models.ContactResponse:
+        return self._client._request(
+            "PATCH",
+            f"/api/v1/contacts/{contact_id}",
+            json_body=payload,
+            response_model=models.ContactResponse,
+        )
+
+    def delete(self, contact_id: str) -> None:
+        self._client._request("DELETE", f"/api/v1/contacts/{contact_id}")
+        return None
+
+
+__all__ = ["ContactsResource"]

wazzapi/resources/messages.py

@@ -0,0 +1,174 @@
+from __future__ import annotations
+
+from typing import Any
+
+from .. import models
+from .base import BaseResource
+
+
+class MessagesResource(BaseResource):
+    def lookup(self, whatsapp_message_id: str) -> models.MessageResponse:
+        return self._client._request(
+            "GET",
+            "/api/v1/messages/lookup",
+            params={"whatsapp_message_id": whatsapp_message_id},
+            response_model=models.MessageResponse,
+        )
+
+    def list(
+        self,
+        *,
+        limit: int | None = None,
+        offset: int | None = None,
+        status: str | None = None,
+        direction: str | None = None,
+        whatsapp_account_id: str | None = None,
+        search: str | None = None,
+        sort_by: str | None = None,
+        sort_order: str | None = None,
+    ) -> models.MessageListResponse:
+        return self._client._request(
+            "GET",
+            "/api/v1/messages",
+            params={
+                "limit": limit,
+                "offset": offset,
+                "status": status,
+                "direction": direction,
+                "whatsapp_account_id": whatsapp_account_id,
+                "search": search,
+                "sort_by": sort_by,
+                "sort_order": sort_order,
+            },
+            response_model=models.MessageListResponse,
+        )
+
+    def get(self, message_id: str) -> models.MessageResponse:
+        return self._client._request(
+            "GET",
+            f"/api/v1/messages/{message_id}",
+            response_model=models.MessageResponse,
+        )
+
+    def stats(self) -> models.MessageStatsResponse:
+        return self._client._request(
+            "GET",
+            "/api/v1/messages/stats/summary",
+            response_model=models.MessageStatsResponse,
+        )
+
+    def send(
+        self,
+        payload: models.SendMessageRequest | dict[str, Any],
+    ) -> models.SendMessageResponse:
+        return self._client._request(
+            "POST",
+            "/api/v1/messages/send",
+            json_body=payload,
+            response_model=models.SendMessageResponse,
+        )
+
+    def send_image(
+        self,
+        payload: models.SendMessageRequest | dict[str, Any],
+    ) -> models.SendMessageResponse:
+        return self._client._request(
+            "POST",
+            "/api/v1/messages/send/image",
+            json_body=payload,
+            response_model=models.SendMessageResponse,
+        )
+
+    def send_video(
+        self,
+        payload: models.SendMessageRequest | dict[str, Any],
+    ) -> models.SendMessageResponse:
+        return self._client._request(
+            "POST",
+            "/api/v1/messages/send/video",
+            json_body=payload,
+            response_model=models.SendMessageResponse,
+        )
+
+    def send_voice(
+        self,
+        payload: models.SendMessageRequest | dict[str, Any],
+    ) -> models.SendMessageResponse:
+        return self._client._request(
+            "POST",
+            "/api/v1/messages/send/voice",
+            json_body=payload,
+            response_model=models.SendMessageResponse,
+        )
+
+    def send_document(
+        self,
+        payload: models.SendMessageRequest | dict[str, Any],
+    ) -> models.SendMessageResponse:
+        return self._client._request(
+            "POST",
+            "/api/v1/messages/send/document",
+            json_body=payload,
+            response_model=models.SendMessageResponse,
+        )
+
+    def send_location(
+        self,
+        payload: models.SendMessageRequest | dict[str, Any],
+    ) -> models.SendMessageResponse:
+        return self._client._request(
+            "POST",
+            "/api/v1/messages/send/location",
+            json_body=payload,
+            response_model=models.SendMessageResponse,
+        )
+
+    def send_contact(
+        self,
+        payload: models.SendMessageRequest | dict[str, Any],
+    ) -> models.SendMessageResponse:
+        return self._client._request(
+            "POST",
+            "/api/v1/messages/send/contact",
+            json_body=payload,
+            response_model=models.SendMessageResponse,
+        )
+
+    def retry(self, message_id: str) -> models.RetryMessageResponse:
+        return self._client._request(
+            "POST",
+            f"/api/v1/messages/{message_id}/retry",
+            response_model=models.RetryMessageResponse,
+        )
+
+    def cancel(self, message_id: str) -> models.CancelMessageResponse:
+        return self._client._request(
+            "POST",
+            f"/api/v1/messages/{message_id}/cancel",
+            response_model=models.CancelMessageResponse,
+        )
+
+    def send_buttons(
+        self,
+        payload: models.ButtonReplyRequest | dict[str, Any],
+    ) -> models.InteractiveMessageResponse:
+        return self._client._request(
+            "POST",
+            "/api/v1/messages/send/interactive/buttons",
+            json_body=payload,
+            response_model=models.InteractiveMessageResponse,
+        )
+
+    def send_list(
+        self,
+        payload: models.ListReplyRequest | dict[str, Any],
+    ) -> models.InteractiveMessageResponse:
+        return self._client._request(
+            "POST",
+            "/api/v1/messages/send/interactive/list",
+            json_body=payload,
+            response_model=models.InteractiveMessageResponse,
+        )
+
+
+__all__ = ["MessagesResource"]

wazzapi/resources/templates.py

@@ -0,0 +1,87 @@
+from __future__ import annotations
+
+from typing import Any
+
+from .. import models
+from .base import BaseResource
+
+
+class TemplatesResource(BaseResource):
+    def builtin_variables(self) -> models.BuiltinVariablesResponse:
+        return self._client._request(
+            "GET",
+            "/api/v1/templates/builtin-variables",
+            response_model=models.BuiltinVariablesResponse,
+        )
+
+    def list(
+        self,
+        *,
+        limit: int | None = None,
+        offset: int | None = None,
+        category: str | None = None,
+        search: str | None = None,
+        sort_by: str | None = None,
+        sort_order: str | None = None,
+    ) -> models.TemplateListResponse:
+        return self._client._request(
+            "GET",
+            "/api/v1/templates",
+            params={
+                "limit": limit,
+                "offset": offset,
+                "category": category,
+                "search": search,
+                "sort_by": sort_by,
+                "sort_order": sort_order,
+            },
+            response_model=models.TemplateListResponse,
+        )
+
+    def create(
+        self,
+        payload: models.TemplateCreateRequest | dict[str, Any],
+    ) -> models.TemplateResponse:
+        return self._client._request(
+            "POST",
+            "/api/v1/templates",
+            json_body=payload,
+            response_model=models.TemplateResponse,
+        )
+
+    def get(self, template_id: str) -> models.TemplateResponse:
+        return self._client._request(
+            "GET",
+            f"/api/v1/templates/{template_id}",
+            response_model=models.TemplateResponse,
+        )
+
+    def update(
+        self,
+        template_id: str,
+        payload: models.TemplateUpdateRequest | dict[str, Any],
+    ) -> models.TemplateResponse:
+        return self._client._request(
+            "PATCH",
+            f"/api/v1/templates/{template_id}",
+            json_body=payload,
+            response_model=models.TemplateResponse,
+        )
+
+    def delete(self, template_id: str) -> None:
+        self._client._request("DELETE", f"/api/v1/templates/{template_id}")
+        return None
+
+    def preview(
+        self,
+        payload: models.TemplatePreviewRequest | dict[str, Any],
+    ) -> models.TemplatePreviewResponse:
+        return self._client._request(
+            "POST",
+            "/api/v1/templates/preview",
+            json_body=payload,
+            response_model=models.TemplatePreviewResponse,
+        )
+
+
+__all__ = ["TemplatesResource"]