Njiwa for Python

pip install njiwa

from njiwa import Njiwa

njiwa = Njiwa("sk_live_...")
njiwa.send("254712345678", document="invoice.pdf", caption="Your invoice")

A local file path uploads automatically. A URL passes through. A med_ id passes through. You do not have to know which is happening.

njiwa.send("0712345678", text="Hello")                       # local number, fine
njiwa.send("254712345678", image="https://example.com/a.jpg")
njiwa.send("254712345678", location={"lat": -1.29, "lng": 36.82})

result = njiwa.send("254712345678", text="Hi", wait=True)     # block for the outcome
print(result["status"])

Anything that must not happen twice takes an idempotency key:

njiwa.send("254712345678", document="invoice.pdf", idempotency_key="invoice-4417")

Verifying a webhook:

if not Njiwa.verify_webhook(secret, request.body, request.headers["X-Njiwa-Signature"]):
    return 400

Errors carry a stable code and a link to the page explaining the fix:

from njiwa import NjiwaError

try:
    njiwa.send("254712345678", document="huge.pdf")
except NjiwaError as e:
    print(e.code, e, e.docs)

Docs at https://docs.njiwa.upeo.ai UPEO.AI. 0116888777 on WhatsApp. hello@upeo.ai