Whoa Chat docs
Whoa Chat is the support inbox for Shopify app developers. Your merchants write from inside your app's admin, your website and email; your team answers from one inbox that already knows each store.
The parts
- The inbox at
app.whoa.chat: where your team reads and answers. Conversations are keyed by the store (acme.myshopify.com), so every message, event and email from one store lands in one thread. - The merchant chat inside your embedded app: React components from
@whoa-chat/react, signed in by your server with@whoa-chat/connector. Merchants never create an account. - The website widget: one script tag for your marketing site and help center, answering visitors with AI from your help center and handing over to your team.
- The help center: articles written in the inbox, published as a static site at
<workspace>.help.whoa.chator your own domain, and used by the AI as its knowledge.
How your app talks to Whoa Chat
Everything is signed. Your app gets a chat secret per Shopify app you add, and uses it on your server only:
- Who is writing: your server signs a short-lived merchant token naming the store and the staff member. See Merchant identity.
- What they did: your server posts events (installs, setup steps, plan changes) to the store's timeline. See App events.
- What only your app knows (optional): the inbox asks your server about a store through a signed request, and shows the answer in the store panel and dashboards. See Connector.
QuickstartFrom an empty workspace to the first merchant message in your inbox.
The chat componentsPut the chat in your app, set your brand, pick languages.
Website widgetOne script tag on your site and help center.
SecurityWhat we store, how workspaces are kept apart, how tokens work.
What is available today
Whoa Chat is in early access. The inbox, the merchant chat, the widget, the help center and email all run in production. A few things are still being built and are marked Coming soon in these docs:
- Self-serve sign-up and workspace setup. Today we create your workspace with you.
- Billing.
- The packages on npm. Today design partners get access to the packages directly from us.
Want in? Ask for early access.