Website高級用法指南

              
              window.addEventListener("livedesk:ready", function () {
  window.$livedesk.setUser("用戶唯一ID（如 user_id）", {  // 第一個參數為唯一識別碼
    email: "user@example.com",
    name: "用戶姓名",
    avatar_url: "https://example.com/avatar.jpg",  // 可選
    phone_number: "+1234567890"  // 可選
  });
});

            

              
              const crypto = require('crypto');
const key = '你的 HMAC Token';  // 從 Inboxes 設置複製
const message = '用戶唯一ID';
const identifier_hash = crypto.createHmac('sha256', key).update(message).digest('hex');

// 在 setUser 中附加
window.$livedesk.setUser("用戶唯一ID", {
  ...其他資訊,
  identifier_hash: identifier_hash
});

            

              
              window.$livedesk.setConversationCustomAttributes({
  utm_source: "google",  // 示例：會話級 UTM
  session_type: "support"
});

            

              
              window.addEventListener("livedesk:ready", function () {
  window.$livedesk.setCustomAttributes({
    pricing_plan: "premium",  // key: 預定義的唯一標識，value: 根據類型設置（如字串）
    signup_date: new Date(),  // 示例：日期類型
    account_id: 123           // 示例：數字類型
  });
});

            

              
              window.$livedesk.deleteCustomAttribute("pricing_plan");//string屬性鍵名

            

              
              window.$livdesk.toggle();

// Toggle widget by passing state
window.$livedesk.toggle("open"); // 打開聊天部件
window.$livedesk.toggle("close"); // 關閉聊天部件

            

              
              window.$livedesk.toggleBubbleVisibility('hide');// show/hide

            

              
              window.$livedesk.popoutChatWindow();

            

              
              window.$livedesk.setLocale("en");// string語言代碼，示例：zh-CN

            

              
              window.$livdesk.setLabel('support-ticket');// string標籤識別碼
window.$livdesk.removeLabel('support-ticket');

            

              
              <script>
// 1. 在載入 sdk.js 之前，先設置全域配置（必須放在腳本最前面）
window.livedeskSettings = {
  // 小工具位置：左下角（預設是右下角）
  position: "left",

  // 語言強制為簡體中文（即使瀏覽器是英文也會顯示中文）
  locale: "zh-CN",

  // 自動檢測瀏覽器語言（如果想優先用用戶瀏覽器語言，設為 true 並刪除上面的 locale）
  // useBrowserLanguage: true,

  // 小工具類型：expanded_bubble = 大氣泡（帶歡迎語），standard = 經典小氣泡
  type: "expanded_bubble",

  // 暗黑模式（自動跟隨系統或強制暗色）
  darkMode: "auto",        // 可選值：true | false | "auto"

  // 隱藏底部的小氣泡圖示（適合放在自定義按鈕裡）
  hideMessageBubble: false,

  // 隱藏右下角的“彈出視窗”小箭頭按鈕
  showPopoutButton: false,

  // 自定義啟動器標題（大氣泡模式下顯示）
  launcherTitle: "線上客服",

  // 歡迎訊息（expanded_bubble 模式下生效）
  welcomeTitle: "您好！有什麼可以幫助您的？",
  welcomeDescription: "我們通常會在幾分鐘內回復～",

  // 線上/離線時顯示的提示文字
  availableMessage: "我們線上，隨時為您服務",
  unavailableMessage: "我們當前不在線，會在上班時間儘快回復您",

  // 功能開關
  enableFileUpload: true,       // 允許上傳檔案
  enableEmojiPicker: true,      // 允許使用表情
  enableEndConversation: true,  // 允許用戶主動結束對話

  // 其他高級選項（視需求打開）
  // showUnreadMessagesDialog: true,   // 有未讀訊息時彈窗提醒（預設 true）
  // baseDomain: "yourcompany.com",    // 多域名部署時使用
};

</script>

<!-- 2. 載入 livedesk Widget SDK（替換成你自己的域名和 token）-->
<script>
  (function(d,t) {
    var BASE_URL="https://www.engagelab.com";          // ← 改成你的 livedesk 地址
    var g=d.createElement(t),s=d.getElementsByTagName(t)[0];
    g.src=BASE_URL+"/packs/js/sdk.js";
    g.defer = true;
    g.async = true;
    s.parentNode.insertBefore(g,s);
    g.onload=function(){
      window.livedeskSDK.run({
        websiteToken: 'abcdefgh1234567890abcdefgh123456',  // ← 改成你的 Website Token
        baseUrl: BASE_URL
      });
    }
  })(document,"script");
</script>