Skip to main content

Installation

The widget requires React 18+ or React 19+ as a peer dependency. If your project doesn’t use React, use the UMD / CDN approach below.

Quick Start

ES Module

That’s it — a floating chat button appears in the bottom-right corner. Click it to open the agent.

CommonJS

UMD / CDN

If you’re not using a bundler, load the widget from a CDN:

Options


Widget Instance

embedWidget() returns a WidgetInstance with methods for programmatic control:
See Programmatic Control for detailed usage and examples.

Direct iframe (Alternative)

If you prefer not to use the npm package, embed the agent directly with an iframe:
The embed widget is recommended over a raw iframe because it handles widget chrome, responsive layout, programmatic control, and automatic identity token refresh out of the box.

Next Steps