Website Advanced Usage Guide

              
              <iframe
    class="livedesk-widget-iframe"
    src="https://livedesk-stg.engagelab.com/console/livedesk/widget/?website_token=iTMtGDnzR1tccf3fiikLjL71&action=autoStart" // Replace website_token with the corresponding value generated after creating the channel
    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: 'Display 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("Unique user ID (such as user_id)", {  // The first parameter is the 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 Inbox settings
const message = 'Unique user ID';
const identifier_hash = crypto.createHmac('sha256', key).update(message).digest('hex');

// Attach in setUser
window.$livedesk.setUserId("Unique user ID", {
  ...Other information,
  identifier_hash: identifier_hash
});

            

              
              window.$livedesk.setConversationCustomAttributes({
  utm_source: "google",  // Example: conversation-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 (such as 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 the widget by passing a state
window.$livedesk.toggle("open"); // Open the chat widget
window.$livedesk.toggle("close"); // Close the chat widget

            

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

            

              
              window.$livedesk.popoutChatWindow();

            

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

            

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

            

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

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

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

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

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

  // Hide the small bubble icon at the bottom (suitable for placement in a custom button)
  hideMessageBubble: false,

  // Hide the "pop-out window" arrow button in the bottom-right corner
  showPopoutButton: false,

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

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

  // Prompt text shown when online/offline
  availableMessage: "We are online and ready to assist you at any time",
  unavailableMessage: "We are currently offline and will reply as soon as possible during business hours",

  // Feature switches
  enableFileUpload: true,       // Allow file uploads
  enableEmojiPicker: true,      // Allow emoji usage
  enableEndConversation: true,  // Allow users to end the conversation proactively

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

</script>

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