whatsapp-cloud-api-agent

1. Overview & Architecture

The WhatsApp Cloud API is Meta's hosted B2B messaging platform. Instead of running a phone with Baileys (like my-bot), you register a Meta business, get a phone number, and Meta delivers webhooks to your server.

┌──────────┐     webhook POST      ┌──────────────┐     async task     ┌───────────────┐
│  Meta    │ ────────────────────► │  FastAPI      │ ────────────────► │  Agent Router │
│  Cloud   │                       │  /webhook     │                   │  (specialist) │
│  API     │ ◄──────────────────── │               │ ◄──────────────── │               │
└──────────┘    200 OK (immediate) └──────────────┘     Agent result   └───────────────┘
                                               │
                                               ▼
                                        ┌──────────────┐
                                        │  Redis State  │
                                        │  (per-phone)  │
                                        └──────────────┘