...

Widget appearance and behavior

  • Width: the The width and height of the chat window, its colors and position.

  • Text of buttons.

  • Behavior: make the conversation refresh on close, or make the chat modal.

...

Button appearance

  • Text of the button and its tooltip.

  • Button colors for default and hover states.

  • Button position.

  • The tooltip hide timeout.

  • The button icon.

  • Hide the button.

  • Widget icon file.

...

Copying ID

Click Save and copy the widget ID — you will need to enter it in ServiceNow later. The ID is available in the browser address bar (the last value after /), or in the Code for embedding area on the right side of the window.

...

Enabling the widget in ServiceNow

In ServiceNow, go to Virtual Agent for IT Service Desk > Properties and enter the host for your Kbot application and the widget ID.

...

Migrating from old widget

In older widget versions, you had to set the widget configuration in your ServiceNow environment:

...

In case you are migrating from an old version of widget to the new one, you might want to keep the parameters you have defined earlier. To do so, export the properties from the sys_properties table:

Code Block
Application = "Virtual Agent for IT Service Desk"

...

Setting

Parameter

Widget width

x_konve_kbot_test.kbot.widget.width

...

Widget height

x_konve_kbot_test.kbot.widget.height

...

...

Chat window position:

Title background color

...

x_konve_kbot_test.kbot.widget.color_title_bg

...

Title text color

...

x_konve_kbot_test.kbot.widget.color_title_text

...

Text of the “resize” button

x_konve_kbot_test.kbot.widget.label_resize

...

Text of the “close” button

x_konve_kbot_test.kbot.widget.label_close

...

Text of the “minimize” button

x_konve_kbot_test.kbot.widget.label_minimize

...

Refresh conversation on close

...

x_konve_kbot_test.kbot.widget.refresh_on_close

...

Button appearance

...

...

Make the chat modal:

Text of the widget button

x_konve_kbot_test.kbot.widget.label_button

...

Button tooltip

...

x_konve_kbot_test.kbot.widget.label_tooltip

...

Button background color

...

x_konve_kbot_test.kbot.widget.color_button_bg

...

Button

...

text color

...

...

x_konve_kbot_test.kbot.widget.color_button_text

...

Button

...

position

x_konve_kbot_test.kbot.widget.button_position

...

Tooltip hide timeout:

...

Display the button icon:

...

Hide button

x_konve_kbot_test.kbot.widget.buttonInvisible

...

Widget icon file

...

x_konve_kbot_test.kbot.widget.iconUrl

...

Copying ID

Click Save and copy the widget ID — you will need to enter it in ServiceNow later. The ID is available in the browser address bar (the last value after /), or in the Code for embedding area on the right side of the window.

...

Enabling the widget in ServiceNow

In ServiceNow, go to Virtual Agent for IT Service Desk > Properties and enter the host for your Kbot application and the widget ID.

...

Previously, you had to set the widget configuration in your ServiceNow environment. The old widget properties view in ServiceNow contained the settings.

...

Migrating from old widget

In case you are migrating from old version of widget to the new one, you might want to keep the parameters you have defined earlier. To do so, export the properties from the sys_properties table:

Code Block
Application = "Virtual Agent for IT Service Desk"

...