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>