Quickstart
Get the Clarm widget live on your website in a few minutes using the canonical loader.
1. Create or open your widget
Sign in to the Clarm Dashboard, go to Widget, and save your configuration. Saving provisions a canonical widgetId and widget token automatically.
2. Copy the embed snippet
In Widget → Deploy, copy the script tag and paste it before the closing </body> tag on your site:
<script src="https://app.clarm.com/widget/loader.js" data-widget-id="YOUR_WIDGET_ID" async></script>Replace YOUR_WIDGET_ID with the value shown in the dashboard. The loader fetches the rest of the widget configuration at runtime, so future branding or copy changes do not require a code deploy.
Use the widget editor for configuration changes such as brand name, welcome message, quick replies, actions, header text, colors, and position. Do not hardcode those values into the embed snippet.
3. Add optional tracking events
The widget already tracks page and widget activity automatically. If you want to identify signed-in users or attach revenue events, call window.ClarmTrack.track(...) after the loader has initialized:
window.ClarmTrack?.track('identify', {
email: '[email protected]',
name: 'Jane Smith',
company: 'Acme Inc'
});window.ClarmTrack?.track('purchase', {
amount: 99.00,
currency: 'USD',
plan: 'growth'
});4. Verify installation
Open your site and confirm the chat bubble appears. Send a test message, then verify the conversation appears in Dashboard → Inbox and the widget shows as healthy in Widget → Deploy.