Docs home

Channels

Web widget embed

Install the FlexyAgents widget on your site: script tag, configuration, domains, CSP headers, and performance considerations.

embedjavascriptwidgetchat

The web widget is the default customer entry point: a launcher plus chat panel that calls FlexyAgents with your agent id and embed key.

Host the snippet near the end of body for faster initial paint; defer non-critical analytics until after interactive.

Embed snippet and keys

Copy the snippet from the dashboard deployment section; it references your environment host and public embed key. Rotate keys if exposed accidentally.

For SPAs, ensure the script initializes once per route change strategy your framework uses.

CSP and third-party scripts

Update Content-Security-Policy to allow FlexyAgents script and connect-src endpoints for chat APIs and websockets if used.

Test in staging with the same CSP as production to avoid silent blocks.

Performance

Lazy load the widget on first interaction if LCP is sensitive; balance against discoverability.

Monitor Core Web Vitals after embed; large custom fonts in the host page affect both host and iframe surfaces.

Build on your stack

Ready to ship grounded assistants?

Start a trial or talk to us about rollout, governance, and enterprise requirements.