वेब विजेट

वेब विजेट आपको किसी भी वेबसाइट पर सीधे अपने AI बॉट द्वारा संचालित एक लाइव चैट विंडो एम्बेड करने देता है। इसे अपने ब्रांड से मेल खाने के लिए कस्टमाइज़ करें और मिनटों में डिप्लॉय करें।

Widget Settings & Live Preview

इंस्टॉलेशन

बाएं मेनू में Channels → Web Widget पर जाएं।
Create Widget पर क्लिक करें और उसे एक नाम दें।
विजेट सेटिंग्स कॉन्फ़िगर करें (नीचे Customization देखें)।
दिए गए एम्बेड कोड स्निपेट को कॉपी करें।
स्निपेट को अपनी वेबसाइट के HTML में, closing </body> टैग से ठीक पहले पेस्ट करें।
अपनी साइट सेव और प्रकाशित करें — विजेट तुरंत दिखाई देगा।

एम्बेड कोड

<!-- Clienta.ai Web Widget -->
<script>
  window.ClientaConfig = {
    botId: "YOUR_BOT_ID",
    widgetId: "YOUR_WIDGET_ID",
  };
</script>
<script
  src="https://api.clienta.ai/widget/YOUR_WIDGET_ID/loader.js"
  async
></script>

YOUR_BOT_ID और YOUR_WIDGET_ID को अपने डैशबोर्ड में दिखाए गए मानों से बदलें।

कस्टमाइज़ेशन

विकल्प	विवरण
Theme Color	अपने ब्रांड से मेल खाने के लिए प्राथमिक रंग सेट करें (hex कोड या color picker)
Welcome Message	जब कोई उपयोगकर्ता विजेट खोलता है तो प्रदर्शित होने वाला पहला संदेश
Position	स्क्रीन पर bottom-right या bottom-left प्लेसमेंट चुनें
Avatar	बॉट के लिए एक कस्टम अवतार छवि अपलोड करें

अतिरिक्त विकल्पों में शामिल हैं:

Widget Title — विजेट हेडर में दिखाया गया नाम
Placeholder Text — संदेश इनपुट बॉक्स के अंदर hint टेक्स्ट
Auto-Open Delay — N सेकंड के बाद विजेट को स्वचालित रूप से खोलें (वैकल्पिक)
Hide on Mobile — मोबाइल डिवाइस पर विजेट दृश्यता टॉगल करें

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

उपयोगकर्ता विजेट खोलता है — चैट विंडो पेज के कोने से स्लाइड होकर खुलती है।
बॉट को संदेश भेजा गया — उपयोगकर्ता का संदेश एक सुरक्षित WebSocket कनेक्शन के माध्यम से Clienta.ai को भेजा जाता है।
AI प्रोसेस करता है और जवाब देता है — बॉट नॉलेज बेस से प्रासंगिक सामग्री प्राप्त करता है और एक उत्तर उत्पन्न करता है।
यदि आवश्यक हो तो मानव को हस्तांतरण — यदि आत्मविश्वास कम है या उपयोगकर्ता एक मानव का अनुरोध करता है, तो बातचीत Conversations इनबॉक्स के माध्यम से एक उपलब्ध एजेंट को रूट की जाती है।

संपर्क फ़ॉर्म

v1.6.8

जब AI बॉट ऑफलाइन हो या जवाब देने में असमर्थ हो, तो विजेट एक CTA balloon दिखाता है जो विज़िटर को अपने संपर्क विवरण छोड़ने के लिए प्रेरित करता है। balloon पर टैप करने से एक संपर्क फ़ॉर्म खुलता है:

फ़ील्ड	आवश्यक	नोट्स
Email	हाँ	फॉलो-अप के लिए हमेशा आवश्यक
Phone	नहीं	देश कोड चयनकर्ता (+66, +1, +81, +86) शामिल है
Name	नहीं	विज़िटर का नाम
Message	नहीं	अतिरिक्त संदर्भ

संपर्क फ़ॉर्म सबमिशन एडमिन Tickets पेज में दृश्यमान एक टिकट बनाता है, जब प्रदान किया जाता है तो email और phone दोनों प्रदर्शित करता है।

रिज़ॉल्व के बाद नई चैट

v1.6.8

जब कोई एजेंट बातचीत को रिज़ॉल्व करता है, तो विजेट एक सिस्टम नोटिस और एक “Start New Chat” बटन प्रदर्शित करता है। इस पर क्लिक करने पर:

वर्तमान बातचीत इतिहास साफ़ होता है
एक नए WebSocket सेशन के साथ पुनः कनेक्ट होता है
विजेट को उसकी प्रारंभिक स्थिति में वापस लाता है

यह विज़िटर को पेज रीफ्रेश किए बिना एक नई बातचीत शुरू करने देता है।

WebSocket रियल-टाइम

विजेट रियल-टाइम, कम-विलंबता मैसेजिंग के लिए एक स्थायी WebSocket कनेक्शन का उपयोग करता है। मुख्य व्यवहार:

Auto-reconnect — यदि कनेक्शन टूट जाता है तो क्लाइंट स्वचालित रूप से पुनः कनेक्ट होता है।
Typing indicator — बॉट जब उत्तर उत्पन्न कर रहा हो तो टाइपिंग एनिमेशन दिखाता है।
Agent typing indicator — v1.6.8 जब कोई मानव एजेंट उत्तर टाइप कर रहा हो, तो विजेट विज़िटर को रियल टाइम में टाइपिंग एनिमेशन दिखाता है।
Message history — बातचीत इतिहास उसी ब्राउज़र सेशन में संरक्षित रहता है।
Cross-tab sync — यदि उपयोगकर्ता के पास कई टैब खुले हैं, तो बातचीत की स्थिति सिंक की जाती है।

Markdown प्रतिक्रियाएं

v1.6.4

AI और एजेंट संदेशों को सादे टेक्स्ट के बजाय formatted markdown के रूप में रेंडर किया जाता है। समर्थित फ़ॉर्मेटिंग में शामिल है:

Bold, italic, ~~strikethrough~~
Links (स्वचालित रूप से नए टैब में खुलते हैं)
Inline code और fenced code blocks
क्रमबद्ध और अक्रमबद्ध सूचियाँ
Headings, blockquotes, और tables

XSS हमलों को रोकने के लिए सभी markdown सामग्री को एक सख्त allowlist के साथ sanitize किया जाता है। कोई कॉन्फ़िगरेशन आवश्यक नहीं है — सभी AI और एजेंट प्रतिक्रियाओं के लिए markdown रेंडरिंग डिफ़ॉल्ट रूप से सक्षम है। उपयोगकर्ता संदेश सादे टेक्स्ट के रूप में रहते हैं।

ब्रांड अवतार

v1.6.4

विजेट हेडर और होम स्क्रीन में अपना ब्रांड लोगो या कस्टम अवतार प्रदर्शित करें। Settings → Channels → Web → Customizer में avatarUrl सेट करें या इसे embed code में config.theme.avatarUrl के रूप में पास करें।

केवल https:// URLs स्वीकार किए जाते हैं
यदि URL अमान्य है या छवि लोड होने में विफल रहती है, तो डिफ़ॉल्ट sparkle आइकन दिखाया जाता है
अनुशंसित: सर्वोत्तम परिणामों के लिए एक वर्गाकार छवि (जैसे 128 × 128 px)

विवरण के लिए Widget Customization — Avatar देखें।

AI बनाम मानव लेबल

v1.6.4

प्रत्येक गैर-उपयोगकर्ता संदेश प्रेषक की पहचान करने वाला एक छोटा author लेबल प्रदर्शित करता है:

लेखक प्रकार	दिखाया गया लेबल
AI bot	”AI Assistant” (स्थानीयकृत)
Human agent	एजेंट का नाम (जैसे “Sarah”)

लेबल सभी 15 समर्थित भाषाओं में स्थानीयकृत हैं और screen readers के लिए सुलभ हैं। यह विज़िटर को AI-generated और मानव प्रतिक्रियाओं के बीच स्पष्ट रूप से अंतर करने में मदद करता है, पारदर्शिता सर्वोत्तम प्रथाओं का समर्थन करता है।

अभिवादन भाषा

v1.6.2

विजेट अभिवादन संदेश तीन भाषा मोड का समर्थन करता है, Settings → Channels → Web → Customizer → Greeting Mode में कॉन्फ़िगर किया गया:

मोड	व्यवहार
Static	भाषा की परवाह किए बिना प्रत्येक विज़िटर को एक ही अभिवादन प्रदर्शित करता है
Match Visitor	प्रति-भाषा अभिवादन दिखाता है — 15 locales में से प्रत्येक के लिए एक अलग अभिवादन टेक्स्ट कॉन्फ़िगर करें
Org-Main	हमेशा संगठन की मुख्य प्रतिक्रिया भाषा में अभिवादन दिखाता है (set in AI Settings)

Match Visitor मोड में, बिना कॉन्फ़िगर किए गए अभिवादन वाला कोई भी locale static greeting टेक्स्ट पर वापस आ जाता है।

चरण-दर-चरण कॉन्फ़िगरेशन के लिए Widget Customization — Greeting Mode देखें।

भाषा चयनकर्ता

v1.6.2

विजेट हेडर में एक ग्लोब आइकन प्रदर्शित कर सकता है जो विज़िटर को अपनी पसंदीदा भाषा स्पष्ट रूप से चुनने देता है। यह सुविधा डिफ़ॉल्ट रूप से अक्षम है और इसे Settings → Channels → Web → Customizer में प्रति विजेट सक्षम किया जाना चाहिए।

सक्षम होने पर:

विजेट हेडर में एक ग्लोब (🌐) आइकन दिखाई देता है
विज़िटर 15 समर्थित locales में से चुन सकते हैं
एक भाषा चुनने से सेशन के लिए सभी AI प्रतिक्रियाएं उस भाषा में लॉक हो जाती हैं, auto-detection को ओवरराइड करती हैं
लॉक तब भी बनी रहती है जब विज़िटर किसी अलग भाषा में टाइप करे

RTL (दाएं-से-बाएं) समर्थन

v1.6.2

विजेट और लैंडिंग पेज अरबी और हिब्रू के लिए RTL लेआउट का पूरी तरह से समर्थन करते हैं। जब कोई विज़िटर RTL locale का उपयोग करता है:

पूरा लेआउट मिरर हो जाता है (टेक्स्ट संरेखण, नेविगेशन, UI तत्व)
<html dir="rtl"> attribute स्वचालित रूप से सेट हो जाता है
चैट संदेश और input box RTL reading flow के लिए सही ढंग से align होते हैं

कोई मैनुअल कॉन्फ़िगरेशन आवश्यक नहीं है — RTL चुने गए locale के आधार पर स्वचालित रूप से सक्रिय होता है।

माउंट टाइमआउट फॉलबैक

v1.6.5

यदि विजेट स्क्रिप्ट (widget.js) 10 सेकंड के भीतर लोड होने में विफल रहती है, तो embed एक खाली जगह छोड़ने के बजाय एक fallback UI प्रदर्शित करता है। fallback में एक retry बटन शामिल है ताकि विज़िटर पेज रीफ्रेश किए बिना विजेट को पुनः लोड करने का प्रयास कर सके।

यह उपयोगकर्ता अनुभव की रक्षा करता है जब नेटवर्क समस्याएं, ad blockers, या CDN आउटेज विजेट को माउंट होने से रोकते हैं।

प्लान के अनुसार चैनल सीमाएं

प्लान	अधिकतम चैनल
Free	1
Starter	2
Growth	5
Plus	6
Pro	15
Scale	30
Enterprise	50