Service Object

Name

Type

Description

Name

Type

Description

id

string

unique service identifier

name

string

service name

enableService

boolean

enable/disable service

checkMediaUrl

string

url of the REST webservice to check agent availability

checkMediaInterval

number

milliseconds every how much the checkmedia must be called

widget

string

widget id associated with the service

enableChat

boolean

enable/disable chat channel

enableCallbackNow

boolean

enable/disable callback now

enableCallbackLater

boolean

enable/disable callback later

enableClickToCall

boolean

enable/disable click to call

enableScreensharing

boolean

enable/disable screen sharing

restart_chat

boolean

When a chat contact is terminated, configure to show again or not the engagement widget

enableVideo

boolean

video escalation option available during interaction

enableAudioNotifcation

boolean

Play a audio alert for each message received without focus on the page

audioNotificationUrl

string

path to file audio to be reproduced for audio notification

enableBrowserNotification

boolean

Show browser notification for each message reveiced without focus on the page

enableSendLink

boolean

Enable feature for sending links (customer side)

enableSendDocument

boolean

Enable feature for sending documents (customer side)

enableSendImageFeature

boolean

Enable feature for sending images (both agent and customer side)

enableSendDocumentFeature

boolean

Enable feature for sending documents (both agent and customer side)

compatibilityErrorMessage

localized string : accepts a string representing the label to be displayed or an object whose key is the country code and whose value is the relative label to be displayed.
Example:
{
"it-it" : "Messaggio italiano",
"en-gb" : "English message"
}

Message to show if widget is not compatible based on parameters configured in generalSettings (browserCompatibility, deviceCompatibility)

rules

string

list of entrypoints identified by webpage URL. Entrypoint is evaluated as regular expression against with the page URL

datacollection

array

list of datacollection id enabled

custom_css

string

path to custom css file

logo

string

path to logo image

language

string

country code of the language used. can be overwritten by query string param in the sdk url or by language_fn parameter

language_fn

string

custom function to set language

proactivity

object

object containing the proactivity rules. Please see the table below for the complete list of the properties.

callbackNowParameters

string

string rapresentation of a JSON object with the parameters passed to the callback now request

callbackLaterParameters

string

string rapresentation of a JSON object with the parameters passed to the callback later request

checkCallbackAvailableParameters

string

string rapresentation of a JSON object with the parameters passed to the check callback available request

botId

string

id of the bot aoosciated to the service

channel

string

channel of the service. Can be one of the following: web, whatsapp, messenger, instagram

enableBlur

boolean

enable/disable video blur during video chat

webrtc

object

Object containing the webrtc configuration. Please see the table below for the parameters.

custom_cfg

object

object that can contains custom parameters passed to the request for a new contact

enableLateEngagementChat

boolean

enable/disable late engagement chat, i.e. starting the chat only after the customer has written the first message

surveyExpireInMinutes

number

time window within which you can answer an open question in a WhatsApp survey

enableAutostartChat

boolean

enables the chat to start automatically as soon as the checkmedia returns a positive result

 

Proactivity Rules

 

Name

Type

Description

Name

Type

Description

engagementTimeout

number

Delay used to show the widget, expressed in ms. Note: engagementTimeout is not compatible with other rules. You need to set engagementTimeout to 0 to evaluate the others.

If you need to evaluate multiple rules at the same time you should use engagementFunctuion,

engagementOnClick

string

Widget shows up when user clicks on the area identified by the css selector specified

engagementOnMove

string

Widget shows up when user move the mouse over the area identified by the css selector specified

engagementFunction

string

Expected a JS function returning a Promise resolved with true when the widget is supposed to show up.

This function is useful to create a proactivity rule based on custom business logic. E.G. when a user add into the cart an item with a value higher than 100$

 

 

WebRTC Object

 

Name

Type

Description

Name

Type

Description

websocketServerURL

string

WebSocket URI to connect to

sipDestination

string

The destination endpoint that wish to call

iconUrl

string

custom icon url