Javascript API Methods

It seems like you are looking for a way to programatically interact with your HelpKit widget? You have come to the right place. Using our Javascript widget API is super simple. With it, you can control and customize your widget behavior.

The available methods are:

To open the widget you can use the Helpkit.show() function.

Helpkit.show(view, type?, articleId?)

In order to open the widget within your website all you have to do is define the view parameter

Example of a button with an event listener that displays the widget 👇

<button onclick="Helpkit.show('popover')">Open the widget</button>

Visual Difference of Popover vs Sidebar view

Here you can see the visual difference between 'popover' and 'sidebar'

In order to open a single article within your website you have to define all three parameters.

Example of a button with an event listener that displays a single article 👇

<button onclick="Helpkit.show('popover', 'article', 'qYFazNTSwDkVohWu9S5rbe')">Open the widget</button>

In order to obtain the articleId string simply:

In order to open the HelpKit contact form use the type ’contact’ as your parameter.

Example of a button with an event listener that displays a single article 👇

<button onclick="Helpkit.show('popover', 'contact')">Contact us</button>

This function allows you to programatically set the fields for the HelpKit email contact form. It expects an object containing one or more valid fields to be set. Calling the function again will update the respective field(s).

Helpkit.setContactFields(fields)

The fields object should contain at least one key value pair:

An example of how to programatically set the contact fields

Helpkit.setContactFields({
	name: “John Doe”, 
	email: “john.doe@acme.com”, 
	subject: “Feature Request”, 
	metadata: “Project Id: 10 | Project Name: demos” 
})

A very common workflow would be to set the name and email for your users right after the have logged in. This way they don’t have to retype their contact information whenever they need to submit a new ticket.

How will metadata be displayed?

As you can see metadata can be of type any type such as string, object or an array. HelpKit will conveniently convert it into a string and append it at the bottom of your support ticket email after a dotted line:

To open close the widget you can use the Helpkit.close() function

In case you want to hide the launch button (the button that you can find at the bottom right corner with the text “Help” by default) in certain scenarios.

Makes the launch button reappear.