Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Virtual Agent for IT Help Desk is installed on your ServiceNow instance.

  • The button is set for the whole portal.

References

  • The To view the Kbot UI script (replace the host in this link with your host), search for x_konve_kbot_test.KonversoWebChatWidget in ServiceNow.

  • To learn more about building custom widgets, view the official ServiceNow documentation.

...

Hiding the default button

1. In your ServiceNow environment, open the KonversoWidgetSettingsUtils object.

2. Add the following string:

Code Block
buttonInvisible: true

...

To hide the default button, select the Hide button checkbox in the widget creation tool.

...

Info

To view the complete set of widget options, see this page.

Creating a new widget

1. Open the Service Portal Configuration. To do so, either find Service Portal Configuration in the navigation tree, or go directly to https://<your-host>.service-now.com/sp_config.

...

Info

You can find the widget ID (which is 'service-now-chat' here) in the UI script (replace the host in this link with your host), search for Kbot.get().Widgets.init (string number 170).

As the a result, you should get the following:

...

  1. Save the widget.

Case of multiple widgets, same target host:

You need to ensure your two init functions:

Code Block
Kbot.get().Widgets.initRemoteConfig('widget-id-value-1')
Kbot.get().Widgets.initRemoteConfig('widget-id-value-2')

All you need to to have two distinct client scripts, each pointing to a different widget id.

Code Block
api.controller=function() {
  /* widget controller */
  var c = this;
  c.showKbotWidget = function() {
        
		Kbot.get().Widgets.execute('widget-id-value-2', 'showWidget')
	}
};

Adding the widget to a portal

...

6. Drag and drop it to the area where you want to place the button.

7. Click . Save the changes.

Now you can click Preview to see how the page will look with the button.

...