gaviwhatsapp 0.1.0

WhatsApp API SDK for Python — send messages, templates, media, and broadcasts

gaviwhatsapp

WhatsApp API SDK for Python. Send messages, templates, media, and broadcasts.

Install

pip install gaviwhatsapp

Quick Start

import os
from gaviwhatsapp import WhatsApp

wa = WhatsApp(api_key=os.environ["GAVIVENTURES_API_KEY"])

# Send a text message
wa.send(to="[phone]", text="Hello!")

# Send a template message
wa.send_template(
    to="[phone]",
    template="order_confirmation",
    variables={"1": "ORD-1234", "2": "$49.99"},
)

# Send media
wa.send_media(
    to="[phone]",
    type="image",
    url="https://example.com/photo.jpg",
    caption="Your receipt",
)

# List templates
result = wa.get_templates()
print(result["templates"])

# Send broadcast
wa.broadcast(
    recipients=["[phone]", "[phone]"],
    template="promo_offer",
)

# Register webhook
webhook = wa.register_webhook(
    url="https://myapp.com/api/webhook",
    events=["message.received"],
)
print(webhook["secret"])  # Save for HMAC verification

API Reference

Method	Description
wa.send(to, text)	Send a text message
wa.send_template(to, template, language?, variables?)	Send a template message
wa.send_media(to, type, url, caption?, filename?)	Send media
wa.get_messages(phone?, limit?)	Get message history
wa.get_templates(sync?)	List available templates
wa.broadcast(recipients, template, language?, variables_per_recipient?)	Send to multiple recipients
wa.register_webhook(url, events?)	Register a webhook endpoint
wa.list_webhooks()	List registered webhooks

Get an API Key

Sign up at gaviventures.com and go to Settings > API Keys.