أداة الويب

أداة الويب عبارة عن حزمة JS صغيرة (نحو 30 kB بعد ضغط gzip) تقوم بتركيب فقاعة دردشة في الزاوية السفلية لأي صفحة.

التحميل

<script src="https://singchat.org/widget.js"
        data-app-id="YOUR_APP_ID"
        data-base-url="https://singchat.org"></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") متوفرة في باقة Pro وما فوقها.

الأمان

• المعرّف app-id عام ، لا بأس بإدراجه في HTML
• المفتاح السري مخصص للخادم فقط ، لا تكشفه أبدًا في كود المتصفح
• في الحالات التي تتطلب ثقة عالية، وقِّع حمولات المستخدم من جهة الخادم باستخدام المفتاح السري (HMAC-SHA256) ، راجع مصادقة API