Python SDK

pip install wahooks

from wahooks import WAHooks

client = WAHooks(api_key="wh_...")

# List connections
connections = client.list_connections()

# Send a message
client.send_message(connection_id, chat_id="1234@s.whatsapp.net", text="Hello!")

client = WAHooks(
    api_key="wh_...",
    base_url="https://api.wahooks.com",  # optional, defaults to production
)

with WAHooks(api_key="wh_...") as client:
    connections = client.list_connections()
# HTTP connection closed automatically

# List all active connections
connections = client.list_connections()

# Create a new connection
connection = client.create_connection()

# Get a scannable connection (reuses idle or creates new)
result = client.get_or_create_scannable_connection()
# result["id"], result["status"], result["qr"] (base64 PNG)

# Get connection details
connection = client.get_connection(connection_id)

# Delete a connection
client.delete_connection(connection_id)

# Restart a connection
connection = client.restart_connection(connection_id)

# Get QR code for linking
qr = client.get_qr(connection_id)
# qr["value"] = base64 PNG

# Get recent chats
chats = client.get_chats(connection_id)

# Get WhatsApp profile info
profile = client.get_profile(connection_id)

# Send a text message
result = client.send_message(connection_id, chat_id="1234@s.whatsapp.net", text="Hello!")

# Send an image (by URL)
client.send_image(connection_id, chat_id="1234@s.whatsapp.net", url="https://example.com/photo.jpg", caption="Check this out")

# Send an image (by base64)
client.send_image(connection_id, chat_id="1234@s.whatsapp.net", data="iVBORw0KGgo...", mimetype="image/png")

# Send a document
client.send_document(connection_id, chat_id="1234@s.whatsapp.net", url="https://example.com/report.pdf", filename="report.pdf")

# Send a video
client.send_video(connection_id, chat_id="1234@s.whatsapp.net", url="https://example.com/clip.mp4")

# Send audio
client.send_audio(connection_id, chat_id="1234@s.whatsapp.net", url="https://example.com/voice.ogg")

# Send a location
client.send_location(connection_id, chat_id="1234@s.whatsapp.net", latitude=37.7749, longitude=-122.4194, name="San Francisco")

# Send a contact card
client.send_contact(connection_id, chat_id="1234@s.whatsapp.net", contact_name="John Doe", contact_phone="1234567890")

# List webhooks for a connection
webhooks = client.list_webhooks(connection_id)

# Create a webhook
webhook = client.create_webhook(
    connection_id,
    url="https://example.com/hook",
    events=["message", "message.any"],  # optional, defaults to ["*"]
)

# Update a webhook
updated = client.update_webhook(webhook_id, url="https://example.com/new", active=False)

# Delete a webhook
client.delete_webhook(webhook_id)

# Get delivery logs
logs = client.get_webhook_logs(webhook_id)

# Send a test event
result = client.test_webhook(webhook_id)

# List active tokens
tokens = client.list_tokens()

# Create a new token (raw token shown once)
token = client.create_token("my-token")
print(token["token"])  # "wh_a1b2c3..."

# Revoke a token
client.revoke_token(token_id)

from wahooks import WAHooks, WAHooksError

try:
    client.get_connection("nonexistent-id")
except WAHooksError as e:
    print(e)              # "Connection not found"
    print(e.status_code)  # 404
    print(e.body)         # full error response dict