Enhance your website, BoldDesk customer portal, or mobile app with real‑time support using the BoldDesk Live Chat widget. The Installation tab provides multiple integration options tailored to your tech stack: lightweight JavaScript code snippets for the native floating widget or CMS‑embedded iframe, the Web SDK (NPM package) for deeper programmatic control within web applications, and the native iOS and Android Mobile SDKs for push notifications and a fully native chat experience.

Prerequisites

• A Live Chat widget already exists.
• Your role includes the Manage Settings permission to access installation options.
  
  
  
  
  

1. Install on Websites & Web Apps (Code Snippets)

Use Embeddable Code (JavaScript) for a native floating widget, or Iframe Code for CMS/fixed‑area embeds.

Option 1. Embeddable Code (JS)

1. Go to Installation → Code Snippets.
2. Copy Embeddable Code (JavaScript).
3. Paste it right before the closing </body> tag on every page that should show chat.

Option 2. Iframe Code

1. Go to Installation → Code Snippets.
2. Copy Iframe Code.
3. Embed it where you want the widget to appear.

2. Install Via NPM (Web SDK)

Install and control the widget programmatically in your web app. Learn more on BoldDesk Live Chat Web SDK: Integrate & Control Chat Widget.

1. Go to Installation → NPM and copy the install command.
2. Initialize with your Web App Key (snippet provided on the page).

3. Install in Mobile Apps (iOS & Android)

iOS SDK

Navigate to Installation → iOS SDK to get:

• iOS App Key
• Code snippet to initialize the SDK
• Push Notification settings (Bundle ID, upload file, category)

Installation steps

• Copy the iOS App Key and paste it where you initialize the BoldDesk iOS SDK.
• Add the pre‑generated snippet to enable chat features.
• (Optional) Configure push notifications to receive message alerts and updates.
  
  
  
  
  

Android SDK

Navigate to Installation → Android SDK to get:

• Android App Key
• Android SDK initialisation snippet
• Push Notification configuration

Installation steps

• Copy the Android App Key and add it where you initialise the SDK.
• Paste the initialization snippet in your app.
• (Optional) Enable push notifications to receive incoming chat alerts and system notifications.
  
  
  
  
  

Customer Portal

To install a Live Chat Widget into the BoldDesk Customer Portal, learn more on How to Embed the BoldDesk Live Chat Widget in the Customer Portal.

Frequently Asked Questions

1. Where do I install the BoldDesk Live Chat widget from?
   Use Admin → Chat → Live Chat → (Edit widget) → Installation.

2. What channels can I install the BoldDesk Live Chat widget on?

   • Websites and web applications
   • BoldDesk Customer Portal
   • Mobile apps using iOS SDK or Android SDK

3. What installation methods are available in the Installation tab?

   • Code Snippets: Embeddable Code (JavaScript) and Iframe Code
   • Web SDK (NPM)
   • Mobile SDKs: iOS SDK and Android SDK

4. How do I add the widget using Embeddable Code (JavaScript)?
   Copy Installation → Code Snippets → Embeddable Code (JavaScript) and paste it right before the closing </body> tag on pages where chat should load.

5. When should I use Iframe Code instead of the JavaScript embed?
   Use Iframe Code for CMS or fixed-area embeds where adding a script tag is not convenient, or where the widget must render inside a defined page region.

6. Where do I get the Web App Key for the Web SDK (NPM)?
   The Web App Key and the initialization snippet are provided in Installation → NPM for the selected widget.

7. Where do I find the iOS App Key or Android App Key?

   • Installation → iOS SDK provides the iOS App Key
   • Installation → Android SDK provides the Android App Key

Related Articles

1. BoldDesk Live Chat Web SDK: Integrate & Control Chat Widget
2. How to Embed the BoldDesk Live Chat Widget in the Customer Portal