Widget

Widget Integration.

The Nestled widget is a self-contained JS snippet that renders inside a Shadow DOM — it never conflicts with your styles.


Installation

html
<script
  src="https://cdn.nestled.co/v1/widget.js"
  data-token="YOUR_EMBED_TOKEN"
  async></script>

Data attributes

AttributeTypeDefaultDescription
data-tokenstringRequired. Embed token.
data-positionstringbottom-rightbottom-right or bottom-left.
data-colorstringDashboardPrimary hex color.
data-openbooleanfalseAuto-open on page load.
data-greetingstringDashboardOverride welcome message.

Programmatic API

After load, window.__nestled__ exposes:

js
window.__nestled__.open()
window.__nestled__.close()
window.__nestled__.send("Your question")

Shadow DOM isolation

The widget renders inside a Shadow DOM. No CSS collisions in either direction.

Mobile behaviour

On viewports under 480px the widget panel expands full-screen.