Widget
The widget lets you embed an agent into another website or product experience.
What you can do
- Use an embedded chat or speech experience
- Apply branding coming from the integration
- Pass runtime text overrides
- Control light or dark theme
- Show privacy or terms prompts when required by the integration
Runtime options you may encounter
| Option | Purpose |
|---|---|
bot_key | Identifies access to the widget session |
welcome_message | Overrides the default welcome text |
title | Overrides the widget title |
description | Overrides the widget description |
placeholderText | Overrides the input placeholder |
stopGeneratingText | Overrides the stop-generation label |
termsText / termsUrl | Controls terms messaging and link |
privacyText / privacyUrl | Controls privacy messaging and link |
disclaimerText | Adds a disclaimer in the widget |
| `theme=dark | light` |
Important behavior
- Widget access depends on a valid integration
- Some integrations are restricted by allowed domains
- Some widget setups use a script delivery mode instead of the iframe chat route
- If terms are refused, chat can remain blocked until the widget is reloaded
warning
The widget is embed-oriented content, not a normal logged-in application page. Access and behavior depend on the integration settings.