Javascript API: Methods

Tiledesk provides a Tiledesk JavaScript object that responds to a few methods. These allow you to update widget without a page refresh and interact with the messenger window.
Open the widget
This will open the widget:
1
window.Tiledesk('open');
Copied!
Minimize the widget
This will minimize the widget:
1
window.Tiledesk('close');
Copied!
Hide the widget
This will hide the widget:
1
window.Tiledesk('hide');
Copied!
Show the widget
This will show the widget:
1
window.Tiledesk('show');
Copied!
Reinitialize the widget
If your app is characterized by very few page refreshes (ie., content is swapped out on the client side but no page refresh happens, Angular, React, jQuery, etc..) and lots of asynchronous JS, you'll need to update Tiledesk when your user's data changes. A reInit call simulates a page refresh, causing Tiledesk to reload the widget and all the configurations.
1
window.Tiledesk('reInit');
Copied!
Restart the widget
This method allow you to restart widget with the same user's data without make a new authentication. This also mantein all the configurations.
1
window.Tiledesk('restart');
Copied!
Signin with anonymously
This method make a signin anonymously
1
window.Tiledesk('signInAnonymous');
Copied!
Signin with JWT Custom Token
This method make a signin using a JWT Custom Token as described here.
1
window.Tiledesk('signInWithCustomToken', customJwt);
Copied!
Make a logout
This will logout the widget:
1
window.Tiledesk('logout');
Copied!
Show callout
This will show the widget callout if it is not open:
1
window.Tiledesk('showCallout');
Copied!
Show or hide the PreChatForm
This parameter configures the PreChatForm visibility:
1
window.Tiledesk('setPreChatForm', true|false);
Copied!
Set custom PreChatForm Json
This method allow you to customize preChatFormJson property, and change preChatForm structure if preChatForm is still active (ensure preChatForm value is set to true, otherwize use window.Tiledesk('setPreChatForm', true) method before call setPreChatFormJson ). This method accept an Array (see docs for more detail about customize it):
1
window.Tiledesk('setPreChatFormJson', customFormArray);
Copied!
Get custom PreChatForm Json
This method allow you to get current preChatForm Json array used in the preChatForm component when is active (check preChatForm value is set to true):
1
window.Tiledesk('setPreChatFormJson', customFormArray);
Copied!
Set new value to Widget parameter
You can change a value to the Tiledesk Widget parameter. Pass an object in the form of key/value, where key represent che name of the property you want to modify, and value is the new value you want to set:
1
window.Tiledesk('setParameter', {key: string, value: string});
Copied!
Set new value to Widget attribute parameter
You can change a value to the Tiledesk Widget attribute parameter. Pass an object in the form of key/value, where key represent che name of the property you want to modify, and value is the new value you want to set:
1
window.Tiledesk('setAttributeParameter', {key: string, value: string});
Copied!