Send a WhatsApp message with Python

# pip install requests
import os
import time
import requests

BASE_URL = "https://public.leadpattern.com"
API_KEY = os.environ["LEADPATTERN_API_KEY"]  # YOUR_API_KEY — keep it on the server

HEADERS = {
    "Authorization": API_KEY,  # the raw key, NO "Bearer " prefix
    "Content-Type": "application/json",
}



class LeadPatternError(Exception):
    def __init__(self, status, body, retry_after=None):
        super().__init__(f"HTTP {status}: {body}")
        self.status, self.body, self.retry_after = status, body, retry_after


def handle(r):
    """Return data on 201, otherwise raise with the status, body and Retry-After."""
    if r.status_code == 201:
        return r.json()["data"]          # {"messageId": ...} or {"messages": [...]}
    try:
        body = r.json()                  # e.g. {"type": "error", "code": 403, "message": "..."}
    except ValueError:
        body = r.text
    raise LeadPatternError(r.status_code, body, r.headers.get("Retry-After"))


# Optional: check connectivity (public endpoint, no key needed)
print(requests.get(f"{BASE_URL}/health-check", timeout=10).status_code)

def send_template(to, template_name, language, placeholders):
    """Send an approved template. placeholders = [{"name": "..."}, {"order_id": "..."}]"""
    payload = {
        "messages": [
            {
                "to": to,  # E.164 with country code, e.g. "+91XXXXXXXXXX"
                "content": {
                    "templateName": template_name,
                    "language": language,
                    "templateData": {"body": {"placeholders": placeholders}},
                },
            }
        ]
    }
    r = requests.post(f"{BASE_URL}/v2/whatsapp/message/template",
                      json=payload, headers=HEADERS, timeout=30)
    return handle(r)


result = send_template("+91XXXXXXXXXX", "order_confirmation", "en",
                       [{"name": "Customer"}, {"order_id": "ORD-1234"}])
print(result["messages"][0]["messageId"])

{
  "type": "success",
  "data": {
    "messages": [
      {
        "status": "SENT",
        "recipient": "91XXXXXXXXXX",
        "messageId": "wamid.abc123"
      }
    ]
  }
}

def send_text(to, text, preview_url=False):
    """Free-form text — only works within 24 hours of the customer's last message."""
    payload = {"to": to, "content": {"text": text, "previewUrl": preview_url}}
    r = requests.post(f"{BASE_URL}/whatsapp/message/text",
                      json=payload, headers=HEADERS, timeout=30)
    return handle(r)


print(send_text("+91XXXXXXXXXX", "Hello! How can I help you?")["messageId"])

{
  "type": "success",
  "data": {
    "messageId": "wamid.abc123",
    "status": "sent",
    "recipient": "91XXXXXXXXXX"
  }
}

def with_retry(fn, *args, attempts=3):
    """Retry only on 429 (rate limit), waiting for Retry-After."""
    for i in range(attempts):
        try:
            return fn(*args)
        except LeadPatternError as e:
            if e.status != 429 or i == attempts - 1:
                raise
            time.sleep(int(e.retry_after or 60))  # wait for Retry-After (docs: retry after 60 s)


try:
    with_retry(send_text, "+91XXXXXXXXXX", "Your order has shipped.")
except LeadPatternError as e:
    if e.status == 403:
        # 24-hour window closed (or IP / plan restriction) -> send a template instead
        with_retry(send_template, "+91XXXXXXXXXX", "order_confirmation", "en",
                   [{"name": "Customer"}, {"order_id": "ORD-1234"}])
    else:
        raise

{
  "type": "error",
  "code": 403,
  "message": "Cannot send a free-form message. The 24-hour customer service window has expired. You may only send template messages after 24 hours of the last user message."
}