Skip to main content
Clarity’s support chat runs on your website and inside your mobile apps. Customers talk to your AI agents and your team in the same conversation, and every conversation lands in your Clarity inbox as a ticket.

​
Choose an SDK

Web chat widget

Paste one snippet into your site. Open the chat from your own buttons and identify signed-in visitors.

Android

Native bottom sheet or full-screen chat for Android 5.0 and later, with FCM push routing.

iOS

Native bottom sheet or full-screen chat for iOS 15 and later, with APNs push routing.

Flutter

One Dart API over the Android and iOS SDKs.
The mobile SDKs show the same chat as the web widget, in a native container over your app. The chat’s look and texts come from the same widget settings, so you configure them once.

​
The ids you need

Every SDK needs the same small set of values. They identify your organization and channel. They are not secrets, so you can ship them in your page source or app binary. Each website domain and each mobile app is its own channel, with its own integration key.

​
Where to find them in the cabinet

1

Open Live chat

Go to Settings and, under Channels, open Live chat.
2

Add a web integration

Click Add Integration and enter your site’s Domain Address, without https:// and without a path. Choose Live chat as the widget and click Add web integration.
3

Copy the values

The Integration info dialog shows the Integration Key, the Organization Id and the Inject code snippet with both already filled in.

​
Identify signed-in users

Every SDK lets you pass who the customer is: an external id from your own system, a name, an email and custom attributes. On its own, that identity is a claim the page or app makes about itself. To have Clarity trust it, your backend signs a short-lived token (a JWT) with the channel’s identity secret, and the widget or SDK passes it along. The secret is in each channel’s integration dialog, under Identity verification. Signed identity explains how to mint the token. The rules are the same for the web widget and the mobile SDKs.
The identity secret must stay on your server. Never put it in your website’s code or in a mobile app.

​
Customize the chat

Settings > Widget controls what customers see in every channel: brand colours, logos and font, the home screen texts, the assistant’s name and greeting, starter questions and the expanded window size. Changes go to a draft first and reach customers when you click Publish. Per-channel switches are in each channel’s integration dialog: voice calling, dictation, the Inbox tab, opening straight into the conversation and, for the web widget, whether your page can open and close the chat.