Send WhatsApp with FastAPI

mkdir bird-whatsapp-fastapi
cd bird-whatsapp-fastapi
python3 -m venv .venv
source .venv/bin/activate
python -m pip install messagebird-sdk "fastapi[standard]"
export BIRD_API_KEY="YOUR_API_KEY"
export BIRD_TEST_PHONE="YOUR_WHATSAPP_NUMBER"

import logging
import os
from contextlib import asynccontextmanager
from uuid import UUID

from bird import AsyncBird, APIError
from fastapi import FastAPI, Header, HTTPException

sender = os.environ["BIRD_TEST_PHONE"]


@asynccontextmanager
async def lifespan(app: FastAPI):
    async with AsyncBird(api_key=os.environ["BIRD_API_KEY"]) as client:
        app.state.bird = client
        yield


app = FastAPI(lifespan=lifespan)


@app.post("/api/whatsapp/messages", status_code=202)
async def send(idempotency_key: str = Header()):
    try:
        UUID(idempotency_key)
    except ValueError:
        raise HTTPException(400, "Supply an Idempotency-Key UUID.")
    try:
        message = await app.state.bird.whatsapp.send(
                to=sender,
                template="bird_otp",
                language="en",
                components=[{"type": "body", "parameters": [{"type": "text", "text": "123456"}]}],
                options={"idempotency_key": idempotency_key},
        )
        return {"id": message.id, "status": message.status}
    except APIError:
        logging.exception("Bird send failed")
        raise HTTPException(503, "Could not confirm the send. Inspect the original attempt before retrying.")


@app.get("/api/whatsapp/messages")
async def read(id: str):
    try:
        message = await app.state.bird.whatsapp.get(id)
        return {"id": message.id, "status": message.status}
    except APIError:
        logging.exception("Bird read failed")
        raise HTTPException(503, "Could not read the message.")

fastapi dev main.py --host 127.0.0.1

export DEMO_OPERATION_ID="$(python3 -c 'import uuid; print(uuid.uuid4())')"
curl -i -X POST http://127.0.0.1:8000/api/whatsapp/messages \
  -H "Idempotency-Key: $DEMO_OPERATION_ID"

curl "http://127.0.0.1:8000/api/whatsapp/messages?id=YOUR_MESSAGE_ID"