رہنمائی
ویب وجیٹ
ایمبیڈ کے قابل JS ویجٹ کو حسب ضرورت بنائیں —— برانڈنگ، شناخت اور ایونٹس۔
ویب ویجٹ ایک چھوٹا 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 تصدیق