Whoa Chat
Docs

Limits and errors

Limits keep one busy store or one noisy site from slowing everyone else. The defaults sit well above what a busy team does.

Default limits per workspace

WhatLimit
Website visitor questions120 a minute, plus per visitor and per address daily caps
Merchant messages600 a minute for the workspace, 30 a minute per store
AI replies120 a minute and 20,000 a month
AI usage400 million tokens a month, 600 AI calls a minute
Team invites20 a day
Help center domain requests5 a day

Limits can be raised per workspace; tell us what you need.

When the AI reaches its monthly cap

The AI stops answering for the rest of the month and conversations stay with your team. The inbox notes it once on the conversation, and the AI tab in Settings shows this month's usage.

Errors

StatusMeaning
400The request is malformed (a missing field, a value out of range).
401Not signed, or the signature, purpose or expiry is wrong. Check the secret and your server's clock.
403Signed, but not allowed: an app or site not registered to a workspace, or a role that cannot do this.
404Not found in your workspace. Items of other workspaces always look like this.
409Already taken: a client id, domain or secret change that conflicts.
429A limit was reached. Wait a minute and try again.

Errors answer with JSON { "error": "..." } in plain words.