वेब विजेट

वेब विजेट एक छोटा JS बंडल है (gzip के बाद लगभग 30 kB) जो किसी भी पेज के निचले कोने में एक चैट बबल माउंट करता है।

लोडिंग

<script src="https://cs.askais.com/widget.js"
        data-app-id="YOUR_APP_ID"
        data-base-url="https://cs.askais.com"></script>

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

गुमनाम विज़िटर्स के लिए, विजेट स्वचालित रूप से एक संपर्क बनाता है। लॉग इन किए गए उपयोगकर्ताओं के लिए, अपने उपयोगकर्ता की जानकारी के साथ SingChat.identify() को कॉल करें:

window.SingChat.identify({
  externalId: "user_123",
  name: "Ada Lovelace",
  email: "ada@example.com",
  customAttributes: { plan: "pro", signupAt: "2025-01-12" },
});

प्रोग्रामेटिक रूप से खोलना / बंद करना

SingChat.open();
SingChat.close();
SingChat.toggle();

इवेंट्स सुनना

SingChat.on("message:new", (msg) => {
  console.log("new message", msg);
});

SingChat.on("ai:stream:end", ({ messageId }) => {
  // AI finished streaming
});

थीमिंग

Settings → Inboxesमें आप विजेट का प्राथमिक रंग, स्थिति और स्वागत संदेश कॉन्फ़िगर कर सकते हैं। व्हाइट-लेबल ("Powered by AskAIs Customer Service" छिपाना) Pro और उससे ऊपर के प्लान पर उपलब्ध है।

सुरक्षा

• app-id सार्वजनिक है — इसे HTML में शामिल करना ठीक है
• सीक्रेट की केवल सर्वर-साइड के लिए है — इसे कभी भी ब्राउज़र कोड में उजागर न करें
• उच्च-विश्वास वाले उपयोग मामलों के लिए, सीक्रेट की के साथ सर्वर-साइड पर उपयोगकर्ता पेलोड पर हस्ताक्षर करें (HMAC-SHA256) — देखें API प्रमाणीकरण