Skip to main content
The IllumiChat Widget lets you embed an AI-powered chat interface on any website. Visitors can interact with your custom assistants directly from your site — no login required.

​
Use Cases

Customer Support

Let visitors ask questions and get instant AI-powered answers 24/7.

Lead Generation

Capture visitor information through the built-in lead form and feed it into your contacts.

Documentation Help

Connect your docs as knowledge so visitors can search and get answers from your content.

Internal Tools

Use authenticated mode for internal portals where employees interact with company assistants.

​
How It Works

1

Create an assistant

Set up an assistant with custom instructions and connect it to your knowledge base.
2

Add the widget script

Drop a single script tag into your website’s HTML.
3

Visitors start chatting

A chat bubble appears on your site. Visitors click it to open the chat panel and interact with your assistant.

​
Key Features

  • Zero-code installation — A single script tag is all you need
  • Customizable appearance — Match your brand colors, position, and theme
  • Multiple auth modes — Anonymous, authenticated (Auth0), or auto-detect
  • Lead capture — Collect visitor information before or during conversations
  • Session persistence — Conversations persist across page navigations
  • Domain restrictions — Control which domains can load the widget
  • Programmatic API — Open, close, send messages, and listen to events from JavaScript
  • Mobile responsive — Works on all screen sizes

​
Quick Start

Add this script tag to your HTML, replacing YOUR_ASSISTANT_ID with your assistant’s ID: 
<script
  src="https://widget.illumichat.com/v1/widget.js"
  data-assistant-id="YOUR_ASSISTANT_ID"
  async
></script>
Find your assistant ID in the assistant’s Settings > Widget tab in the IllumiChat dashboard.

​
Next Steps

Installation

Framework-specific installation guides for React, Next.js, WordPress, and more.

Configuration

Customize appearance, behavior, authentication, and lead capture.

SDK Reference

Full JavaScript API for programmatic widget control.