Widget Integration
How to install the Lenit widget on your site and configure user identification, appearance, and home settings.
Articles
- Install the Widget — Widget Popup and Board Link — How to choose between a widget popup and a board link, the default (anonymous) and identified user switch, board keys, installation code and verification, installing with an AI agent, and opening with your own button. Installation code options and JS functions are for developer documentation. Keywords: widget installation, board key, installation code, launcher button, board link, AI agent installation.
- User Identification (SSO) and Customer Traits — Covers the three ways to link a logged-in user to the widget (JWT, HMAC-signed, or userId only), how they differ, how to manage the signing secret, what information can be passed, how this workspace profile connects to a Lenit account, and how to use the validator. Keywords: user identification, SSO, JWT, signing secret, traits, customer attributes.
- Developer Reference for Widget Integration — Login/Logout, Sessions, and JS Functions — Developer reference for widget integration — full list of installation code options, JS functions (push, open, close, toggle, reset, destroy, track), what to do right after SPA login and during logout, when to re-identify users, the 24-hour widget session and past conversations, page history, CSP, and mobile display. Keywords: widget SDK, Lenit.reset, logout, getToken, CSP, trackPageView.
- Widget appearance and home layout — Set up the launcher color, welcome banner, widget logo, AI response profile (name and photo shown with AI answers), bottom tabs (feedback, announcements, help) on or off, the Connect to agent button, the order of the 5 home blocks, and up to 4 action cards, all with a live preview. Available to owners and admins, with no plan restrictions. Keywords: widget settings, AI response profile, bottom tabs, connect to agent button, welcome banner, home blocks, action cards, widget logo, Powered by Lenit.
- Customer-facing widget — guide to each tab — Covers the widget tab layout, what customers can do in each tab, attachment and character limits, how replies are marked as coming from the team, feedback tab submission rules (up to 3 topics), how it differs from the public board, settings screens, notification toggles, and language options that vary by customer identity tier, plus FAQs on past conversations, Google sign-up, and login links. Keywords: widget tabs, contact us, satisfaction, notification settings, anonymous visitor, notification email link, past conversations, login link.