wazen 0.3.0

Official Python SDK for the Wazen WhatsApp API

Wazen Python SDK

Official Python SDK for the Wazen WhatsApp API.

Installation

pip install wazen

Quick Start

from wazen import Wazen

wazen = Wazen("wz_your_api_key")

# Send a message
message = wazen.messages.send("session-id", to="[phone]", type="text", content="Hello from Wazen!")

# List sessions
sessions = wazen.sessions.list()

# Check if a number is on WhatsApp
result = wazen.contacts.check("session-id", phone="[phone]")

Async Usage

from wazen import AsyncWazen

wazen = AsyncWazen("wz_your_api_key")

message = await wazen.messages.send("session-id", to="[phone]", type="text", content="Hello!")

Resources

All resources are accessible as properties on the client instance.

Sessions

wazen.sessions.create()
wazen.sessions.list()
wazen.sessions.get("session-id")
wazen.sessions.delete("session-id")
wazen.sessions.restart("session-id")
wazen.sessions.get_qr("session-id")
wazen.sessions.factory_reset("session-id")

Messages

# Send text
wazen.messages.send("session-id", to="[phone]", type="text", content="Hello!")

# Send image
wazen.messages.send("session-id", to="[phone]", type="image", media_url="https://example.com/photo.jpg")

# Get message history
wazen.messages.list("session-id", direction="outgoing", limit=10)

# Get single message
wazen.messages.get("session-id", "message-id")

Groups

wazen.groups.list("session-id")
wazen.groups.create("session-id", subject="Team Chat", participants=["[phone]"])
wazen.groups.get("session-id", "group-id")
wazen.groups.update("session-id", "group-id", subject="New Name")
wazen.groups.leave("session-id", "group-id")
wazen.groups.manage_participants("session-id", "group-id", action="add", participants=["+0987654321"])
wazen.groups.send_message("session-id", "group-id", type="text", content="Hello group!")

Channels

wazen.channels.create("session-id", name="Product Updates", description="Latest news")
wazen.channels.send_message("session-id", "channel-id", type="text", content="New release!")

Contacts

# Check single number
wazen.contacts.check("session-id", phone="[phone]")

# Bulk check
wazen.contacts.bulk_check("session-id", phones=["[phone]", "+0987654321"])

Warming

wazen.warming.start("session-id", contacts=[
    {"phone": "[phone]", "name": "Alice"},
    {"phone": "+0987654321"},
])
wazen.warming.get_status("session-id")
wazen.warming.pause("session-id")
wazen.warming.resume("session-id")
wazen.warming.cancel("session-id")

Webhooks

wazen.webhooks.create(
    url="https://your-app.com/webhooks/wazen",
    events=["message.received", "message.delivered"],
)
wazen.webhooks.list()
wazen.webhooks.update("webhook-id", enabled=False)
wazen.webhooks.delete("webhook-id")
wazen.webhooks.test("webhook-id")
wazen.webhooks.get_logs("webhook-id")

Account

account = wazen.account.get()
usage = wazen.account.get_usage()

API Keys

key = wazen.api_keys.create(name="new-key")
wazen.api_keys.list()
wazen.api_keys.revoke("key-id")

Configuration

wazen = Wazen(
    "wz_your_api_key",
    base_url="https://wazen.dev/api/v1",  # default
    timeout=30,                            # default, in seconds
)

Error Handling

from wazen import Wazen, WazenApiError

try:
    wazen.messages.send("session-id", to="[phone]", type="text", content="Hi")
except WazenApiError as e:
    print(e.status_code)  # HTTP status code
    print(e.error_code)   # API error code
    print(e.message)      # Error message

Requirements

• Python 3.10 or later
• A Wazen account with an active subscription
• An API key from your Dashboard

Links

• API Documentation
• Dashboard
• TypeScript SDK
• .NET SDK

License

MIT