ZenotiHelp

Web chat widget

ZTZenoti Docs Team Updated June 29, 2026 2 min readGuide

The web chat widget is an embeddable SmartBot component that lets guests interact with your AI agent directly from your website. Guests can ask questions, browse FAQs, and book appointments through a conversational interface without leaving your webpage.

Audience: Administrators embedding or managing the SmartBot web chat widget.

Before you begin

  • Your organization must have SmartBot provisioned with the web channel enabled for the center.
  • You need access to your website's source code or content management system to embed the widget script.
  • Widget appearance settings are configured in the Bot Settings panel by an admin with web channel access.

How the web chat widget works

The widget loads on your webpage and fetches its appearance settings from SmartBot using your organization's credentials. Once loaded, the widget remains on the page and guests can interact with it at any time.

Display modes

The widget supports three display modes, which you configure in Bot Settings:

  • Minimized β€” The widget appears as a compact bar with the configured greeting text visible. Guests click it to open the full chat window.
  • Expanded β€” The full chat window opens automatically when the page loads.
  • Icon-only β€” Only the floating button appears. Guests click the button to open the chat window.

Widget position

The widget can be placed on the left or right side of the webpage. You configure this in Bot Settings.

Guest interaction flow

  1. The guest opens a page where the widget is embedded. The widget loads and displays according to the configured mode.
  2. The guest clicks to start a conversation. The widget transitions to the expanded chat view.
  3. The guest sends a message. SmartBot classifies the intent and routes to the appropriate AI agent.
  4. Responses appear in the chat window. If the response includes selectable options, the guest can tap or click to choose one.
  5. For actions that require identity verification (such as booking), SmartBot requests the guest's phone number and sends an OTP.
  6. The conversation continues until the task is completed or the guest closes the widget.

Session handling

The underlying conversational state record uses a 30-minute TTL across all SmartBot channels. The Web Bot's abandoned-booking inactivity timer is a different concept β€” when a guest starts a booking but goes inactive for 10 minutes (default; env-overridable), SmartBot sends an SMS recovery message instructing the guest to reply Hi to restart or to use the included Webstore URL. For comparison, the SMS Bot's abandoned-booking timer is 30 minutes (default).

Embed the widget on your website

The Web Bot Settings panel generates a JavaScript embed script when you save your appearance configuration. This script is the mechanism by which the widget is published to your business website:

  1. In the SmartBot admin console, open Web Bot Settings and configure the widget's appearance.
  2. Copy the generated embed script.
  3. Paste the script into the HTML of the pages on your website where you want the widget to appear.

The widget then renders inside an iframe on your site, initializing with your organization ID and center ID and fetching the appearance configuration automatically.

Tips

  • Configure your widget's greeting text and display mode in Bot Settings to match your website's design and guest experience goals.
  • Use the Minimized mode on high-traffic pages to avoid interrupting guests who are browsing.
  • Use the Expanded mode on booking-focused pages to encourage immediate engagement.
Was this article helpful?
Your feedback helps us improve our documentation.