विजेट इंस्टॉल करें

RolChat विजेट एक फ़्लोटिंग बटन है जो आपके चालू किए गए मॉड्यूल के अनुसार ढल जाता है: चैट, कॉलबैक अनुरोध फ़ॉर्म, मीटिंग बुकिंग, लीड फ़ॉर्म और ज्ञान आधार खोज, सब इसी के अंदर हैं। इसे एक बार इंस्टॉल करें; यह क्या दिखाता है, वह डैशबोर्ड में तय होता है।

1. स्निपेट कॉपी करें

सेटिंग्स → विजेट में साइट चुनें और इंस्टॉल स्निपेट कॉपी करें। यह ऐसा दिखता है:

<!-- RolChat widget -->
<script>
  window.rolchatConfig = {
    "site_id": "ste_…",
    "account_id": "…",
    "widget_key": "wk1.<site>.<signature>",
    "modules": ["chat"]
  };
</script>
<script async src="https://widget.rolchat.com/stub.js"></script>

विजेट कुंजी सार्वजनिक है और पेज में रखना सुरक्षित है। यह आपकी साइट का नाम बताती है और हस्ताक्षरित है, इसलिए कोई भी विजेट की कॉपी को आपके खाते की ओर नहीं मोड़ सकता। जब आप विजेट सेटिंग्स बदलते हैं तो डैशबोर्ड ऑब्जेक्ट में और कुंजियाँ जोड़ता है (अभिवादन, हेडर शीर्षक, थीम, कार्य समय, हर स्क्रीन आकार के लिए लेआउट); बदलाव के बाद स्निपेट फिर से कॉपी करें, या ऑब्जेक्ट को न्यूनतम रखें और बाकी विजेट को खुद लाने दें।

stub.js कुछ किलोबाइट का है और बाकी हिस्सा तभी लोड करता है जब विज़िटर को उसकी ज़रूरत हो: पहली बार खोलने पर चैट इंटरफ़ेस, सहमति के बाद ट्रैकिंग, और जहाँ ज़रूरी हो वहाँ सहमति बैनर।

2. इसे `</body>` से पहले पेस्ट करें

स्निपेट को हर उस पेज पर जोड़ें जहाँ आप विजेट चाहते हैं, बेहतर है कि साइट टेम्पलेट या टैग मैनेजर के ज़रिए, ताकि यह एक साथ हर जगह दिखे। स्क्रिप्ट एसिंक्रोनस रूप से लोड होती है और रेंडरिंग नहीं रोकती; पहले लोड का बंडल जान-बूझकर छोटा रखा गया है ताकि आपके Core Web Vitals पर असर न पड़े।

3. जाँचें कि यह काम करता है

अपनी साइट को प्राइवेट विंडो में खोलें। बटन आपके चुने कोने में दिखता है। डैशबोर्ड में विज़िटर नया अनाम सेशन रियल-टाइम में दिखाता है, और विजेट से भेजा गया संदेश इनबॉक्स में नई बातचीत के रूप में आता है।

लॉग-इन उपयोगकर्ताओं की पहचान करें

अगर आपके विज़िटर आपके उत्पाद में साइन इन करते हैं, तो RolChat को बताएँ कि वे कौन हैं ताकि बातचीत सही संपर्क से जुड़े:

window.rolchat.identify({
  email: "alice@example.com",
  first_name: "Alice",
  last_name: "Martin",
  phone: "+15551234567",
  external_id: "user_12345",
  custom_fields: { plan: "pro" },
});

स्वीकृत गुण हैं email, phone, first_name, last_name, external_id और एक सपाट custom_fields ऑब्जेक्ट; बाकी सब अनदेखा किया जाता है। RolChat CRM में ईमेल खोजता है। अगर संपर्क मौजूद है, तो सेशन उससे जुड़ जाता है और एजेंट प्रोफ़ाइल देखता है; अगर नहीं, तो विवरण रख लिए जाते हैं और विज़िटर के पहली बार लिखने पर लीड बनती है।

अधिक भरोसे के लिए आपका बैकएंड पहचान पर हस्ताक्षर कर सकता है: RolChat उपयोगकर्ता के लिए जो हस्ताक्षर जारी करता है उसे गुणों के साथ भेजें, और सेशन तभी प्रमोट होगा जब हस्ताक्षर सत्यापित हो। उपयोगकर्ता के साइन आउट करने पर window.rolchat.reset() कॉल करें, वरना उस ब्राउज़र पर अगला व्यक्ति पिछली बातचीत देखेगा।

JavaScript API

stub चलते ही window.rolchat उपलब्ध हो जाता है; बंडल लोड होने से पहले की गई कॉल कतार में रखी जाती हैं और क्रम से चलाई जाती हैं।

मेथड	यह क्या करता है
`show()` / `hide()`	लॉन्चर दिखाएँ या छिपाएँ
`open()` / `close()`	चैट पैनल खोलें या बंद करें
`identify(traits)`	सेशन को किसी व्यक्ति से जोड़ें (ऊपर)
`reset()`	पहचान भूलें और नया अनाम सेशन शुरू करें
`pushEvent(name, props)`	ट्रिगर संदेशों और स्वचालन के लिए कस्टम इवेंट भेजें
`trackPageView(path?)`	सिंगल-पेज ऐप में पेज व्यू रिपोर्ट करें
`setLocale(code)`	विजेट की भाषा बदलें
`showConsentPreferences()`	सहमति प्राथमिकता केंद्र खोलें
`on(event, handler)` / `off(event, handler)`	`chat:opened`, `chat:closed`, `message:sent`, `message:received`, `session:started` की सदस्यता लें

window.rolchat.pushEvent("cart_abandoned", { value: 129.9, currency: "EUR" });
window.rolchat.on("message:received", () => audio.play());

भाषा और दिशा

विजेट वही भाषा बोलता है जिसे आप window.rolchatConfig में lang से तय करते हैं (उदाहरण के लिए "lang": "de"); इसके बिना वह विज़िटर के ब्राउज़र की भाषा बोलता है, ब्राउज़र की पसंद के क्रम में, RolChat द्वारा समर्थित 40 भाषाओं में से; कोई भी मेल न खाए तो अंग्रेज़ी। साइट की अपनी भाषा सेटिंग का उपयोग नहीं होता: विजेट को अपनी साइट की भाषा में बोलवाने के लिए lang सेट करें। अरबी और हिब्रू दाएँ से बाएँ दिखती हैं। विजेट एजेंट के संदेशों का अनुवाद नहीं करता; एजेंट की ओर से इसके बजाय AI लाइव अनुवाद इस्तेमाल किया जा सकता है।

कुकीज़ और सहमति

जहाँ सहमति बैनर ज़रूरी है, वहाँ विजेट सहमति से पहले विज़िटरों को ट्रैक नहीं करता। अगर आप RolChat का गोपनीयता मॉड्यूल इस्तेमाल करते हैं, तो बैनर और विजेट एक ही सहमति स्थिति साझा करते हैं। अगर आप कोई दूसरा सहमति टूल इस्तेमाल करते हैं, तो विजेट के एनालिटिक्स इवेंट उस सिग्नल का इंतज़ार करते हैं जो आप सेटिंग्स → गोपनीयता → एम्बेड में कॉन्फ़िगर करते हैं।

विजेट कहाँ कॉन्फ़िगर होता है

क्या	कहाँ
रंग, स्थान, अभिवादन, एंट्री पॉइंट, इंस्टॉल स्निपेट	सेटिंग्स → विजेट
विजेट के अंदर कौन से मॉड्यूल दिखें	सेटिंग्स → मॉड्यूल (हर साइट के लिए)
कार्य समय और ऑफ़लाइन संदेश	सेटिंग्स → साइटें → कार्य समय
खास पेजों पर दिखने वाले ट्रिगर संदेश	मार्केटिंग → ट्रिगर