网页挂件

网页挂件是一个很小的 JS 包（gzip 后约 30 kB），它会在任意页面的右下角 挂载一个聊天气泡。

加载

<script src="https://singchat.org/widget.js"
        data-app-id="YOUR_APP_ID"
        data-base-url="https://singchat.org"></script>

⚠️ 务必从 singchat.org 加载 ， 不要拷贝或自托管 widget.js。 从官方地址加载，挂件会自动保持最新。如果你把文件下载下来、或编译进自己的打包产物，就会把它「冻」在某个旧版本，之后所有更新都收不到。详见接入总览。

识别已登录用户

对于匿名访客，挂件会自动生成一个联系人。对于已登录用户，请调用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 认证