Skip to Content
Chat widgetOverview

Chat widget

The Zuhile widget is a lightweight chat launcher you embed on your website. It gives visitors instant AI answers grounded in your knowledge base, and a seamless handoff to your human team when needed.

What it does

  • AI answers in real time, streamed as the agent types.
  • Live human takeover — when an agent steps in from the inbox, the visitor sees their replies instantly (no page reload).
  • Presence — shows which human agents are online.
  • Conversation history — visitors can return and pick up past conversations, with an unread-count badge.
  • Help center (optional) — browse and search your help articles inside the widget.
  • Feedback — 👍 / 👎 on AI answers, which feeds your CSAT analytics.
  • Pre-chat form (optional) — collect a name/email before the chat starts.

How it’s built

  • Loads as a single script from your Zuhile gateway.
  • Renders inside a shadow DOM, so its styles are fully isolated from your site’s CSS (and yours from it).
  • Authenticates with a public key — safe to ship in client-side HTML. Which domains may use it is enforced by your domain allowlist.
  • Uses WebSockets for live updates, with graceful fallback.

Getting a key

Your widget public key and a ready-to-paste snippet live in Settings → Embed in the dashboard. Continue to Installation.

AnalyticsInstallation