Website Chat Widget

अपनी website पर सीधे AI-powered chat widget embed करें। Visitors आपकी site छोड़े बिना आपके AI agent से instant answers पा सकते हैं।

अवलोकन

Website Widget प्रदान करता है:

आपकी website पर floating chat bubble
Real-time streaming AI responses
Customizable appearance (colors, position, messages)
11KB से कम gzipped — near-zero performance impact
Security के लिए domain allowlisting

पूर्व-आवश्यकताएं

आपके admin panel में एक active AI agent
आपकी website के HTML का access (script tag paste करने के लिए)

Setup Steps

Sidebar से Integrations पर जाएं
Website Widget section तक scroll करें
Create Widget पर क्लिक करें
नाम दर्ज करें और AI agent चुनें
Create पर क्लिक करें

2. Appearance Customize करें

Edit sheet खोलने के लिए widget card पर क्लिक करें:

Primary Color — Chat bubble और header color
Text Color — Bubble और header पर text
Position — Bottom-right या bottom-left
Welcome Message — Visitors को पहला message दिखाई देगा
Suggested Questions — 4 clickable starters तक
Avatar URL — Chat header में custom image
Border Radius — Corner roundness

Changes करते समय live preview update होता है।

3. Allowed Domains सेट करें (Recommended)

Restrict करें कि कौन सी websites आपका widget embed कर सकती हैं:

सभी domains allow करने के लिए empty छोड़ें (default)
Specific domains जोड़ें: example.com, *.example.com
Development के लिए port entries उपयोग करें: localhost:3000

4. अपनी Website पर Embed करें

अपने widget card पर embed icon पर क्लिक करें और code copy करें:


<script src="https://core-api.cuneiform.chat/api/widget/widget.js"
  data-widget-id="your-widget-id" async></script>

अपनी website पर closing </body> tag से पहले paste करें।

यह कैसे काम करता है


Visitor आपकी website खोलता है
  → Chat bubble corner में दिखाई देता है
  → Visitor click करता है → Chat panel खुलता है
  → Welcome message + suggested questions दिखते हैं
  → Visitor सवाल type करता है
  → AI agent आपके content में खोज करता है
  → Response real-time में stream होता है

Messages real-time में process होते हैं। Agent आपके content में खोज करता है और सभी अन्य channels के समान AI pipeline का उपयोग करके responses generate करता है।

Features

Streaming Responses

Responses Server-Sent Events (SSE) का उपयोग करके real-time में stream होते हैं। Visitors answer progressively दिखाई देते हैं, ChatGPT के समान।

Session Persistence

Same browser पर returning visitors 24-hour window के भीतर अपनी previous conversation resume करते हैं। Sessions browser के localStorage में stored होते हैं।

Markdown Rendering

Agent responses markdown formatting support करते हैं जिसमें bold, italic, lists, code blocks, और links शामिल हैं।

Widgets Manage करना

Integrations page पर, प्रत्येक widget card दिखाता है:

Widget name और status
Assigned agent
Edit, embed code, और delete actions

Action	कैसे
Settings edit करें	Widget card पर क्लिक करें
Embed code प्राप्त करें	Embed icon पर क्लिक करें
Delete करें	Three-dot menu → Delete

Security

Shadow DOM isolation — Widget आपके page से sandboxed है
HMAC session tokens — 24-hour expiry के साथ signed tokens
Domain allowlisting — Restrict करें कि कौन सी sites आपका widget embed कर सकती हैं
Rate limiting — 30 messages/minute per session
No data access — Widget आपके page content को read या modify नहीं कर सकता

Troubleshooting

Verify करें कि script tag </body> से पहले है, <head> में नहीं
Check करें कि data-widget-id आपके admin panel से match करता है
अगर domain allowlisting सेट है, verify करें कि आपका domain listed है
Browser console में errors check करें

Ensure करें कि assigned agent Active status में है
Verify करें कि agent के content में documents हैं
Failed API requests के लिए browser Network tab check करें

Appearance Issues

Widget Shadow DOM isolation उपयोग करता है। आपके page की CSS widget को affect नहीं करेगी। Appearance customize करने के लिए edit sheet का live preview उपयोग करें।

FAQ

हाँ। हर page पर same embed code उपयोग करें। Widget same domain पर pages में session state share करता है।

क्या यह mobile पर काम करता है?

हाँ। Widget पूरी तरह responsive है और mobile browsers के लिए optimized है।

क्या मैं “Powered by” badge हटा सकता हूं?

Trial और Starter plans पर badge जरूरी है। इसे हटाने के लिए Professional या higher plan पर upgrade करें।

क्या यह React/Next.js/Vue के साथ काम करता है?

हाँ। Widget एक standalone script के रूप में load होता है और किसी भी framework के साथ काम करता है, single-page applications सहित।

Message length limit क्या है?

4,000 characters per message।