General Settings
General Settings
General settings for configuring the chat widget:
Property | Default | Description |
---|---|---|
delayBetweenBotMessages | 1000 | The synthetic delay added by the widget if the DG bot sends multiple messages in a row. |
messageAnimationDuration | 300 | The duration of the animation on messages entering the widget. |
enableInactiveTabNotifications | true | Enables a notification in the page title about new messages when the page is not focused. |
hasDragAndDropAttachment | true | Enables drag-and-drop functionality for file uploads. |
hasSendButton | true | Whether the send message button is enabled. |
headerIcon | '' | Specifies the header icon for the chat dialog. |
initializationDelay | null | Sets how long to delay the display of the widget UI (in milliseconds). |
isAnimationDisabled | false | Disables widget mount/unmount animations. |
isChatCloseControlEnabled | true | Whether the dialog close control is enabled or not. |
isChatMinimizeControlEnabled | true | Whether the dialog minimize/expand controls are enabled or not. |
isDialogMaximised | false | Whether the widget should be maximized on page load. |
isChatLauncherEnabled | true | Whether the chat launcher is enabled. If set to false , the widget must be manually launched. |
maskCreditCardNumbers | true | Redacts any credit card or IBAN numbers entered into the widget before they are displayed or transmitted to any server. |
showDownloadAttachmentsButton | true | Whether to show the download button for attachments. |
enableCrmUserAttachments | true | Enables the user to upload attachments after handing over to an agent. Only applies to Sunco and Gorgias. |
enableNavigationTracking | true | Adds a system event to the conversation page when the user navigates to a new page. May not work for some single-page apps. Use the trackNavigation method. |
enableDGPoweredByLink | true | Whether the 'Powered by DigitalGenius' link is displayed and linked to the DG website. |
persistSession | true | Persists the session between page reloads or multiple tabs. Disabling this is useful for WISMO widgets. |
isEmbeddedMode | false | When true , the widget is maximized by default, and when the user closes the chat, the conversation ends, but the widget remains open with the pre-chat form. |
isWidgetDisabled | false | When true , the widget will not be displayed. |
maxUserMessageLength | 250 | The maximum number of characters a user can send in a message. |
Maximising widget with URL parameter
The widget can be maximised on page load when the current page url contains the parameter dg-widget-launch
.
For example:
www.google.com?dg-widget-launch
or
www.google.com?some-other-param&dg-widget-launch
For this functionality to work, you must ensure you haven't explicitly set isDialogMaximised: false
in config.
Updated 4 days ago
What’s Next