Embed & Install
The Embed & Install page provides the necessary code snippet to deploy your AI agent live on your website or web application. It also includes security settings to control exactly which domains are permitted to run your widget.
Key Features
- Workspace ID View: Quickly reference your unique Workspace ID.
- Allowed Domains (Security): A security control to restrict widget loading to specific, authorized websites.
- Deployment Script: A ready-to-copy, single-line
<script>tag that embeds the chat widget directly into your website's HTML.
How to Use
Securing Your Widget (Allowed Domains)
To prevent unauthorized websites from embedding your widget and using your AI resources:
- Locate the Allowed Domains (Security) section.
- Enter a comma-separated list of the domains where you plan to install the widget (e.g.,
example.com, myapp.io). - Leave this field completely empty if you want to allow the widget to load on any domain. Note: Any changes made to the Allowed Domains list apply automatically and instantly. You do not need to update the script on your website when you change these security settings.
Installing the Widget
To deploy the bot to your live website:
- Scroll down to the Deployment Script section.
- Click anywhere inside the code block to automatically copy the snippet to your clipboard. You will see a "Copied" confirmation pop up.
- Paste this code snippet into your website's HTML, placing it right before the closing
</body>tag.
Important Notes (or Pro Tips)
- Permissions: Only workspace owners can modify the Allowed Domains security setting. If you are logged in as an agent, this input will be disabled.
- Dynamic Updates: Your widget script automatically inherits the Position (Left/Right) and Theme (Light/Dark) settings you configured on the Appearance page.
Related Articles
Triggers
The Triggers page allows you to automatically pop open the chat widget and send a customized welcome message when a user...
Custom FAQs
The Custom FAQs page allows you to bypass the AI's standard generation process and force an exact, predefined respon...
Widget Pages
The Widget Pages & Layout page allows you to transform your standard chat widget into a full-featured, multi-page ap...
Was this helpful?
