Desk.com Help Widget

Last Updated -

Important Notice: The functionality demonstrated in this article is an example of a custom widget powered by Desk but not representative of out-of-the-box Desk functionality. While it is possible to create a custom widget like the one demonstrated in this article, it is not supported by Desk and will require a developer to implement and maintain.



The Desk.com Help Widget is a support center experience that you can embed it on your website or within your mobile app via a WebView. Your customers can browse your knowledge base, submit a ticket, and manage their open cases all without leaving your website or app. Click here for a demo!

 

I. Creating the Backend web theme

The Backend web theme feeds your knowledge base data into your Help Widget.

  1. Create a new web theme with name "Help Widget (Backend)".
  2. Edit your new web theme and click into the Advanced Themes tab.
  3. At the bottom right, click "Edit in Source Mode".
  4. Copy and paste the header and footer from here into your web theme and save.
  5. Click Preview at the top-right and save the URL for later.

II. Creating the Frontend web theme

The Frontend web theme is what your users see. It controls how things look and feel within your widget.

  1. Create a new web theme with name "Help Widget (Frontend)".
  2. Edit your new web theme and click into the Advanced Themes tab.
  3. At the bottom right, click "Edit in Source Mode".
  4. Copy and paste the header and footer from here into your web theme and save.
  5. At the bottom right, click "Edit in Editor Mode".
  6. On the left, click into "Page (Index)"
  7. Search within this section to find and replace all instances of "######" with the ?t= number from Step 5.
  8. Click Preview at the top-right and save the URL for later.

III. Embedding your Help Widget

  1. Paste the code below into your website.

  2. Edit the loadHelpWidget(...) line to match the URL from Step 13.

If embedding the Help Widget into your mobile app, just point your WebView to this the URL of your Help Widget theme from Step 13.