Customer Chat Widget

The Neosantara Customer Chat Widget lets you deploy an interactive AI assistant for customer support, lead qualification, or documentation navigation directly onto your website with a single script embed.

Quick Start

Insert the following script tag into your website HTML before the closing </body> tag:

<!-- Neosantara Customer Chat Support Widget -->
<script
  src="https://api.neosantara.xyz/widget.js"
  data-widget-id="YOUR_WIDGET_ID"
  async
></script>

Replace YOUR_WIDGET_ID with the widget identifier obtained from the Chat Widget Dashboard. Widget configuration is managed visually through the dashboard:

Open Chat Widget Menu

Configure Core Parameters

Widget Name: Assign an internal label such as Main Web Support.
AI Model: Select the underlying language model such as deepseek-v4.1-flash or garda-core.
Allowed Domains: Provide authorized domain origins such as company.com or app.company.com.
System Prompt: Set system personas, brand guidelines, and greeting tones.

Customize Appearance

Theme Color: Define primary color HEX codes to match your brand palette.
Logo URL: Display your company mark inside the chat window header.
Layout Style: Select from modern-round, classic-square, or compact styles.
Placement: Anchor the launcher to the bottom-right or bottom-left of the viewport.

Save and Deploy

Save the configuration and copy the embed script snippet to your site.

Knowledge Base Integration

Attach proprietary documents to provide accurate, grounded answers to customer inquiries:

Open Knowledge Base Tab

Within the saved widget settings, open the Knowledge Base tab.

Upload Reference Documents

Upload support documents in PDF, TXT, or Markdown format.

Automatic Vector Indexing

The gateway ingests, chunks, and creates vector indices automatically for context retrieval when users submit queries.

Configuration Options

Setting	Options	Description
`theme_color`	HEX Code like `#8A4300`	Primary color applied to buttons, window headers, and badges.
`layout_style`	`modern-round`, `classic-square`, `compact`	Border radius and chat frame geometry.
`placement`	`bottom-right`, `bottom-left`	Screen coordinate position for the launcher trigger.
`launcher_style`	`icon`, `text`, `pill`	Collapsed state launcher appearance.
`proactive_delay`	Seconds like `10`	Idle duration before the widget automatically triggers greeting dialogs.
`allow_uploads`	`true`, `false`	Enable user image and document attachments in live chat sessions.

The widget verifies incoming browser Origin or Referer headers to ensure execution only occurs on domains defined in Allowed Domains.

Next Steps

Goal	Guide
Model catalog and pricing	Model Catalog & Pricing
Agent frameworks	Framework Integrations
Request limits and quotas	Rate Limits & Quotas
Common questions and policies	FAQ & Questions

Frameworks

Tools & Widgets

Quick Start

Creating a Widget in Dashboard

Knowledge Base Integration

Configuration Options

Next Steps

​Quick Start

​Creating a Widget in Dashboard

​Knowledge Base Integration

​Configuration Options

​Next Steps

Quick Start

Creating a Widget in Dashboard

Knowledge Base Integration

Configuration Options

Next Steps