# Clad Support Chat

> Documentation for Clad Support Chat — native, in-app support for your web app. Embed a chat widget with knowledge base, AI answers, and live conversations with your team.

This documentation covers the official Clad Support Chat Web SDK and the hosted chat widget: installation, configuration, identity verification, conversations, realtime behavior, events, and the public Widget API.

Full text: https://docs.useclad.ai/llms-full.txt — every page is also available as Markdown by appending `.md` to its URL.

## Agents

- [Vibe Start](https://docs.useclad.ai/vibe-start.md): Steps for vibe coders: let your AI agent set up the widget.

## Getting Started

- [How it works](https://docs.useclad.ai/how-it-works.md): Architecture overview: how the SDK, hosted widget iframe, and Widget API fit together.
- [Quickstart](https://docs.useclad.ai/quickstart.md): Add the widget with one script tag and start chatting in minutes.
- [Installation](https://docs.useclad.ai/installation.md): Add Support Chat with a single script tag. Configure regions and self-hosting.

## Configuration

- [Configuration](https://docs.useclad.ai/configuration.md): Every widget configuration option — workspace, region, theming, launcher, and more.
- [The session lifecycle](https://docs.useclad.ai/session-lifecycle.md): boot, identify, update, shutdown, and destroy — the full lifecycle of a chat session.

## Identity & Auth

- [Identity verification (JWT)](https://docs.useclad.ai/identity-verification.md): Securely identify logged-in users with short-lived, server-signed JWTs. Includes backend recipes.
- [Anonymous → authenticated](https://docs.useclad.ai/identify-upgrade.md): Upgrade an anonymous session to an identified user and merge conversation history.

## Widget UI

- [Visibility & launchers](https://docs.useclad.ai/visibility-launchers.md): Open, close, show, and hide the messenger — or wire up your own custom launcher button.
- [Render modes](https://docs.useclad.ai/render-modes.md): Floating, embedded, and custom-launcher render modes for the chat widget.
- [Theming, locale & z-index](https://docs.useclad.ai/theming.md): Match the widget to your brand with theme colors, fonts, locale, and z-index control.

## Messaging

- [Conversations](https://docs.useclad.ai/conversations.md): Start, list, show, and send messages in conversations with idempotent retries.
- [Knowledge base & forms](https://docs.useclad.ai/knowledge-base-forms.md): Let users search your knowledge base and submit ticket forms without leaving your app.
- [Context, tags & custom fields](https://docs.useclad.ai/context-tags-fields.md): Attach page context, tags, and custom fields to conversations.

## Realtime & Events

- [Events](https://docs.useclad.ai/events.md): Subscribe to lifecycle, connection, conversation, and message events with on().
- [Error handling](https://docs.useclad.ai/error-handling.md): Handle SupportChatError, inspect error codes, and retry recoverable failures.
- [Realtime behavior](https://docs.useclad.ai/realtime.md): WebSocket transport, automatic reconnection, message de-duplication, and unread tracking.

## Privacy & Security

- [Privacy & cookie consent](https://docs.useclad.ai/privacy-cookie-consent.md): Control storage and analytics with granular cookie-consent levels.
- [Security best practices](https://docs.useclad.ai/security.md): Identity verification, allowed origins, CSP, and data-handling guidance.

## Guides

- [Framework recipes](https://docs.useclad.ai/framework-recipes.md): Copy-paste integration recipes for React, Next.js (App Router), and Vue 3.
- [Browser support & performance](https://docs.useclad.ai/browser-support.md): Supported browsers, lazy-loaded UI, and the single hosted script delivery.
- [Troubleshooting & FAQ](https://docs.useclad.ai/troubleshooting.md): Solutions to common issues: widget not appearing, invalid origins, auth errors, and more.

## API Reference

- [Public Widget API](https://docs.useclad.ai/widget-api-reference.md): The underlying HTTP + WebSocket Widget API for advanced and self-hosted scenarios.
- [Widget configuration](https://docs.useclad.ai/widget-configuration.md): The WidgetConfig schema: identity rules, routing, features, theme, and AI behavior.
- [Versioning & support](https://docs.useclad.ai/versioning.md): How the widget and API are versioned, what stays stable, and how to get support.
- [TypeScript reference](https://docs.useclad.ai/typescript-reference.md): Key types and the full SupportChat interface available on the global API.