maacgo-sms 0.1.0

MAAC Go SMS — send Taiwan SMS in 3 lines from Python. NCC-compliant, NT$50 free trial.

maacgo-sms · Python SDK

Taiwan-first SMS API. Send SMS in 3 lines of Python.

pip install maacgo-sms

Quickstart

from maacgo_sms import Maacgo

sms = Maacgo("sk_live_...")

r = sms.send(
    to="[phone]",
    body="【你的品牌】驗證碼 123456，5 分鐘內有效。",
)
print(r["id"], r["status"])

Context manager

with Maacgo("sk_live_...") as sms:
    sms.send(to="[phone]", body="...")

Batch send

sms.broadcast(
    name="週年慶",
    body="【你的品牌】週年慶 5 折起！",
    recipients=["[phone]", "[phone]"],
)

Errors

from maacgo_sms import Maacgo, MaacgoError

try:
    sms.send(to="09XXX", body="【...】Hi")
except MaacgoError as e:
    if e.data.get("error") == "ncc_blocked":
        print("NCC compliance failed:", e.data.get("issues"))
    elif e.data.get("error") == "insufficient_balance":
        print("Please top up")

Webhooks (Django / Flask / FastAPI)

import hmac, hashlib, os
from fastapi import FastAPI, Request, HTTPException

app = FastAPI()
SECRET = os.environ["CRESCLAB_WEBHOOK_SECRET"]

@app.post("/webhooks/cresclab")
async def webhook(request: Request):
    body = await request.body()
    sig = request.headers.get("x-cresclab-signature", "")
    expected = hmac.new(SECRET.encode(), body, hashlib.sha256).hexdigest()
    if not hmac.compare_digest(sig, expected):
        raise HTTPException(401)

    payload = await request.json()
    if payload["event"] == "sms.delivered":
        mark_delivered(payload["data"]["id"])
    return {"received": True}

License

MIT