Documentation

Embedding Public AI Chat

View as Markdown

Embed Public AI Chat on your website after the Site has been configured and a Site-level widget key has been created.

Before You Embed

Make sure you already have:

  • Public AI Chat enabled for the Site
  • allowed origins configured for the website domain
  • a Site-level widget key for Public Chat

If voice is enabled for the widget, the key also needs the voice scope required for that deployment.

Basic Embed Flow

The standard deployment uses Clear Ideas widget assets plus your Site-level widget key.

At a high level:

  1. Load the Public Chat assets on the website
  2. Add the widget container or initialization code
  3. Provide the Site-level widget key
  4. Confirm the site origin is allowed

Security Notes

  • Keep widget keys out of version control.
  • Use separate keys for separate environments where needed.
  • Revoke unused or compromised keys.
  • Keep allowed origins limited to domains you control.