Zerobuild Docs
The widget/Install the widget

Install the widget

One script tag puts live chat on your site.

The snippet

Open Live chat → Widget settings and copy your embed snippet:

html
<script src="https://app.zerobuild.ai/widget/widget.js"
  data-workspace-id="your-workspace-id"
  data-server-url="https://app.zerobuild.ai"></script>

Paste it before the closing </body> tag. That's the whole install — everything below is configured from the app, no code changes.

Appearance

  • Brand color — buttons, header, and accents take your color.
  • Position — bottom-right or bottom-left.
  • Theme — light, dark, or follow the visitor's system.
  • Welcome message — the first thing a visitor reads.

The pre-chat form

Decide what you ask before a conversation starts:

  • Email — required by default (it's how contacts link up); can be switched off for anonymous chat.
  • Custom fields — add text, email, select, or textarea fields, each optional or required. An order number field here saves the first three messages of most support conversations.

Routing & offline

  • Assignment — new conversations either wait in the shared queue for anyone to take (manual), or are distributed automatically among the agents you mark eligible.
  • Offline message — shown when no agent is online, alongside email capture so the conversation isn't lost. See Live chat for how the fallback works.
esc
full-text search over published docs only