Zaptilo WhatsApp Business API SDK for Python

Official Python SDK for the Zaptilo WhatsApp Business API. Send text, media, and template messages via WhatsApp with a simple, clean API.

Zero dependencies — uses only Python standard library.

Installation

pip install zaptilo-whatsapp

Requirements: Python 3.7+

Quick Start

from zaptilo_whatsapp import Zaptilo

client = Zaptilo("YOUR_API_TOKEN")

# Send a text message
client.send_message("919876543210", "Hello from Zaptilo!")

Get your API token from the Zaptilo Dashboard under Developer Tools > Access Tokens.

Usage

Send Text Message

client.send_message("919876543210", "Hello! Your order has been confirmed.")

Send Template Message

client.send_template(
    number="919876543210",
    template_name="order_update",
    language="en",
    body_values=["John", "Shipped"],
    header_values=["#ORD-1234"],
)

Send Media Message

# Send image
client.send_media("919876543210", "https://example.com/photo.jpg", "image", "Check this out!")

# Send document
client.send_media("919876543210", "https://example.com/invoice.pdf", "document", "Your invoice")

# Send video
client.send_media("919876543210", "https://example.com/video.mp4", "video")

List Templates

result = client.get_templates()

for template in result["data"]:
    print(f"{template['name']} - {template['status']}")

Check Credit Balance

result = client.get_balance()
print(f"Balance: {result['balance']}")

Verify API Token

result = client.verify()
print(result["message"])  # "API key is valid and active"

Error Handling

from zaptilo_whatsapp import Zaptilo, ZaptiloException

client = Zaptilo("YOUR_API_TOKEN")

try:
    client.send_message("919876543210", "Hello!")
except ZaptiloException as e:
    print(f"Error: {e}")
    print(f"Status code: {e.status_code}")

Configuration

# Custom base URL (for self-hosted or staging)
client = Zaptilo("YOUR_TOKEN", base_url="https://your-domain.com")

# Custom timeout (default: 30 seconds)
client = Zaptilo("YOUR_TOKEN", timeout=60)

API Reference

Django / Flask Integration

# Django - settings.py
ZAPTILO_API_TOKEN = os.environ.get("ZAPTILO_API_TOKEN")

# In your view
from zaptilo_whatsapp import Zaptilo
from django.conf import settings

client = Zaptilo(settings.ZAPTILO_API_TOKEN)
client.send_message("919876543210", "Hello from Django!")

# Flask
import os
from zaptilo_whatsapp import Zaptilo

client = Zaptilo(os.environ["ZAPTILO_API_TOKEN"])

@app.route("/notify")
def notify():
    client.send_message("919876543210", "Hello from Flask!")
    return "Sent!"

Links

• Zaptilo Website
• API Documentation
• Dashboard / Sign Up
• Node.js SDK
• PHP SDK

License

MIT