Whoa Chat
Docs

Website widget

One script tag puts a chat on your website and help center. It answers visitors from your help center with AI, and hands over to your team when they need a person.

Embed it

html
<script src="https://app.whoa.chat/widget.js" defer></script>

The widget draws itself in a shadow root, so your page's styles never reach it and its styles never reach your page. It picks the visitor's language from the page's lang attribute or the browser, with texts in English, German, French, Spanish, Italian, Dutch, Portuguese and Bulgarian.

Register your sites Coming soon

The widget only answers on sites registered to your workspace: its requests are refused for any other origin. During early access we register your sites when we set up your workspace; your help center at <workspace>.help.whoa.chat is registered automatically when you publish it.

Open it from your page

The widget sets window.WhoaChat. Open it with a question from your own search box or buttons:

html
<button onclick="WhoaChat.open('How do I change my plan?')">Ask about plans</button>

Script attributes

AttributeWhat it does
data-alias="Name"Also offers the widget as window.Name, for pages that already call an older name.
data-storage="prefix"Keeps the visitor's conversation under this storage prefix (default whoaChat), so a visitor coming back from an older embed keeps their history.

What it says

The widget asks GET /v1/visitor/config for your workspace's names (your brand) and its settings: an install link shown under each answer ({host} becomes the page's host, for utm tags), a link for merchants who already use your app, your own wording per language and suggested first questions. During early access we set these with you.

Limits

Each visitor gets three AI answers; after that, their messages go to your team, and they can leave an email address for the reply. Requests are rate-limited per visitor, per address and per workspace; see Limits and errors.