Install the chat widget

Copy the snippet from Settings → Chat widgets → Install.

Standard loader

Paste this before </body>. Replace the app_ id with yours.

<script src="https://widget.joinsayless.com/v1/app_…/loader.js" async></script>

The loader inlines launcher config, so the host page does not fetch widget settings. It paints the launcher after load plus idle. To boot with a signed-in user, queue boot before the loader arrives:

<script>
  window.Sayless = window.Sayless || function () { (Sayless.q = Sayless.q || []).push(arguments); };
  Sayless('boot', {
    identityToken: () => fetch('/api/chat-token').then((res) => res.text()),
  });
</script>
<script src="https://widget.joinsayless.com/v1/app_…/loader.js" async></script>

See identity verification for how to sign that token.

SRI loader

If you require subresource integrity, use the hashed loader and a data-app-id attribute. The hashed file lives at /v1/loader.{hash}.js and is listed in /manifest.json.

<script
  src="https://widget.joinsayless.com/v1/loader.{hash}.js"
  integrity="sha384-…"
  crossorigin="anonymous"
  data-app-id="app_…"
  async
></script>

The SRI loader fetches config from the widget origin, so your CSP needs connect-src as well as script-src and frame-src. See content security policy.

Kill switch

Turn the widget off in settings. The same snippet stays on your page and the loader becomes a no-op.

Start

Authentication

TypeScript SDK

Chat widget

Guides

Install the chat widget

Standard loader

SRI loader

Kill switch

​Standard loader

​SRI loader

​Kill switch

Standard loader

SRI loader

Kill switch