General Settings

General settings for configuring the chat widget:

Property	Default	Description
`headerIcon`	`''`	Icon displayed in the pre-chat form and widget header. Can be an image URL or base64-encoded image.
`hasSendButton`	`true`	Whether the send message button is shown.
`hasDragAndDropAttachment`	`true`	Enables drag-and-drop file uploads.
`isDialogMaximised`	`false`	Whether the widget dialog is maximised on page load.
`isChatCloseControlEnabled`	`true`	Whether the chat close (×) control is enabled.
`isChatMinimizeControlEnabled`	`true`	Whether the minimize / expand controls are enabled.
`maskCreditCardNumbers`	`true`	Redacts detected credit card or IBAN numbers before display or transmission.
`isAnimationDisabled`	`false`	Disables widget mount and unmount animations.
`enableInactiveTabNotifications`	`true`	Shows unread message notifications in the page title when the tab is not focused.
`delayBetweenBotMessages`	`1000`	Synthetic delay (in ms) between consecutive bot messages.
`enableCrmUserAttachments`	`true`	Allows users to upload attachments after agent handover. Only applies when `crmSDKPlatform` is defined.
`enableNavigationTracking`	`true`	Emits a system event when the user navigates pages. May not work for some SPAs.
`showDownloadAttachmentsButton`	`true`	Whether to display a download button for message attachments.
`persistSession`	`true`	Whether to persist the chat sessions across page reloads.
`isEmbeddedMode`	`false`	When `true`, the widget is always maximised and closing the chat ends the conversation but keeps the widget visible.
`maxUserMessageLength`	`250`	Maximum number of characters allowed in a user message.
`sendMessageOnEnterKey`	`true`	Whether to send messages when the `Enter` key is pressed. When `false`, `Enter` inserts a newline.
`messageAnimationDuration`	`300`	Duration (in ms) of message entry animations.
`isChatLauncherEnabled`	`true`	Whether the chat launcher is visible. If `false`, the widget must be launched programmatically.
`isWidgetDisabled`	`false`	Whether the widget is enabled or not.
`csatCloseButtonDisabled`	`false`	Whether the CSAT close button is disabled.
`enableUnreadNotification`	`true`	Whether to show an unread notification on the launcher button.
`enableBackToBottomButton`	`true`	Displays a back to bottom button when the user scrolls in up in the chat thread.
`closeChatAfterAgentInitiatedCsat`	`false`	Automatically closes the widget after the user submits CSAT following an agent-ended chat.
`enableHeaderBlur`	`false`	Makes the widget header translucent and blurs background content.
`externalLaunchElement`	`null`	CSS selector for an external DOM element that launches the widget when clicked.
`launcherVariant`	`'chatBubbles'`	Predefined launcher style: `chatBubbles`, `smile`, `star`, or `starSpin`.
`openLinksInNewTab`	`true`	Opens all links sent in chat messages in a new browser tab.
`enableAIThinkingIndicator`	`true`	Shows AI thinking labels (from `lang.aiThinkingLabels`) instead of typing dots while AI is generating a response.
`closeChatAfterAgentEndedChat`	`false`	When true, the widget will close when an agent ends the chat.
`enableTranscriptDownload`	`false`	Adds an option in the header to download the chat transcript as a .txt file.