WATS documentation
A Bun-first TypeScript toolkit for the WhatsApp Cloud API.
WATS is a Bun-first TypeScript toolkit for the WhatsApp Cloud API. It ships as composable packages — Graph client, webhook adapter, typed routing, config, CLI, standalone service — not one monolithic framework. Take the parts you need.
- Quickstart — run a WATS bot offline, no credentials.
- CLI onboarding — config scaffolding, setup wizard, doctor, dry-run serve.
- Live webhook — point Meta at a locally running service behind a public HTTPS tunnel.
- Deploy guides — Bun, Node, Cloudflare Workers, and the Docker shape.
- Reference — per-package API documentation.
- Capability status — per-capability implementation and live status.
When not to use WATS
- You need every endpoint proven against live Meta today. Much of the surface is tested against the wire contract but has not carried live traffic — check capability status first.
- You need a frozen API. The 0.x line still makes breaking changes.
- You're happy on pywa and Python. WATS started as "pywa, but TypeScript" — if the Python side works for you, there's no reason to move.