Website Advanced Guide

              
              window.addEventListener("livedesk:ready", function () {
  window.$livedesk.setUser("User Unique ID (e.g. user_id)", {  // First parameter is unique identifier
    email: "user@example.com",
    name: "User Name",
    avatar_url: "https://example.com/avatar.jpg",  // Optional
    phone_number: "+1234567890"  // Optional
  });
});

            

              
              const crypto = require('crypto');
const key = 'Your HMAC Token';  // Copy from Inboxes settings
const message = 'User Unique ID';
const identifier_hash = crypto.createHmac('sha256', key).update(message).digest('hex');

// Attach in setUser
window.$livedesk.setUser("User Unique ID", {
  ...other info,
  identifier_hash: identifier_hash
});

            

              
              window.$livedesk.setConversationCustomAttributes({
  utm_source: "google",  // Example: Session level UTM
  session_type: "support"
});

            

              
              window.addEventListener("livedesk:ready", function () {
  window.$livedesk.setCustomAttributes({
    pricing_plan: "premium",  // key: Predefined unique identifier, value: set according to type (e.g., string)
    signup_date: new Date(),  // Example: Date type
    account_id: 123           // Example: Number type
  });
});

            

              
              window.$livedesk.deleteCustomAttribute("pricing_plan");//string attribute key name

            

              
              window.$livdesk.toggle();

// Toggle widget by passing state
window.$livedesk.toggle("open"); // Open chat widget
window.$livedesk.toggle("close"); // Close chat widget

            

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

            

              
              window.$livedesk.popoutChatWindow();

            

              
              window.$livedesk.setLocale("en");// string language code, example: zh-CN

            

              
              window.$livdesk.setLabel('support-ticket');// string label identifier
window.$livdesk.removeLabel('support-ticket');

            

              
              <script>
// 1. Set global configuration before loading sdk.js (must be placed at the very beginning of the script)
window.livedeskSettings = {
  // Widget position: bottom left (default is bottom right)
  position: "left",

  // Force language to Simplified Chinese (will display Chinese even if browser is English)
  locale: "zh-CN",

  // Automatically detect browser language (if you want to prioritize user browser language, set to true and delete locale above)
  // useBrowserLanguage: true,

  // Widget type: expanded_bubble = large bubble (with welcome message), standard = classic small bubble
  type: "expanded_bubble",

  // Dark mode (auto follow system or force dark)
  darkMode: "auto",        // Optional values: true | false | "auto"

  // Hide the small bubble icon at the bottom (suitable for placing in custom buttons)
  hideMessageBubble: false,

  // Hide the "popout window" small arrow button in the bottom right corner
  showPopoutButton: false,

  // Custom launcher title (displayed in expanded bubble mode)
  launcherTitle: "Online Support",

  // Welcome message (effective in expanded_bubble mode)
  welcomeTitle: "Hello! How can we help you?",
  welcomeDescription: "We usually reply within a few minutes~",

  // Prompt text displayed when online/offline
  availableMessage: "We are online, ready to serve you",
  unavailableMessage: "We are currently offline, will reply as soon as possible during business hours",

  // Feature switches
  enableFileUpload: true,       // Allow file upload
  enableEmojiPicker: true,      // Allow using emojis
  enableEndConversation: true,  // Allow user to actively end conversation

  // Other advanced options (open as needed)
  // showUnreadMessagesDialog: true,   // Pop-up reminder when there are unread messages (default true)
  // baseDomain: "yourcompany.com",    // Use for multi-domain deployment
};

</script>

<!-- 2. Load livedesk Widget SDK (replace with your own domain and token) -->
<script>
  (function(d,t) {
    var BASE_URL="https://www.engagelab.com";          // ← Change to your livedesk address
    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',  // ← Change to your Website Token
        baseUrl: BASE_URL
      });
    }
  })(document,"script");
</script>