The bot lives between Twilio and the ClubReady API. Inbound SMS hit a Next.js route, a state machine resolves intent (book, reschedule, ask), and the API call is wrapped with idempotency so retries never double-book.

Conversation memory and gym configuration live in PocketBase. Each studio gets its own tone, hours, and pricing, and operator overrides are tracked so "the bot said the wrong thing" turns into a fix in minutes.