網頁掛件

網頁元件是一個很小的 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 認證