KustomerCore.getChatSettings()

Returns the chat configuration settings.

👍

First, initialize chat

You must initialize with KustomerCore.init() before you can execute any additional Core SDK methods

Examples

// get chat settings
const chatSettings = KustomerCore.getChatSettings();

Syntax

returnValue = KustomerCore.getChatSettings();
ParameterTypeDescription
returnValueObjectRequired

An instance of SettingsAttributes

SettingsAttributes

ParameterTypeDescription
enabledBooleanIf false, completely disables Kustomer. To edit, go to Channels > Chat > Settings > Enable Chat toggle on the Kustomer website.
sharedPubNubKeySetObject{ subscribeKey: string, publishKey: string }
teamIconUrlStringThe URL where the team icon image can be found.
embedIconUrlStringThe URL where the icon to open the chat widget is found.
teamNameStringThe name of the support team to be displayed.
greetingStringThe greeting displayed when the organization is available.
waitMessageStringMessage to show before an agent joins the conversation, at the top of the chat screen. Shown when inside of business hours and not during a holiday. If offlineDisplay == .online, this is also shown outside of business hours/holidays.
singleSessionChatBooleanOnly allow one active conversation at a time. If true, customer can’t create a new chat if they already have one open.
noHistoryBooleanWhen chats are ended, they are not shown in previous conversation history.
offhoursImageUrlStringImage to display when offline (outside of business hours) on the blank new conversation screen.
offhoursMessageStringGreeting message to show at top of screen when offline (outside of business hours). Shown when outside of business hours (or during a holiday) and when offhoursDisplay == .offline
offhoursDisplayStringHow to handle chat when outside of business hours. Either act like the organization is online, show it as offline, or hide chat entirely.
closableChatBooleanAllow both a User and Customer to end a chat conversation. No further chat messages will be able to be sent in an ended conversation.
showTypingIndicatorCustomerWebBooleanShow if the agent is typing in the mobile sdk.
showTypingIndicatorWebBooleanIf we should send typing indicators when the customer is typing on their phone.
domainCriteriaObjectUse KustomerCore.isUrlAllowed() to evaluate a URL against these rules
widgetTypeShow chat, kb, or both.
activeAssistantStringThe unique ID of the default conversational assistant used for all new chat conversations.
assistantRulesArray of AssistantRule InstancesUse KustomerCore.GetAssistant() to get the assistant that is active after these rules are evaluated.
colorsObjectSee the SettingsColors section below to see the properties of the object.
brandIdStringThe Id of the brand that this setting applies to.
knowledgeBaseIdStringThe unique ID of the knowledge base.

SettingsColors

ParameterType
headerBackgroundString
headerPrimaryTextString
headerSecondaryTextString
agentBubbleBackgroundString
agentBubblePrimaryTextString
agentBubbleSecondaryTextString
customerBubbleBackgroundString
customerBubblePrimaryTextString
primaryButtonBackgroundString
primaryButtonBackgroundHoverString
primaryButtonTextString