Configure widgets and services

From Genesys Documentation
Jump to: navigation, search
This topic is part of the manual Widgets Developer's Guide for version Current of Widgets.

Learn how to configure widgets and services.

Related documentation:

Depending on your product, you can use Genesys Widgets for functionality such as WebChat or Callback. You can configure all widgets and services in the same configuration object. When you add new Genesys products and services, you must update your Genesys Widgets configuration to enable those widgets.

After you deploy Genesys Widgets on your website, configure the CX Widget by defining the global window._genesys Javascript object.

To include the JavaScript script, you can choose one of the following options:

  • Place the script inline on your website
  • Place it in a separate JavaScript file, and include the file on your page

The following example is a basic view of the global Genesys Widgets configuration object:


        if(!window._genesys)window._genesys = {};
        if(!window._gt)window._gt = [];

        window._genesys.widgets = {

                main: {},
                webchat: {},


// include widgets.min.js after defining your configuration options

The following example is a populated Widget configuration that includes configuration options for WebChat.

You must define your configuration options on the page before widgets.min.js is loaded.
        if(!window._genesys)window._genesys = {};
        if(!window._gt)window._gt = [];
        window._genesys.widgets = {
                main: {
                        theme: "dark",
                        lang: "en",
                        i18n: "http://HOST:PORT/path/to/languages/file.json",
                        customStylesheetID: "<ANY_ID_NAME>",
                        mobileMode: 'auto',
                        mobileModeBreakpoint: 600
                webchat: {
                        apikey: "0123456789", // Used for Apigee service only
                        dataURL: "http://HOST:PORT/path/to/chat/service",
                        userData: {},
                        proactive: {
                                enabled: true,
                                idleTimer: 5,
                                cancelTimer: 30
                        chatButton: {
                                enabled: true,
                                template: false, 
                                openDelay: 1000,
                                effectDuration: 300,
                                hideDuringInvite: true
	var f = function(){
		var d = o.location;
		o.aTags = o.aTags || [];
		for(var i=0;i<o.aTags.length;i++){
			var oTag = o.aTags[i];
			var fs = d.getElementsByTagName(oTag.type)[0], e;
			if(d.getElementById( return; e = d.createElement(oTag.type); =;
			if(oTag.type == "script"){e.src = oTag.path;}
                        else{e.type = 'text/css';e.rel = 'stylesheet';e.href = oTag.path;}
			if(fs){fs.parentNode.insertBefore(e, fs);}else{d.head.appendChild(e);}
		}},ol = window.onload;
		if(o.onload){typeof window.onload != "function"?window.onload=f:window.onload=function(){ol();f();}}else f();
})({location: document, 
     onload: false, 
     aTags: [{type:"script", id:"genesys-cx-widget-script", path:""}, 
		 {type:"link", id:"genesys-cx-widget-styles", path:""}]});

Main Configuration

Genesys Widgets is a hub for multiple Genesys products and services. Some configuration options are set globally and therefore apply to all products and services running on the CX Widget platform. In the main application configuration you can configure options such as visual theme, language, and mobile support.

For detailed information on configuration options, see app configuration options.

Widget Configuration Options


Launcher is a sample page that shows how Genesys Widgets are displayed on any host website. Use this page to:

  • View Genesys Widgets with your own configuration.
  • Copy the Configuration Script; for example, using the details you entered on the form, the configuration script is generated in the Need Configuration Script section. You can copy this script and use it in your website to launch Widgets.
  • Starting in the version, use the Launcher tool to test and configure between the different API services available in Genesys, namely under Genesys Multicloud CX, GenesysEngage-cloud and Genesys Cloud CX.

How to use Launcher

To enable the Sidebar plugin, select this check box in Launcher. By default, Sidebar will be shown on the right side of the screen on Widgets startup. You can configure SideBar by using the options shown under this section. Provide the sidebar channel configuration in the corresponding text area according to the Sidebar documentation or use the provided sample configuration links to pre-fill the sample data in the text area. Ensure that the channels defined here are enabled and configured as well.

Enable Live Assist (EWT)
Select the check box next to Enable Live Assist (EWT) to enable the ChannelSelector plugin. Enter the Stats URL followed by the virtual queue names to fetch the Estimated Wait Time details. Refer to the Channel Selector documentation for more information. To show Chat, SendMessage and CallUs channels in this plugin, please make sure that you select these plugins in this Launcher page.

Select the WebChat check box to enable WebChat. You must enter a URL. Other values are optional and self-explanatory.
Starting in the version, WebChat supports Genesys Multicloud CX v3 API via the transports configuration section. You can test this in the Launcher tool using the WebChat [with Transport only] section under the GenesysEngage-cloud tab.

Select the check box next to Call Us and provide the configuration data. Note that you can select the Edit/Use Sample Config option to use sample configuration data, which you can edit it with your own detail data. Ideally, Call Us is shown in the Live Assist widget. It can also be launched with the bus command.

Select the check box next to Callback to include the Callback and Calendar plugins. Enter the callback service provider URL field and other details as required. Ensure Enable Sidebar with Live Assist is selected.

Lazy Loading
Select the check box next to Enable Lazy loading to launch Widgets in the lazy-load mode. Otherwise they will be launched on startup. At the minimum, Sidebar plugin must be enabled and configured with the required channels to load it on Widgets startup.

Once you have entered all of the necessary configuration details, click the Launch button to launch Widgets.

Retrieved from " (2023-09-27 02:00:03)"
Comments or questions about this documentation? Contact us for support!