Quickstart

Add the loader

Paste this before </body> on every page. Replace the App ID with yours from Settings → Install in the dashboard.

index.html

<script>
  window.Iris = window.Iris || { queue: [] };
  ["init", "identify", "logout", "on", "open", "close", "setPageContext", "update"].forEach(function (name) {
    Iris[name] = Iris[name] || function () { Iris.queue.push([name, arguments]); };
  });
  Iris.init({ appId: "app_7Hq2xK9mPz" });
</script>
<script async src="https://cdn.irisdesk.app/v1/iris.js"></script>

Allow your site

Add your site’s origin in Settings → Widget → Allowed origins. Without it, the widget gets 403 origin_not_allowed and does not show. See Allowed origins and CSP.

Allowed origin

https://shop.example.com

Send the first message

Open your page and select the launcher in the bottom corner. Send a message. It shows in the dashboard inbox within a few seconds.

Next steps

• Identify users, so their conversations follow them.
• Change the colour and the corners with the Iris.init options.
• Open the widget from your own button.