วิดเจ็ตเว็บ

วิดเจ็ตเว็บเป็นบันเดิล 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คุณสามารถกำหนดค่าสี หลักของวิดเจ็ต ตำแหน่ง และข้อความทักทาย White-label (ซ่อน "Powered by AskAIs") มีให้ใช้งานในแพ็กเกจ Pro ขึ้นไป

ความปลอดภัย

• app-id เป็นข้อมูลสาธารณะ, สามารถใส่ไว้ใน HTML ได้
• คีย์ลับ ใช้ที่ฝั่งเซิร์ฟเวอร์เท่านั้น, อย่าเปิดเผยในโค้ดของเบราว์เซอร์เด็ดขาด
• สำหรับกรณีการใช้งานที่ต้องการความเชื่อถือสูง ให้เซ็นเพย์โหลดของผู้ใช้ที่ฝั่งเซิร์ฟเวอร์ด้วยคีย์ลับ (HMAC-SHA256), ดู การยืนยันตัวตน API