Service Object
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. | 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 |
---|---|---|
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 |
---|---|---|
websocketServerURL | string | WebSocket URI to connect to |
sipDestination | string | The destination endpoint that wish to call |
iconUrl | string | custom icon url |