Website 進階使用指南

              
              <iframe
    class="livedesk-widget-iframe"
    src="https://livedesk-stg.engagelab.com/console/livedesk/widget/?website_token=iTMtGDnzR1tccf3fiikLjL71&action=autoStart" // website_token 填寫建立通道後產生的對應值
    title="Live desk"
    allow="camera;microphone"
/>

            

              
              Array.from(document.getElementsByTagName('iframe'))
.filter((iframe) => iframe.src && iframe.src.includes('livedesk'))
.forEach((iframe) =>
iframe.contentWindow?.postMessage(
'livedesk-widget:' +
JSON.stringify({
event: 'set-user',
identifier: 'your_user_id',
user: { name: '顯示名稱', email: 'user@example.com' },
}),
'*',
),
);

            

              
                  <iframe
      class="livedesk-widget-iframe"
      src="https://livedesk-stg.engagelab.com/console/livedesk/widget/?website_token=Etsz4XtvqKi7iqbHf8Ma6ZLR&action=autoStart&user_id=5002"
      title="LiveDesk"
      allow="camera;microphone"
    />

            

              
              window.addEventListener("livedesk:ready", function () {
  window.$livedesk.setUserId("使用者唯一 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.setUserId("使用者唯一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>