網頁聊天 Widget

快速上手

1. 1 在你的工作區開啟「設定 → 網頁聊天」並啟用 Widget。
2. 2 在「允許的來源」加入每個可載入 Widget 的網站來源。
3. 3 複製嵌入程式碼，貼到 </body> 結束標籤之前。

<script src="https://widget.rosettachat.app/widget.js" data-site="wgt_..." async></script>

簽章訪客身分（選用）

若訪客已在你的網站登入，可證明其身分，讓客服看到「已驗證」標記，並讓對話帶有穩定的 external_user_id。在「設定 → 網頁聊天」產生簽章密鑰，於後端簽出 token 並透過 data-identity 傳入。切勿將密鑰暴露到瀏覽器。

import crypto from 'node:crypto';

function signIdentity(secret, payload) {
  const b64 = Buffer.from(JSON.stringify(payload)).toString('base64url');
  const sig = crypto.createHmac('sha256', secret).update(b64).digest('hex');
  return `${b64}.${sig}`;
}

const token = signIdentity(process.env.ROSETTA_IDENTITY_SECRET, {
  external_user_id: user.id,
  name: user.name,
  email: user.email,
});

Webhook

可訂閱 conversation.created、conversation.closed，以及（選擇性）message.created。每次投遞都以 X-Rosetta-Signature: t=<unix>,v1=<hmac_sha256("t.body", secret)> 簽章；用建立 Webhook 時僅顯示一次的密鑰驗證。

測試模式

開發時使用沙箱嵌入程式碼（獨立的測試金鑰）。其對話會標記為測試、不計入客服用量、不出現在預設收件匣，並會自動清除。