# BuzzDesk

> AI customer support for OpoShop stores. BuzzDesk puts a chat widget on the storefront that answers buyer questions from the store's real data — order status and tracking, the merchant's own shipping and return policies, and live product stock. Buyers must prove they own an order (email + order number must match) before anything about it is revealed, and any change to an order is only ever DRAFTED by the AI and applied after the merchant approves it. Runs on the merchant's own OpenAI or Claude API key.

This app is built on the OpoShop platform. It is agent-friendly: the full
API is described in OpenAPI and wrapped by an MCP server so an LLM can drive it
directly.

## Machine interfaces
- API contract (OpenAPI): https://app.usebuzzdesk.com/openapi.json
- API docs (Swagger): https://app.usebuzzdesk.com/docs
- Fuller LLM context: https://app.usebuzzdesk.com/llms-full.txt
- Release notes: https://app.usebuzzdesk.com/api/release-notes
- MCP endpoint (hosted): https://app.usebuzzdesk.com/mcp — add this URL to Claude or any LLM
  client to drive the app in natural language. Auth with your own OpoShop store
  token via Authorization: Bearer <token>.

## Auth
Get an access token via POST /api/auth/login, then send it as
`Authorization: Bearer <token>` on /api/* requests (and to the /mcp endpoint).