Contact usRequest a demo

Preview

Configuration properties labelled "Preview":

  • Are new features for you to try out

  • May change or be removed without further notice in a future version

  • Shouldn’t be used in production

More about Preview

Deprecated

Configuration properties labelled "Deprecated":

  • Will be removed in the next major version of Unblu

  • Typically don’t affect the product anymore

More about Deprecated

User synchronization (LDAP) tool

abortSyncOnNoUsersReturned

com.unblu.addons.server.synctool.SyncTool.abortSyncOnNoUsersReturned

  • Type: Boolean

  • Default: true

  • Allowed scopes: GLOBAL, ACCOUNT

If true the syncjob is aborted if no users have been returned from the source system.

accountId

com.unblu.addons.server.synctool.SyncTool.accountId

  • Type: String

  • Default: wZvcAnbBSpOps9oteH-Oxw

  • Allowed scopes: GLOBAL

The unblu account id, default is UnbluEntityDefaults.DEFAULT_ACCOUNT_ID

multitenancySyncMode

com.unblu.addons.server.synctool.SyncTool.multitenancySyncMode

  • Type: Boolean

  • Default: false

  • Allowed scopes: IMMUTABLE

Whether the synctool should run in multitenancy mode

Overwrite existing target users

com.unblu.addons.server.synctool.SyncTool.overwriteExistingTargetUsers

  • Type: Boolean

  • Default: false

  • Allowed scopes: GLOBAL, ACCOUNT

If true, the sync job will overwrite users in the target system if it finds a user with the same username but different metadata. If false, the syncjob will skip users in the target system with the same username but different metadata, leaving them unchanged.

Delete synced users and teams

com.unblu.addons.server.synctool.SyncTool.propagateDeletes

  • Type: Boolean

  • Default: false

  • Allowed scopes: GLOBAL, ACCOUNT

Specifies whether teams and users that are no longer present in the LDAP source are deleted from the Unblu database

runAtCronExpressions

com.unblu.addons.synctool.runAtCronExpressions

  • Type: List of strings

  • Default: []

  • Allowed scopes: GLOBAL

If set, array of cron-like expression such as [* */15 * ? * * syncall','5 * * ? * * * syncuser',…​] to run syncronization periodically. Please see http://www.quartz-scheduler.org/documentation/quartz-2.3.0/tutorials/crontrigger.html, additionally it supports the @reboot cron command for example '@reboot syncall'. If you do, in fact, sync both teams and users, use of syncall instead of separate syncuser and syncteam is required.

EntitySourceLDAP

adminRoleIdentifier

com.unblu.addons.synctool.ldap.adminRoleIdentifier

  • Type: String

  • Allowed scopes: GLOBAL, ACCOUNT

Identifier for an Unblu Role, either as a property on user or for %role% in the roleFilter

baseDN

com.unblu.addons.synctool.ldap.baseDN

  • Type: String

  • Allowed scopes: GLOBAL, ACCOUNT

base dn for all filters retrieval

connectionSecurity

com.unblu.addons.synctool.ldap.connectionSecurity

  • Type: String with allowed values:

    • ldaps

    • none

    • starttls

  • Default: NONE

  • Allowed scopes: GLOBAL, ACCOUNT

Connection security to use: one of 'NONE' for no encryption,'LDAPS' for SSL/TLS support or 'STARTTLS' for Start TLS

defaultRole

com.unblu.addons.synctool.ldap.defaultRole

  • Type: String with allowed values:

    • admin

    • anonymous_user

    • partner

    • registered_user

    • supervisor

    • super_admin

    • technical_admin

    • webuser

  • Allowed scopes: GLOBAL, ACCOUNT

Default role for unblu users that aren’t assigned a role explicitly. If not set users without a role will be ignored and not synced.

pathToTrustedCertsKeyStoreFile

com.unblu.addons.synctool.ldap.pathToTrustedCertsKeyStoreFile

  • Type: String

  • Allowed scopes: GLOBAL, ACCOUNT

If an encrypted LDAP connection is used, this path is used to load a key store file, which contains the trusted certificates

registeredUserRoleIdentifier

com.unblu.addons.synctool.ldap.registeredUserRoleIdentifier

  • Type: String

  • Allowed scopes: GLOBAL, ACCOUNT

Identifier for an Unblu Role, either as a property on user or for %role% in the roleFilter

roleFilter

com.unblu.addons.synctool.ldap.roleFilter

  • Type: String

  • Allowed scopes: GLOBAL, ACCOUNT

LDAP filter to retrieve all unblu roles (if they are a groupOfNames), must contain %role% as wildcard for all roleIdentifiers

roleFilterBaseDN

com.unblu.addons.synctool.ldap.roleFilterBaseDN

  • Type: String

  • Allowed scopes: GLOBAL, ACCOUNT

base dn for role retrieval. Uses non-user/non-team baseDN as default

roleMemberAttributeName

com.unblu.addons.synctool.ldap.roleMemberAttributeName

  • Type: String

  • Default: member

  • Allowed scopes: GLOBAL, ACCOUNT

The member attribute name for member listing in role groupOfNames.

roleSearchScope

com.unblu.addons.synctool.ldap.roleSearchScope

  • Type: String with allowed values:

    • object

    • onelevel

    • subtree

  • Default: SUBTREE

  • Allowed scopes: GLOBAL, ACCOUNT

LDAP Search scope for the roleFilter based query. Possible values are OBJECT,ONELEVEL and SUBTREE

serverHostname

com.unblu.addons.synctool.ldap.serverHostname

  • Type: String

  • Allowed scopes: GLOBAL, ACCOUNT

The ldap server hostname or ip

serverPassword

com.unblu.addons.synctool.ldap.serverPassword

  • Type: Secret

  • Allowed scopes: GLOBAL, ACCOUNT

The authentication password for the serverUsername-user

serverPort

com.unblu.addons.synctool.ldap.serverPort

  • Type: Integer

  • Allowed scopes: GLOBAL, ACCOUNT

The ldap server port. If not specified (null), the default LDAP port (389 without ecryption or 636 for LDAPS) is used

serverUsername

com.unblu.addons.synctool.ldap.serverUsername

  • Type: String

  • Allowed scopes: GLOBAL, ACCOUNT

Server Username (usually similar to cn=Admin or cn=Directory Manager,…​

superadminRoleIdentifier

com.unblu.addons.synctool.ldap.superadminRoleIdentifier

  • Type: String

  • Allowed scopes: GLOBAL, ACCOUNT

Identifier for an Unblu Role, either as a property on user or for %role% in the roleFilter

supervisorRoleIdentifier

com.unblu.addons.synctool.ldap.supervisorRoleIdentifier

  • Type: String

  • Allowed scopes: GLOBAL, ACCOUNT

Identifier for an Unblu Role, either as a property on user or for %role% in the roleFilter

teamFilter

com.unblu.addons.synctool.ldap.teamFilter

  • Type: String

  • Allowed scopes: GLOBAL, ACCOUNT

LDAP filter to retrieve all unblu teams, may contain %team% or %role%

teamFilterBaseDN

com.unblu.addons.synctool.ldap.teamFilterBaseDN

  • Type: String

  • Allowed scopes: GLOBAL, ACCOUNT

base dn for team retrieval. Uses non-user/non-team baseDN as default

teamIdAttributeName

com.unblu.addons.synctool.ldap.teamIdAttributeName

  • Type: String

  • Allowed scopes: GLOBAL, ACCOUNT

The team id attribute name

teamMatchOrderPrecedence

com.unblu.addons.synctool.ldap.teamMatchOrderPrecedence

  • Type: List of strings

  • Allowed scopes: GLOBAL, ACCOUNT

A list of regular expressions in a specific order. If a user is assigned to multiple teams in the LDAP system, this list specifies the order in which his team is chosen. The list of teams from LDAP is matched against this list. Entries appearing earlier in the list will have precedence over entries appearing later or not at all.

teamMemberAttributeName

com.unblu.addons.synctool.ldap.teamMemberAttributeName

  • Type: String

  • Default: member

  • Allowed scopes: GLOBAL, ACCOUNT

The member attribute name for member listing in team groupOfNames.

teamSearchScope

com.unblu.addons.synctool.ldap.teamSearchScope

  • Type: String with allowed values:

    • object

    • onelevel

    • subtree

  • Default: SUBTREE

  • Allowed scopes: GLOBAL, ACCOUNT

LDAP Search scope for the teamFilter based query. Possible values are OBJECT,ONELEVEL and SUBTREE

technicaladminRoleIdentifier

com.unblu.addons.synctool.ldap.technicaladminRoleIdentifier

  • Type: String

  • Allowed scopes: GLOBAL, ACCOUNT

Identifier for an Unblu Role, either as a property on user or for %role% in the roleFilter

timeoutMS

com.unblu.addons.synctool.ldap.timeoutMS

  • Type: Integer

  • Default: 30000

  • Allowed scopes: GLOBAL, ACCOUNT

The timeout in milliseconds for ldap connections

trustManagerAlgorithm

com.unblu.addons.synctool.ldap.trustManagerAlgorithm

  • Type: String

  • Allowed scopes: GLOBAL, ACCOUNT

Defines the algorithm which is used to read/use the trusted certifactes from the keystore file. If not specified, the default which is defined in the jvm property 'ssl.TrustManagerFactory.algorithm' is used. Normaly this is 'PKIX'. Other known type is 'SunX509'

trustedCertsKeyStorePassword

com.unblu.addons.synctool.ldap.trustedCertsKeyStorePassword

  • Type: Secret

  • Allowed scopes: GLOBAL, ACCOUNT

If an encrypted LDAP connection is used, this password is used to load a key store file, which contains the trusted certificates

trustedCertsKeyStoreType

com.unblu.addons.synctool.ldap.trustedCertsKeyStoreType

  • Type: String

  • Allowed scopes: GLOBAL, ACCOUNT

Defines the type of the keystore file, which contains the trusted certificates. If not specified, the default which is stored in the jvm security.property file at 'keystore.type' is used. Normaly this is 'JKS'. All known types: 'JCEKS', 'JKS', 'DKS', 'PKCS11', 'PKCS12'

userEmailAttributeName

com.unblu.addons.synctool.ldap.userEmailAttributeName

  • Type: String

  • Allowed scopes: GLOBAL, ACCOUNT

The attribute name of the user entry/object that stores the email address of the user (optional)

userFilter

com.unblu.addons.synctool.ldap.userFilter

  • Type: String

  • Allowed scopes: GLOBAL, ACCOUNT

LDAP filter to retrieve all unblu users, may contain %team%

userFilterBaseDN

com.unblu.addons.synctool.ldap.userFilterBaseDN

  • Type: String

  • Allowed scopes: GLOBAL, ACCOUNT

base dn for user retrieval. Uses non-user/non-team baseDN as default

userFirstNameAttributeName

com.unblu.addons.synctool.ldap.userFirstNameAttributeName

  • Type: String

  • Allowed scopes: GLOBAL, ACCOUNT

The attribute name of the user entry/object that stores the last name of the user (optional)

userIdAttributeName

com.unblu.addons.synctool.ldap.userIdAttributeName

  • Type: String

  • Allowed scopes: GLOBAL, ACCOUNT

The user id attribute name

userLastNameAttributeName

com.unblu.addons.synctool.ldap.userLastNameAttributeName

  • Type: String

  • Allowed scopes: GLOBAL, ACCOUNT

The attribute name of the user entry/object that stores the last name of the user (optional)

userNameAttributeName

com.unblu.addons.synctool.ldap.userNameAttributeName

  • Type: String

  • Allowed scopes: GLOBAL, ACCOUNT

The user name attribute name

userSearchScope

com.unblu.addons.synctool.ldap.userSearchScope

  • Type: String with allowed values:

    • object

    • onelevel

    • subtree

  • Default: SUBTREE

  • Allowed scopes: GLOBAL, ACCOUNT

LDAP Search scope for the userFilter based query. Possible values are OBJECT,ONELEVEL and SUBTREE

Authenticator configuration

Authentication token TTL

com.unblu.authenticator.authenticationTokenTTLInSeconds

  • Type: Integer

  • Default: 120

  • Allowed scopes: GLOBAL, ACCOUNT

The time to live (TTL), in seconds, for authentication tokens

Reject user logins

com.unblu.authenticator.rejectUserLogins

  • Type: Boolean

  • Default: true

  • Allowed scopes: GLOBAL, ACCOUNT

Whether normal user logins should be rejected or not if a password file for the superadmin exists.

Canned responses list configuration

Number of days back to count canned response usages

com.unblu.agent.cannedresponses.list.ui.pastDaysToCountUsageFor

  • Type: Integer

  • Default: 30

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

The resulting usages are displayed in the canned response management UIs. Maximum is 180 days.

CannedResponsesRoleGuard

cannedResponsesMinimalRole

com.unblu.core.settings.cannedResponsesMinimalRole

  • Type: String with allowed values:

    • admin

    • anonymous_user

    • partner

    • registered_user

    • supervisor

    • super_admin

    • technical_admin

    • webuser

  • Default: REGISTERED_USER

  • Allowed scopes: GLOBAL, ACCOUNT

Minimal role for settings cannedResponses module

Deputy relationships role guard

Minimum role for changes in "deputyRelationships"

com.unblu.core.settings.deputyRelationshipsMinimalRole

  • Type: String with allowed values:

    • admin

    • anonymous_user

    • partner

    • registered_user

    • supervisor

    • super_admin

    • technical_admin

    • webuser

  • Default: REGISTERED_USER

  • Allowed scopes: GLOBAL, ACCOUNT

The minimum role for changing settings in the "deputyRelationships" module

Account and Global Server Configuration interface sidebar style

Color of active navigation entry

com.unblu.config.nav.ui.activeHighlight

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.primary500\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Account and Global Server Configuration interfaces

Background color of hovered navigation entry

com.unblu.config.nav.ui.backgroundHover

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.neutral100\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Account and Global Server Configuration interfaces

Background color of hovered active navigation entry

com.unblu.config.nav.ui.backgroundHoverActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.neutral100\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Account and Global Server Configuration interfaces

Background color of navigation entry

com.unblu.config.nav.ui.backgroundNormal

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.backgroundLight\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Account and Global Server Configuration interfaces

Background color of active navigation entry

com.unblu.config.nav.ui.backgroundNormalActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.backgroundLight\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Account and Global Server Configuration interfaces

Background color of pressed navigation entry

com.unblu.config.nav.ui.backgroundPress

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.neutral200\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Account and Global Server Configuration interfaces

Background color of pressed active navigation entry

com.unblu.config.nav.ui.backgroundPressActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.neutral200\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Account and Global Server Configuration interfaces

Border color of hovered navigation entry

com.unblu.config.nav.ui.borderHover

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Account and Global Server Configuration interfaces

Border color of hovered active navigation entry

com.unblu.config.nav.ui.borderHoverActive

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Account and Global Server Configuration interfaces

Border color of navigation entry

com.unblu.config.nav.ui.borderNormal

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Account and Global Server Configuration interfaces

Border color of active navigation entry

com.unblu.config.nav.ui.borderNormalActive

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Account and Global Server Configuration interfaces

Border color of pressed navigation entry

com.unblu.config.nav.ui.borderPress

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Account and Global Server Configuration interfaces

Border color of pressed active navigation entry

com.unblu.config.nav.ui.borderPressActive

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Account and Global Server Configuration interfaces

Border radius of navigation entry

com.unblu.config.nav.ui.borderRadius

  • Type: Integer

  • Default: 4

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Account and Global Server Configuration interfaces

Border width of navigation entry

com.unblu.config.nav.ui.borderWidth

  • Type: Integer

  • Default: 1

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Account and Global Server Configuration interfaces

Foreground color of hovered navigation entry

com.unblu.config.nav.ui.foregroundHover

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorLinkDark\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Account and Global Server Configuration interfaces

Foreground color of hovered active navigation entry

com.unblu.config.nav.ui.foregroundHoverActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorLinkDark\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Account and Global Server Configuration interfaces

Foreground color of navigation entry

com.unblu.config.nav.ui.foregroundNormal

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorLinkDark\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Account and Global Server Configuration interfaces

Foreground color of active navigation entry

com.unblu.config.nav.ui.foregroundNormalActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorLinkDark\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Account and Global Server Configuration interfaces

Foreground color of pressed navigation entry

com.unblu.config.nav.ui.foregroundPress

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorLinkDark\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Account and Global Server Configuration interfaces

Foreground color of pressed active navigation entry

com.unblu.config.nav.ui.foregroundPressActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorLinkDark\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Account and Global Server Configuration interfaces

Background color

com.unblu.config.nav.ui.navBarBackground

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.neutral050\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Account and Global Server Configuration interfaces

Section header font color

com.unblu.config.nav.ui.sectionHeaderColor

  • Type: String with allowed values:

    • announcement

    • body

    • dark

    • error

    • inverted

    • inverted_mid

    • link

    • link_dark

    • mid

    • success

    • warn

  • Default: BODY

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Account and Global Server Configuration interfaces

Section header font size

com.unblu.config.nav.ui.sectionHeaderSize

  • Type: String with allowed values:

    • heading1

    • heading2

    • heading3

    • paragraph

    • small

    • tiny

  • Default: TINY

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Account and Global Server Configuration interfaces

Section header font weight

com.unblu.config.nav.ui.sectionHeaderWeight

  • Type: String with allowed values:

    • normal

    • semibold

  • Default: SEMIBOLD

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Account and Global Server Configuration interfaces

Conversation recording configuration

Action bar background color

com.unblu.recording.ui.actionBarBackgroundColor

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.neutral700\}

  • Allowed scopes: GLOBAL, ACCOUNT

The color used for the action bar’s background. It may be set to "transparent" to let a custom background shine through. If set to "transparent", make sure that "actionBarForeground" is set to "DARK" or "LIGHT", as "AUTO" won’t work in this case.

Action bar divider color

com.unblu.recording.ui.actionBarDividerColor

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.neutral700\}

  • Allowed scopes: GLOBAL, ACCOUNT

The color of the divider at the bottom of the action bar. Only relevant if actionBarElevation is set to "FLAT".

Action bar elevation

com.unblu.recording.ui.actionBarElevation

  • Type: String with allowed values:

    • elevated

    • flat

  • Default: ELEVATED

  • Allowed scopes: GLOBAL, ACCOUNT

The elevation of the action bar: "FLAT" displays a divider beneath the action bar and no shadow. "ELEVATED" displays a shadow beneath the action bar and no divider.

Action bar foreground brightness

com.unblu.recording.ui.actionBarForeground

  • Type: String with allowed values:

    • auto

    • dark

    • light

  • Default: AUTO

  • Allowed scopes: GLOBAL, ACCOUNT

The brightness of the action bar’s foreground color. When set to "AUTO", the foreground color will be chosen based on the action bar’s background color so as to guarantee a maximum contrast.

Collaboration space background color

com.unblu.recording.ui.collaborationSpaceBackgroundColor

  • Type: Complex color

  • Default: #525659

  • Allowed scopes: GLOBAL, ACCOUNT

Background color of the collaboration space for recordings

Right column width

com.unblu.recording.ui.rightColumnWidth

  • Type: Integer

  • Default: 360

  • Allowed scopes: GLOBAL, ACCOUNT

Width, in pixels, of the right-hand column for recordings. The right-hand column contains the chat and the call if multiple sources are active.

Agent action bar configuration

Action bar background color

com.unblu.agent.ui.actionbar.actionBarBackgroundColor

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.backgroundMid\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

The color used for the action bar’s background. It may be set to "transparent" to let a custom background shine through. If set to "transparent", make sure that "actionBarForeground" is set to "DARK" or "LIGHT", as "AUTO" won’t work in this case.

Action bar divider color

com.unblu.agent.ui.actionbar.actionBarDividerColor

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.border\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

The color of the divider at the bottom of the action bar. Only relevant if actionBarElevation is set to "FLAT".

Action bar elevation

com.unblu.agent.ui.actionbar.actionBarElevation

  • Type: String with allowed values:

    • elevated

    • flat

  • Default: FLAT

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

The elevation of the action bar: "FLAT" displays a divider beneath the action bar and no shadow. "ELEVATED" displays a shadow beneath the action bar and no divider.

Action bar foreground brightness

com.unblu.agent.ui.actionbar.actionBarForeground

  • Type: String with allowed values:

    • auto

    • dark

    • light

  • Default: AUTO

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

The brightness of the action bar’s foreground color. When set to "AUTO", the foreground color will be chosen based on the action bar’s background color so as to guarantee a maximum contrast.

Agent conversation shortcut configuration

Shortcut for toggling "mark mode" layer action

com.unblu.agent.conversation.shortcuts.layerActionMarkShortcut

  • Type: Keyboard shortcut

  • Default: $mod+shift+a

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Keyboard shortcut for toggling mark mode in the collaboration layer. Make sure it is not already used by the browser itself.

Collaboration layer remote control toggle shortcut

com.unblu.agent.conversation.shortcuts.layerActionRemoteControlShortcut

  • Type: Keyboard shortcut

  • Default: $mod+shift+s

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Keyboard shortcut for toggling the collaboration layer remote control. Make sure it is not already used by the browser itself.

Scroll lock layer action shortcut

com.unblu.agent.conversation.shortcuts.layerActionScrollLockShortcut

  • Type: Keyboard shortcut

  • Default: $mod+shift+l

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Keyboard shortcut for toggling the scroll lock in the collaboration layer. Make sure it is not already used by the browser itself.

Shortcut for opening canned responses selection dialog

com.unblu.agent.conversation.shortcuts.openCannedResponsesShortcut

  • Type: Keyboard shortcut

  • Default: $mod+y

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Keyboard shortcut for opening the canned responses selection dialog. Make sure it is not already used by the browser itself.

Shortcut for toggling chat panel

com.unblu.agent.conversation.shortcuts.toggleIndividualUiShortcut

  • Type: Keyboard shortcut

  • Default: $mod+shift+i

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Keyboard shortcut for toggling the chat panel in a conversation. Make sure it is not already used by the browser itself.

Shortcut to maximize/minimize the collaboration space

com.unblu.agent.conversation.shortcuts.toggleMaximizeCollabSpaceShortcut

  • Type: Keyboard shortcut

  • Default: $mod+shift+f

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Keyboard shortcut for maximizing and minimizing the collaboration space. Make sure it is not already used by the browser itself.

Agent conversation UI configuration

Show agent capacity for invitations

com.unblu.agent.conversation.ui.agentInviteShowCapacity

  • Type: Boolean

  • Default: false

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Show an agent’s availability to accept conversation requests when inviting them to a conversation or forwarding them a conversation. The information is only conclusive for agents who have an inbound queue for visitor-initiated conversations, and whose inbound queue is managed by Unblu rather than a third-party system.

Options of the "request awaited person type" dialog

com.unblu.agent.conversation.ui.changeAwaitedPersonTypeDialogOptions

  • Type: List of string with allowed values:s

    • agent

    • none

    • visitor

  • Default: NONE,VISITOR,AGENT

  • Allowed scopes: GLOBAL, ACCOUNT

Background color of the collaboration layer header bars

com.unblu.agent.conversation.ui.collaborationLayerHeaderBackgroundColor

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.neutral050\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Background color of the collaboration space

com.unblu.agent.conversation.ui.collaborationSpaceBackgroundColor

  • Type: Complex color

  • Default: #525659

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Chat panel default width

com.unblu.agent.conversation.ui.unbluUiDefaultWidth

  • Type: Integer

  • Default: 360

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

The default width of the Unblu individual UI

Collaboration layer maximize button style

"Hovered" background color

com.unblu.conversation.collabspace.layer.header.maximize.backgroundHover

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.flat.secondary.backgroundHover\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "collaboration layer maximize" button in "hovered" state

"Hovered" background color (active)

com.unblu.conversation.collabspace.layer.header.maximize.backgroundHoverActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.flat.secondary.backgroundHover\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "collaboration layer maximize" button in "hovered (active)" state

Normal background color

com.unblu.conversation.collabspace.layer.header.maximize.backgroundNormal

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.flat.secondary.backgroundNormal\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "collaboration layer maximize" button in "normal" state

Normal background color (active)

com.unblu.conversation.collabspace.layer.header.maximize.backgroundNormalActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.flat.secondary.backgroundNormal\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "collaboration layer maximize" button in "normal (active)" state

"Pressed" background color

com.unblu.conversation.collabspace.layer.header.maximize.backgroundPress

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.flat.secondary.backgroundPress\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "collaboration layer maximize" button in "pressed" state

"Pressed" background color (active)

com.unblu.conversation.collabspace.layer.header.maximize.backgroundPressActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.flat.secondary.backgroundPress\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "collaboration layer maximize" button in "pressed (active)" state

"Hovered" border color

com.unblu.conversation.collabspace.layer.header.maximize.borderHover

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.gray200\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of the "collaboration layer maximize" button in "hovered" state

"Hovered" border color (active)

com.unblu.conversation.collabspace.layer.header.maximize.borderHoverActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.gray200\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of the "collaboration layer maximize" button in "hovered (active)" state

Normal border color

com.unblu.conversation.collabspace.layer.header.maximize.borderNormal

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.gray200\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of the "collaboration layer maximize" button in "normal" state

Normal border color (active)

com.unblu.conversation.collabspace.layer.header.maximize.borderNormalActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.gray200\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of the "collaboration layer maximize" button in "normal (active)" state

"Pressed" border color

com.unblu.conversation.collabspace.layer.header.maximize.borderPress

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.gray200\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of the "collaboration layer maximize" button in "pressed" state

"Pressed" border color (active)

com.unblu.conversation.collabspace.layer.header.maximize.borderPressActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.gray200\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of the "collaboration layer maximize" button in "pressed (active)" state

Border width

com.unblu.conversation.collabspace.layer.header.maximize.borderWidth

  • Type: Integer

  • Default: 0

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Border width of the "collaboration layer maximize" button

"Hovered" foreground color

com.unblu.conversation.collabspace.layer.header.maximize.foregroundHover

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.flat.secondary.foregroundHover\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "collaboration layer maximize" button in "hovered" state

"Hovered" foreground color (active)

com.unblu.conversation.collabspace.layer.header.maximize.foregroundHoverActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorLink\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "collaboration layer maximize" button in "hovered (active)" state

Normal foreground color

com.unblu.conversation.collabspace.layer.header.maximize.foregroundNormal

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.flat.secondary.foregroundNormal\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "collaboration layer maximize" button in "normal" state

Normal foreground color (active)

com.unblu.conversation.collabspace.layer.header.maximize.foregroundNormalActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorLink\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "collaboration layer maximize" button in "normal (active)" state

"Press" foreground color

com.unblu.conversation.collabspace.layer.header.maximize.foregroundPress

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.flat.secondary.foregroundPress\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "collaboration layer maximize" button in "pressed" state

"Pressed" foreground color (active)

com.unblu.conversation.collabspace.layer.header.maximize.foregroundPressActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorLink\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "collaboration layer maximize" button in "pressed (active)" state

Base "edit conversation" component configuration

Allow creating scheduled conversations in the past

com.unblu.conversation.editflyin.allowCreatingConversationsInThePast

  • Type: Boolean

  • Default: true

  • Allowed scopes: GLOBAL, ACCOUNT

Specify if the UI allows the scheduled conversation time to be in the past when creating or editing

Inbox shortcut configuration

Shortcut to open "Forwarded" tab

com.unblu.agent.inbox.shortcuts.openInboxForwardedShortcut

  • Type: Keyboard shortcut

  • Default: alt+shift+f

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Keyboard shortcut to open the 'Forwarded' inbox tab. Make sure it isn’t already used by the browser itself and works on your keyboard layout.

Shortcut to open primary inbox tab

com.unblu.agent.inbox.shortcuts.openInboxPrimaryShortcut

  • Type: Keyboard shortcut

  • Default: alt+shift+p

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Keyboard shortcut to open the primary inbox tab. Make sure it isn’t already used by the browser itself and works on your keyboard layout.

Shortcut to open secondary inbox tab

com.unblu.agent.inbox.shortcuts.openInboxSecondaryShortcut

  • Type: Keyboard shortcut

  • Default: alt+shift+s

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Keyboard shortcut to open the secondary inbox tab. Make sure it isn’t already used by the browser itself and works on your keyboard layout.

Inbox UI configuration

defaultSortOrder

com.unblu.agent.inbox.ui.defaultSortOrder

  • Type: String with allowed values:

    • asc

    • desc

  • Default: DESC

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Sets the default sort order of conversations in the inbox. They will be sorted by last message time.

Display forwarded conversations in separate tab

com.unblu.agent.inbox.ui.displayForwardedConversationsInTabs

  • Type: Boolean

  • Default: true

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

If enabled, conversations forwarded by an agent are displayed on a separate tab in the agent’s inbox

Display two tabs in the agent inbox

com.unblu.agent.inbox.ui.displayOwnAndSecondaryConversationsInTabs

  • Type: Boolean

  • Default: true

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

If enabled, the agent inbox is split into two tabs: One tab for conversations where the agent is the primary agent and one for conversations where they are the secondary agent.

Conversation UI configuration

Join conversation timeout

com.unblu.conversation.ui.conversationJoinTimeout

  • Type: Integer

  • Default: 20000

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Timeout the UI waits trying to join and display a conversation

Conversation action bar configuration

Display mode of "assign conversation to me" action

com.unblu.conversation.actionbar.ui.assignConversationToMeActionDisplayMode

  • Type: String with allowed values:

    • always_in_overflow

    • always_show

    • hidden

    • show_if_possible

  • Default: ALWAYS_IN_OVERFLOW

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Specify how the "assign conversation to me" action should be displayed in the conversation action bar

Display mode of "change language" action

com.unblu.conversation.actionbar.ui.changeLanguageActionDisplayMode

  • Type: String with allowed values:

    • always_in_overflow

    • always_show

    • hidden

    • show_if_possible

  • Default: ALWAYS_IN_OVERFLOW

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Specify how the "change language" action should be displayed in the conversation action bar

Display mode of "change topic" action

com.unblu.conversation.actionbar.ui.changeTopicActionDisplayMode

  • Type: String with allowed values:

    • always_in_overflow

    • always_show

    • hidden

    • show_if_possible

  • Default: ALWAYS_IN_OVERFLOW

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Specify how the "change topic" action should be displayed in the conversation action bar

Display mode for "change secondary agent visibility" action

com.unblu.conversation.actionbar.ui.changeVisibilityActionDisplayMode

  • Type: String with allowed values:

    • always_in_overflow

    • always_show

    • hidden

    • show_if_possible

  • Default: ALWAYS_IN_OVERFLOW

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

How to display the action "change secondary agent visibility" in the conversation action bar. The action will only be available if permission to change the visibility for secondary agents has been granted in the conversation configuration.

Display mode for "collapse individual UI" action

com.unblu.conversation.actionbar.ui.collapseActionDisplayMode

  • Type: String with allowed values:

    • always_in_overflow

    • always_show

    • hidden

    • show_if_possible

  • Default: ALWAYS_IN_OVERFLOW

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Specify how the action "collapse individual UI" should be displayed in the conversation action bar

Display for "context migration co-browsing" action

com.unblu.conversation.actionbar.ui.contextMigrationCobrowsingActionDisplayMode

Only visible if: com.unblu.messenger.contextMigrationCoBrowsingEnabled=true

  • Type: String with allowed values:

    • always_in_overflow

    • always_show

    • hidden

    • show_if_possible

  • Default: HIDDEN

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

How the context migration co-browsing action should be displayed in the conversation action bar. Note: The action will only be displayed if the person also has the right to see & switch the layers

Display mode for "download message log" action

com.unblu.conversation.actionbar.ui.downloadMessageLogActionDisplayMode

  • Type: String with allowed values:

    • always_in_overflow

    • always_show

    • hidden

    • show_if_possible

  • Default: ALWAYS_IN_OVERFLOW

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Specify how the action "download message log" should be displayed in the conversation action bar. The action will only be available if permission to download the message log has been granted for the participant in the conversation configuration.

downloadMessageLogActionFormat

com.unblu.conversation.actionbar.ui.downloadMessageLogActionFormat

  • Type: String with allowed values:

    • csv

    • txt

  • Default: CSV

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

What file format the exported message log should have.

Display mode for "embedded co-browsing" action

com.unblu.conversation.actionbar.ui.embeddedCobrowsingActionDisplayMode

Only visible if: com.unblu.messenger.embeddedCoBrowsingEnabled=true

  • Type: String with allowed values:

    • always_in_overflow

    • always_show

    • hidden

    • show_if_possible

  • Default: HIDDEN

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

How the embedded co-browsing action should be displayed in the conversation action bar. Note: The action will only be displayed if the person also has the right to see & switch the layers

Display mode for "end conversation" action

com.unblu.conversation.actionbar.ui.endConversationActionDisplayMode

  • Type: String with allowed values:

    • always_in_overflow

    • always_show

    • hidden

    • show_if_possible

  • Default: ALWAYS_IN_OVERFLOW

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Specify how the action "end conversation" should be displayed in the conversation action bar. The action will only be available if permission to end the conversation has been granted for the participant in the conversation configuration.

Display mode for "leave conversation" action

com.unblu.conversation.actionbar.ui.leaveConversationActionDisplayMode

  • Type: String with allowed values:

    • always_in_overflow

    • always_show

    • hidden

    • show_if_possible

  • Default: ALWAYS_IN_OVERFLOW

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Specify how the action "leave conversation" should be displayed in the conversation action bar. The action will only be available if permission to leave the conversation has been granted for the participant in the conversation configuration.

Display mode for "minimize/maximize individual UI" action

com.unblu.conversation.actionbar.ui.minMaxActionDisplayMode

  • Type: String with allowed values:

    • always_in_overflow

    • always_show

    • hidden

    • show_if_possible

  • Default: ALWAYS_IN_OVERFLOW

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Specify how the action "minimize/maximize the individual UI" should be displayed in the conversation action bar

Display mode of "mobile co-browsing" action

com.unblu.conversation.actionbar.ui.mobileCoBrowsingActionDisplayMode

Only visible if: com.unblu.messenger.mobileCoBrowsingEnabled=true

  • Type: String with allowed values:

    • always_in_overflow

    • always_show

    • hidden

    • show_if_possible

  • Default: HIDDEN

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

How the mobile co-browsing action should be displayed in the conversation action bar. Note: The action will only be displayed if the person also has the right to see & switch the layers

Background color of the "participant overflow" button

com.unblu.conversation.actionbar.ui.participantOverflowAvatarBackgroundColor

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.neutral200\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Foreground color of the "participant overflow" button

com.unblu.conversation.actionbar.ui.participantOverflowAvatarForegroundColor

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.neutral900\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Pop out action display mode

com.unblu.conversation.actionbar.ui.popOutActionDisplayMode

  • Type: String with allowed values:

    • always_in_overflow

    • always_show

    • hidden

    • show_if_possible

  • Default: HIDDEN

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Specify how the "pop out" individual UI action should be displayed in the conversation action bar. The action will only be available in site integration implementations, and if the conversation’s "popoutEnabled" setting is "true".

Display mode of "screen sharing" action

com.unblu.conversation.actionbar.ui.screenSharingActionDisplayMode

Only visible if: com.unblu.messenger.screenSharingEnabled=true

  • Type: String with allowed values:

    • always_in_overflow

    • always_show

    • hidden

    • show_if_possible

  • Default: HIDDEN

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

How the screen sharing action should be displayed in the conversation action bar. Note: The action will only be displayed if the person also has the right to see & switch the layers

Show "back" button

com.unblu.conversation.actionbar.ui.showBackButton

  • Type: String with allowed values:

    • always

    • never

    • when_ended

  • Default: ALWAYS

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Specify how the "back" button should be displayed in the conversation action bar, if at all. The setting NEVER should only be used after careful consideration, since it can leave visitors stuck in a conversation.

Display mode for "show all files" action

com.unblu.conversation.actionbar.ui.showFilesActionDisplayMode

Only visible if: com.unblu.messenger.fileSharingEnabled=true

  • Type: String with allowed values:

    • always_in_overflow

    • always_show

    • hidden

    • show_if_possible

  • Default: ALWAYS_IN_OVERFLOW

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

How the action "show all files" should be displayed in the conversation action bar. The action will only be available if the permission required has been granted in the conversation configuration.

Universal action display mode

com.unblu.conversation.actionbar.ui.universalActionDisplayMode

Only visible if: com.unblu.messenger.universalCoBrowsingEnabled=true

  • Type: String with allowed values:

    • always_in_overflow

    • always_show

    • hidden

    • show_if_possible

  • Default: HIDDEN

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

How the universal co-browsing action should be displayed in the conversation action bar. Note: The action will only be displayed if the person also has the right to see & switch the layers

Display mode for "video call" action

com.unblu.conversation.actionbar.ui.videoCallActionDisplayMode

Only visible if: com.unblu.messenger.callEnabled=true

  • Type: String with allowed values:

    • always_in_overflow

    • always_show

    • hidden

    • show_if_possible

  • Default: SHOW_IF_POSSIBLE

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

How the action "video call" should be displayed in the conversation action bar. The action will only be available if the call permissions required have been granted in the conversation configuration.

Display mode for "voice call" action

com.unblu.conversation.actionbar.ui.voiceCallActionDisplayMode

Only visible if: com.unblu.messenger.callEnabled=true

  • Type: String with allowed values:

    • always_in_overflow

    • always_show

    • hidden

    • show_if_possible

  • Default: SHOW_IF_POSSIBLE

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

How the action "voice call" should be displayed in the conversation action bar. The action will only be available if the call permissions required have been granted in the conversation configuration.

Display mode for "whiteboard" action

com.unblu.conversation.actionbar.ui.whiteboardActionDisplayMode

Only visible if: com.unblu.messenger.whiteboardEnabled=true, com.unblu.platform.enablePreview=true

  • Type: String with allowed values:

    • always_in_overflow

    • always_show

    • hidden

    • show_if_possible

  • Default: HIDDEN

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

How the whiteboard action should be displayed in the conversation action bar. Note: The action is only displayed if the person also has the right to see & switch the layers.

Call shortcut configuration

Shortcut to toggle camera

com.unblu.conversation.call.shortcuts.toggleCamShortcut

  • Type: Keyboard shortcut

  • Default: $mod+e

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Keyboard shortcut for toggling the camera. Make sure it is not already used by the browser itself and works on your keyboard layout.

Shortcut to toggle microphone

com.unblu.conversation.call.shortcuts.toggleMicShortcut

  • Type: Keyboard shortcut

  • Default: $mod+d

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Keyboard shortcut for toggling the microphone. Make sure it is not already used by the browser itself and works on your keyboard layout.

Shortcut to toggle video background blurring

com.unblu.conversation.call.shortcuts.toggleVideoBackgroundBlurShortcut

  • Type: Keyboard shortcut

  • Default: $mod+b

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Keyboard shortcut for toggling the blur video background effect. Make sure it isn’t already used by the browser itself and works on your keyboard layout.

Call UI configuration

Border radius call button

com.unblu.conversation.call.borderRadiusCallButton

  • Type: Integer

  • Default: 100

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Border radius for all buttons in the call UI.

Color for "accept call" button

com.unblu.conversation.call.colorCallAcceptButton

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.highlightSuccess\}

  • Allowed scopes: GLOBAL, ACCOUNT

Color used for the "accept call" button

Background color of the call UI.

com.unblu.conversation.call.colorCallBackground

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.backgroundInverse\}

  • Allowed scopes: GLOBAL, ACCOUNT

Background color of the call UI

Call decline button color

com.unblu.conversation.call.colorCallDeclineButton

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.highlightError\}

  • Allowed scopes: GLOBAL, ACCOUNT

Color used for the decline call button.

Background color call type icon

com.unblu.conversation.call.colorCallTypeIconBackground

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.secondary400\}

  • Allowed scopes: GLOBAL, ACCOUNT

Background color of the call type icon displayed on incoming and outgoing calls.

Color of the audio indicator in videos

com.unblu.conversation.call.colorVideoAudioIndicator

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.highlightSuccess\}

  • Allowed scopes: GLOBAL, ACCOUNT

Color of the audio indicator displayed in video streams

Background color of labels in videos

com.unblu.conversation.call.colorVideoBackground

  • Type: Complex color

  • Default: rgba(0,0,0,0.2)

  • Allowed scopes: GLOBAL, ACCOUNT

Background color for video elements. Only visible if the person isn’t sharing their camera.

Background color of labels in videos

com.unblu.conversation.call.colorVideoLabelBackground

  • Type: Complex color

  • Default: rgba(0,0,0,0.6)

  • Allowed scopes: GLOBAL, ACCOUNT

Background color of labels displayed on top of video streams

Foreground color of labels in videos

com.unblu.conversation.call.colorVideoLabelForeground

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorTextInverted\}

  • Allowed scopes: GLOBAL, ACCOUNT

Foreground color of labels displayed on top of video streams

Minimized video height

com.unblu.conversation.call.videoMinimizedHeight

  • Type: Integer

  • Default: 120

  • Allowed scopes: GLOBAL, ACCOUNT

The height in pixels of a minimized video

Minimized video width

com.unblu.conversation.call.videoMinimizedWidth

  • Type: Integer

  • Default: 100

  • Allowed scopes: GLOBAL, ACCOUNT

The width in pixels of a minimized video

Call action button style

"Hovered" background color

com.unblu.conversation.call.button.action.backgroundHover

  • Type: Complex color

  • Default: adjust-color($\{com.unblu.conversation.call.button.action.backgroundNormal\}, $alpha: 0.05)

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "call action" button in "hovered" state

Normal background color

com.unblu.conversation.call.button.action.backgroundNormal

  • Type: Complex color

  • Default: rgba(255,255,255,0.05)

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "call action" button in "normal" state

"Pressed" background color

com.unblu.conversation.call.button.action.backgroundPress

  • Type: Complex color

  • Default: adjust-color($\{com.unblu.conversation.call.button.action.backgroundHover\}, $alpha: 0.05)

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "call action" button in "pressed" state

"Hovered" border color

com.unblu.conversation.call.button.action.borderHover

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of the "call action" button in "hovered" state

Normal border color

com.unblu.conversation.call.button.action.borderNormal

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of the "call action" button in "normal" state

"Pressed" border color

com.unblu.conversation.call.button.action.borderPress

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of the "call action" button in "pressed" state

Border width

com.unblu.conversation.call.button.action.borderWidth

  • Type: Integer

  • Default: 1

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Border width of the "call action" button

"Hovered" foreground color

com.unblu.conversation.call.button.action.foregroundHover

  • Type: Complex color

  • Default: $\{com.unblu.conversation.call.button.action.foregroundNormal\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "call action" button in "hovered" state

Normal foreground color

com.unblu.conversation.call.button.action.foregroundNormal

  • Type: Complex color

  • Default: rgba(255,255,255,0.6)

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "call action" button in "normal" state

Conversation call button foreground normal UI setting

com.unblu.conversation.call.button.action.foregroundPress

  • Type: Complex color

  • Default: $\{com.unblu.conversation.call.button.action.foregroundNormal\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "call action" button in "pressed" state

Call toggle button style

"Hovered" background color

com.unblu.conversation.call.button.toggle.backgroundHover

  • Type: Complex color

  • Default: rgba(255,255,255,0.05)

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "call toggle" button in "hovered" state

"Hovered" background color (active)

com.unblu.conversation.call.button.toggle.backgroundHoverActive

  • Type: Complex color

  • Default: adjust-color($\{com.unblu.conversation.call.button.toggle.backgroundNormalActive\}, $lightness:-10%)

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "call toggle" button in "hovered (active)" state

Normal background color

com.unblu.conversation.call.button.toggle.backgroundNormal

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "call toggle" button in "normal" state

Normal background color (active)

com.unblu.conversation.call.button.toggle.backgroundNormalActive

  • Type: Complex color

  • Default: rgba(255,255,255,0.2)

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "call toggle" button in "normal (active)" state

"Pressed" background color

com.unblu.conversation.call.button.toggle.backgroundPress

  • Type: Complex color

  • Default: rgba(255,255,255,0.1)

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "call toggle" button in "normal" state

Press background color (active)

com.unblu.conversation.call.button.toggle.backgroundPressActive

  • Type: Complex color

  • Default: adjust-color($\{com.unblu.conversation.call.button.toggle.backgroundHoverActive\}, $lightness:-10%)

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "call toggle" button in "pressed (active)" state

"Hovered" border color

com.unblu.conversation.call.button.toggle.borderHover

  • Type: Complex color

  • Default: $\{com.unblu.conversation.call.button.toggle.borderNormal\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of the "call toggle" button in "hovered" state

"Hovered" border color (active)

com.unblu.conversation.call.button.toggle.borderHoverActive

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of the "call toggle" button in "hovered (active)" state

Normal border color

com.unblu.conversation.call.button.toggle.borderNormal

  • Type: Complex color

  • Default: rgba(255,255,255,0.5)

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of the "call toggle" button in "normal" state

Normal border color (active)

com.unblu.conversation.call.button.toggle.borderNormalActive

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of the "call toggle" button in "normal (active)" state

"Pressed" border color

com.unblu.conversation.call.button.toggle.borderPress

  • Type: Complex color

  • Default: $\{com.unblu.conversation.call.button.toggle.borderNormal\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of the "call toggle" button in "pressed" state

Press border color (active)

com.unblu.conversation.call.button.toggle.borderPressActive

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of the "call toggle" button in "pressed (active)" state

Border width

com.unblu.conversation.call.button.toggle.borderWidth

  • Type: Integer

  • Default: 1

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Border width of the "call toggle" button

"Hovered" foreground color

com.unblu.conversation.call.button.toggle.foregroundHover

  • Type: Complex color

  • Default: $\{com.unblu.conversation.call.button.toggle.foregroundNormal\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "call toggle" button in "hovered" state

"Hovered" foreground color (active)

com.unblu.conversation.call.button.toggle.foregroundHoverActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorTextInverted\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "call toggle" button in "hovered (active)" state

Normal foreground color

com.unblu.conversation.call.button.toggle.foregroundNormal

  • Type: Complex color

  • Default: rgba(255,255,255,0.5)

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "call toggle" button in "normal" state

Normal foreground color (active)

com.unblu.conversation.call.button.toggle.foregroundNormalActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorTextInverted\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "call toggle" button in "normal (active)" state

Press foreground color

com.unblu.conversation.call.button.toggle.foregroundPress

  • Type: Complex color

  • Default: $\{com.unblu.conversation.call.button.toggle.foregroundNormal\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "call toggle" button in "pressed" state

"Pressed" foreground color (active)

com.unblu.conversation.call.button.toggle.foregroundPressActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorTextInverted\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "call toggle" button in "pressed (active)" state

Collaboration space UI configuration

UI setting for the collaboration space button "active indicator"

com.unblu.conversation.collabspace.colorLayerActiveIndicator

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.highlightAnnouncement\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Collaboration layer button active indicator color

Background color splash screen

com.unblu.conversation.collabspace.colorLayerLoadingSplashBackground

  • Type: Complex color

  • Default: adjust-color($\{com.unblu.theme.color.gray050\}, $alpha: -0.1)

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Background color used for the splash screen displayed when a collaboration layer is stared.

Splash screen text color

com.unblu.conversation.collabspace.colorLayerLoadingSplashForeground

  • Type: String with allowed values:

    • announcement

    • body

    • dark

    • error

    • inverted

    • inverted_mid

    • link

    • link_dark

    • mid

    • success

    • warn

  • Default: BODY

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Text color used for the splash screen displayed when a collaboration layer is started

Icon background color on splash screen

com.unblu.conversation.collabspace.colorLayerLoadingSplashIconBackground

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.highlightAnnouncement\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Icon background color used for the splash screen displayed when launching a collaboration layer

Splash screen icon color

com.unblu.conversation.collabspace.colorLayerLoadingSplashIconForeground

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorTextInverted\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Icon color used for the splash screen displayed when a collaboration layer is launched

Splash screen loader color

com.unblu.conversation.collabspace.colorLayerLoadingSplashLoader

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.neutral900\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Loader color used for the splash screen displayed when a collaboration layer is started

Color of capturing frame

com.unblu.conversation.collabspace.colorVisitorCapturingFrame

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.highlightSuccess\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Color used for the frame indicating capturing, collaboration, and sharing. The default color used is "highlight success".

Minimum time to display splash screen

com.unblu.conversation.collabspace.minLayerLoadingSplashDisplayTime

  • Type: Integer

  • Default: 2000

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Minimum time the layer loading splash screen should be displayed

Thickness of capturing frame

com.unblu.conversation.collabspace.visitorCapturingFrameWidth

  • Type: Integer

  • Default: 3

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Thickness of the frame indicating capturing, collaboration, and sharing

Collaboration layer action button style

"Hovered" background color

com.unblu.conversation.collabspace.layer.action.backgroundHover

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.flat.secondary.backgroundHover\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "collaboration layer action" button in "hovered" state

"Hovered" background color (active)

com.unblu.conversation.collabspace.layer.action.backgroundHoverActive

  • Type: Complex color

  • Default: change-color($\{com.unblu.theme.color.neutral700\},$alpha: 0.32)

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "collaboration layer action" button in "hovered (active)" state

Normal background color

com.unblu.conversation.collabspace.layer.action.backgroundNormal

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.flat.secondary.backgroundNormal\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "collaboration layer action" button in "normal" state

Normal background color (active)

com.unblu.conversation.collabspace.layer.action.backgroundNormalActive

  • Type: Complex color

  • Default: change-color($\{com.unblu.theme.color.neutral700\},$alpha: 0.24)

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "collaboration layer action" button in "normal (active)" state

"Pressed" background color

com.unblu.conversation.collabspace.layer.action.backgroundPress

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.flat.secondary.backgroundPress\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "collaboration layer action" button in "pressed" state

"Pressed" background color (active)

com.unblu.conversation.collabspace.layer.action.backgroundPressActive

  • Type: Complex color

  • Default: change-color($\{com.unblu.theme.color.neutral700\},$alpha: 0.40)

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "collaboration layer action" button in "pressed (active)" state

"Hovered" border color

com.unblu.conversation.collabspace.layer.action.borderHover

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.flat.secondary.borderHover\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of the "collaboration layer action" button in "hovered" state

"Hovered" border color (active)

com.unblu.conversation.collabspace.layer.action.borderHoverActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.flat.secondary.borderHover\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of the "collaboration layer action" button in "hovered (active)" state

Normal border color

com.unblu.conversation.collabspace.layer.action.borderNormal

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.flat.secondary.borderNormal\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of the "collaboration layer action" button in "normal" state

Normal border color (active)

com.unblu.conversation.collabspace.layer.action.borderNormalActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.flat.secondary.borderNormal\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of the "collaboration layer action" button in "normal (active)" state

"Pressed" border color

com.unblu.conversation.collabspace.layer.action.borderPress

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.flat.secondary.borderPress\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of the "collaboration layer action" button in "pressed" state

"Pressed" border color (active)

com.unblu.conversation.collabspace.layer.action.borderPressActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.flat.secondary.borderPress\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of the "collaboration layer action" button in "pressed (active)" state

Border width

com.unblu.conversation.collabspace.layer.action.borderWidth

  • Type: Integer

  • Default: 0

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Border width of the "collaboration layer action" button

"Hovered" foreground color

com.unblu.conversation.collabspace.layer.action.foregroundHover

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.flat.secondary.foregroundHover\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "collaboration layer action" button in "hovered" state

Hover foreground color (active)

com.unblu.conversation.collabspace.layer.action.foregroundHoverActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.flat.secondary.foregroundHover\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "collaboration layer action" button in "hovered (active)" state

Normal foreground color

com.unblu.conversation.collabspace.layer.action.foregroundNormal

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.flat.secondary.foregroundNormal\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "collaboration layer action" button in "normal" state

Normal foreground color (active)

com.unblu.conversation.collabspace.layer.action.foregroundNormalActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.flat.secondary.foregroundNormal\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "collaboration layer action" button in "normal (active)" state

"Pressed" foreground color

com.unblu.conversation.collabspace.layer.action.foregroundPress

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.flat.secondary.foregroundPress\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "collaboration layer action" button in "pressed" state

"Pressed" foreground color (active)

com.unblu.conversation.collabspace.layer.action.foregroundPressActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.flat.secondary.foregroundPress\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "collaboration layer action" button in "pressed (active)" state

Collaboration layer button style

"Hovered" background color

com.unblu.conversation.collabspace.layer.button.backgroundHover

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.secondary.backgroundHover\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "collaboration layer" button in "hovered" state

"Hovered" background color (active)

com.unblu.conversation.collabspace.layer.button.backgroundHoverActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.secondary050\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "collaboration layer" button in "hovered (active)" state

Normal background color

com.unblu.conversation.collabspace.layer.button.backgroundNormal

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.secondary.backgroundNormal\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "collaboration layer" button in "normal" state

Normal background color (active)

com.unblu.conversation.collabspace.layer.button.backgroundNormalActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.secondary050\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "collaboration layer" button in "normal (active)" state

"Pressed" background color

com.unblu.conversation.collabspace.layer.button.backgroundPress

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.secondary.backgroundPress\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "collaboration layer" button in "pressed" state

"Press" background color (active)

com.unblu.conversation.collabspace.layer.button.backgroundPressActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.secondary050\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "collaboration layer" button in "pressed (active)" state

"Hovered" border color

com.unblu.conversation.collabspace.layer.button.borderHover

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of the "collaboration layer" button in "hovered" state

Hover border color (active)

com.unblu.conversation.collabspace.layer.button.borderHoverActive

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of the "collaboration layer" button in "hovered (active)" state

Normal border color

com.unblu.conversation.collabspace.layer.button.borderNormal

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.gray200\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of the "collaboration layer" button in "normal" state

Normal border color (active)

com.unblu.conversation.collabspace.layer.button.borderNormalActive

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of the "collaboration layer" button in "normal (active)" state

"Pressed" border color

com.unblu.conversation.collabspace.layer.button.borderPress

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of the "collaboration layer" button in "pressed" state

"Pressed" border color (active)

com.unblu.conversation.collabspace.layer.button.borderPressActive

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of the "collaboration layer" button in "pressed (active)" state

Border width

com.unblu.conversation.collabspace.layer.button.borderWidth

  • Type: Integer

  • Default: 0

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Border width of the "collaboration layer" button

"Hovered" foreground color

com.unblu.conversation.collabspace.layer.button.foregroundHover

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.secondary.foregroundHover\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "collaboration layer" button in "hovered" state

"Hovered" foreground color (active)

com.unblu.conversation.collabspace.layer.button.foregroundHoverActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorLink\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "collaboration layer" button in "hovered (active)" state

Normal foreground color

com.unblu.conversation.collabspace.layer.button.foregroundNormal

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.secondary.foregroundNormal\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "collaboration layer" button in "normal" state

Normal foreground color (active)

com.unblu.conversation.collabspace.layer.button.foregroundNormalActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorLinkDark\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "collaboration layer" button in "normal (active)" state

"Pressed" foreground color

com.unblu.conversation.collabspace.layer.button.foregroundPress

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.secondary.foregroundPress\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "collaboration layer" button in "pressed" state

Press foreground color (active)

com.unblu.conversation.collabspace.layer.button.foregroundPressActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorLink\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "collaboration layer" button in "pressed (active)" state

File UI configuration

autoLoadImagePreviewMaxBytes

com.unblu.conversation.file.autoLoadImagePreviewMaxBytes

  • Type: Integer

  • Default: 2000000

  • Allowed scopes: GLOBAL, ACCOUNT

Max size in bytes up to which image previews are loaded. All images greater than the specified size are not displayed as preview.

Background color of the conversation files list UI

com.unblu.conversation.file.fileListBackgroundColor

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.backgroundLight\}

  • Allowed scopes: GLOBAL, ACCOUNT

Background color of the conversation files list

Messaging shortcut configuration

Keyboard shortcut to toggle message mode

com.unblu.conversation.messaging.shortcuts.toggleMessagingModeShortcut

  • Type: Keyboard shortcut

  • Default: $mod+m

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Keyboard shortcut for switching between public and internal messaging mode. Make sure the shortcut is not already used by the browser.

Messaging UI configuration

Message border radius

com.unblu.conversation.messaging.ui.borderRadiusMsg

  • Type: Integer

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The radius is applied to the corners of the message not pointing towards the avatar. The default value is that of the border radius component in the general UI configuration.

Message tip border radius

com.unblu.conversation.messaging.ui.borderRadiusMsgTip

  • Type: Integer

  • Default: 0

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Used for the message’s corner closest to the avatar

Width of bot thread vertical grouping line

com.unblu.conversation.messaging.ui.botThreadLineWidth

  • Type: Integer

  • Default: 2

  • Allowed scopes: GLOBAL, ACCOUNT

The line groups all the messages within a bot thread block. The value is specified in pixels.

Internal message input cursor color

com.unblu.conversation.messaging.ui.caretColorInternalMessageInput

  • Type: Complex color

  • Default: $\{com.unblu.conversation.messaging.ui.textColorInternalMessageInput\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The text input cursor is also referred to as the insertion caret

Public message input cursor color

com.unblu.conversation.messaging.ui.caretColorMessageInput

  • Type: Complex color

  • Default: $\{com.unblu.conversation.messaging.ui.textColorMessageInput\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The text input cursor is also referred to as the insertion caret

Threshold for "remaining characters" hint

com.unblu.conversation.messaging.ui.charactersRemainingHintThreshold

  • Type: Integer

  • Default: 200

  • Allowed scopes: GLOBAL, ACCOUNT

When the number of remaining characters drops below the value defined here, Unblu displays the "remaining characters" hint

Enable Markdown for chat message input

com.unblu.conversation.messaging.ui.chatMessageAsMarkdownEnabled

  • Type: Boolean

  • Default: false

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

If enabled, the content of chat messages entered in the UI’s text input field is interpreted as Markdown. For other message types, Markdown formatting is applied according to their respective configuration, independently of this setting.

com.unblu.conversation.messaging.ui.chatMessageShowUrlAsLink

  • Type: Boolean

  • Default: true

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Note that explicit links in Markdown messages are always displayed as links

Background color of messaging UI

com.unblu.conversation.messaging.ui.colorChatBackground

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.backgroundMid\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Background color of the messaging UI

Background color of text input field for internal messages

com.unblu.conversation.messaging.ui.colorInternalMessageInputBackground

  • Type: Complex color

  • Default: #fffae8

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color of "delivered"/"read" ticks for internal messages

com.unblu.conversation.messaging.ui.colorInternalMsgStateTick

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.primary500\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default color is the primary color

Color of "delivered"/"unread" ticks for internal messages

com.unblu.conversation.messaging.ui.colorInternalMsgStateTickUnread

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.gray400\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default color is gray color variant 400

Color of "typing indicator dot" animation for internal messages

com.unblu.conversation.messaging.ui.colorInternalTypingIndicatorForeground

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.primary500\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default color is the primary color

Background color text input field for public messages

com.unblu.conversation.messaging.ui.colorMessageInputBackground

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.backgroundLight\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color of "delivered"/"read" ticks

com.unblu.conversation.messaging.ui.colorMsgStateTick

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.primary500\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default color is the primary color

Background color of my internal messages

com.unblu.conversation.messaging.ui.colorMyInternalMsgBackground

  • Type: Complex color

  • Default: $\{com.unblu.conversation.messaging.ui.colorInternalMessageInputBackground\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default value is the same as the background color of the text input field for internal messages

Background color of my internal messages when sending message failed

com.unblu.conversation.messaging.ui.colorMyInternalMsgBackgroundFailed

  • Type: Complex color

  • Default: adjust-color($\{com.unblu.conversation.messaging.ui.colorMyInternalMsgBackground\}, $alpha: -0.4)

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default color is the same as for sent messages but with reduced opacity

Background color of my internal messages (hovered)

com.unblu.conversation.messaging.ui.colorMyInternalMsgBackgroundHovered

  • Type: Complex color

  • Default: scale-color($\{com.unblu.conversation.messaging.ui.colorMyInternalMsgBackground\}, $lightness: -5%)

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default color is a slightly darker variant of the color used for sent messages

Background color of my internal messages (pressed)

com.unblu.conversation.messaging.ui.colorMyInternalMsgBackgroundPressed

  • Type: Complex color

  • Default: scale-color($\{com.unblu.conversation.messaging.ui.colorMyInternalMsgBackgroundHovered\}, $lightness: -5%)

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default color is a slightly darker variant of the one calculated for hovered internal messages

Border color of my internal messages

com.unblu.conversation.messaging.ui.colorMyInternalMsgBorder

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default color is a light version of the primary color

Background color of my sent messages

com.unblu.conversation.messaging.ui.colorMyMsgBackground

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.primary050\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default color is a light version of the primary color

Border color of my sent messages

com.unblu.conversation.messaging.ui.colorMyMsgBorder

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default color is a light version of the primary color

Background color of internal messages from others

com.unblu.conversation.messaging.ui.colorOtherInternalMsgBackground

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.backgroundLight\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default color is a light version of the message background color

Background color of internal messages from others (hovered)

com.unblu.conversation.messaging.ui.colorOtherInternalMsgBackgroundHovered

  • Type: Complex color

  • Default: scale-color($\{com.unblu.conversation.messaging.ui.colorOtherInternalMsgBackground\}, $lightness: -5%)

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default color is a slightly darker variant of the color used for internal messages from others

Background color of internal messages from others (pressed)

com.unblu.conversation.messaging.ui.colorOtherInternalMsgBackgroundPressed

  • Type: Complex color

  • Default: scale-color($\{com.unblu.conversation.messaging.ui.colorOtherInternalMsgBackgroundHovered\}, $lightness: -5%)

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default color is a slightly darker variant of the one calculated for hovered internal messages from others

Border color of internal messages from others

com.unblu.conversation.messaging.ui.colorOtherInternalMsgBorder

  • Type: Complex color

  • Default: scale-color($\{com.unblu.conversation.messaging.ui.colorInternalMessageInputBackground\}, $lightness: -45%)

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Background color of public messages from others

com.unblu.conversation.messaging.ui.colorOtherMsgBackground

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.backgroundLight\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default color is "gray lightest"

Border color of messages from others

com.unblu.conversation.messaging.ui.colorOtherMsgBorder

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.gray100\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default color is "gray light"

Background color of internal system messages

com.unblu.conversation.messaging.ui.colorSystemInternalMsgBackground

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Background color of internal system messages (hovered)

com.unblu.conversation.messaging.ui.colorSystemInternalMsgBackgroundHovered

  • Type: Complex color

  • Default: scale-color($\{com.unblu.conversation.messaging.ui.colorSystemMsgBackground\}, $lightness: -5%)

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default color is a slightly darker variant of the color used for internal system messages

Background color of internal system messages

com.unblu.conversation.messaging.ui.colorSystemInternalMsgBackgroundPressed

  • Type: Complex color

  • Default: scale-color($\{com.unblu.conversation.messaging.ui.colorSystemMsgBackgroundHovered\}, $lightness: -5%)

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default color is a slightly darker variant of the one calculated for hovered internal system messages

Border color of internal system messages

com.unblu.conversation.messaging.ui.colorSystemInternalMsgBorder

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Background color of public system messages

com.unblu.conversation.messaging.ui.colorSystemMsgBackground

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Border color of public system messages

com.unblu.conversation.messaging.ui.colorSystemMsgBorder

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color of "typing indicator dot" animation

com.unblu.conversation.messaging.ui.colorTypingIndicatorForeground

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.primary500\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default color is the primary color

Avatar position on message group

com.unblu.conversation.messaging.ui.groupAvatarPosition

  • Type: String with allowed values:

    • all

    • first

    • last

  • Default: LAST

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The message that the avatar should be displayed on in a group of messages from the same participant

Threshold for grouping messages

com.unblu.conversation.messaging.ui.groupMessagesThreshold

  • Type: Integer

  • Default: 120000

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The threshold is specified in milliseconds. All successive messages from the same sender within the given threshold are grouped together.

Border color of empty internal message input field

com.unblu.conversation.messaging.ui.internalMessageInputBorderColor

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The value is only applied when the text input field isn’t in focus

Border color of internal message input field when errors occur

com.unblu.conversation.messaging.ui.internalMessageInputBorderColorError

  • Type: Complex color

  • Default: $\{com.unblu.theme.input.borderColorError\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Border color of internal message input field when in focus

com.unblu.conversation.messaging.ui.internalMessageInputBorderColorFocus

  • Type: Complex color

  • Default: $\{com.unblu.theme.input.borderColorFocus\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The border color of the text input field in internal messaging mode when it is in focus

Border color of internal message input field with content

com.unblu.conversation.messaging.ui.internalMessageInputBorderColorNonEmpty

  • Type: Complex color

  • Default: $\{com.unblu.theme.input.borderColor\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The value is only applied when the text input field has content but isn’t in focus

Image alignment in list messages

com.unblu.conversation.messaging.ui.listMessageImageAlignment

  • Type: String with allowed values:

    • left

    • right

  • Default: RIGHT

  • Allowed scopes: GLOBAL, ACCOUNT

Possible values are LEFT and RIGHT. The default value is RIGHT.

Border color of empty public message input field

com.unblu.conversation.messaging.ui.messageInputBorderColor

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The value is only applied when the text input field isn’t in focus

Border color of public message input field when errors occur

com.unblu.conversation.messaging.ui.messageInputBorderColorError

  • Type: Complex color

  • Default: $\{com.unblu.theme.input.borderColorError\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The border color of the text input field in public messaging mode when there is an error

Border color of public message input field when in focus

com.unblu.conversation.messaging.ui.messageInputBorderColorFocus

  • Type: Complex color

  • Default: $\{com.unblu.theme.input.borderColorFocus\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The value is applied when the text input field is in focus, irrespective of whether it has content or not

Border color of public message input field with content

com.unblu.conversation.messaging.ui.messageInputBorderColorNonEmpty

  • Type: Complex color

  • Default: $\{com.unblu.theme.input.borderColor\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The value is applied when the text input field has content but isn’t in focus

Messaging component display mode

com.unblu.conversation.messaging.ui.messageInputDisplayMode

  • Type: String with allowed values:

    • auto

    • horizontal

    • stacked

  • Default: AUTO

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Defines how the "send", "canned response", and "upload" buttons are positioned relative to the text input field. If set to HORIZONTAL, the buttons are positioned to the right of the text input field. If set to STACKED, the buttons are positioned below the text input field. If set to AUTO, the buttons are positioned below or to the right of the text input field, depending on the height of the chat panel. The height of the chat panel that triggers moving the buttons is configurable.

Minimum height before switching display mode

com.unblu.conversation.messaging.ui.messageInputDisplayModeAutoThreshold

  • Type: Integer

  • Default: 800

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

If the messaging component display mode is set to AUTO, the buttons appear in STACKED mode (that is, below the text input field) if the height of the chat panel is greater than the value specified here. If the height of the chat panel is smaller, the buttons are displayed in HORIZONTAL mode.

Maximum height of message input field in HORIZONTAL display mode

com.unblu.conversation.messaging.ui.messageInputMaxHeightHorizontal

  • Type: Integer

  • Default: 120

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The height of the input field increases to accommodate the text entered until the height specified here. The height is specified in pixels. For information about the different display modes, refer to the description of "messaging component display mode".

Maximum height of message input field in STACKED display mode

com.unblu.conversation.messaging.ui.messageInputMaxHeightStacked

  • Type: Integer

  • Default: 120

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The height of the input field increases to accommodate the text entered until the height specified here. The height is specified in pixels. For information about the different display modes, refer to the description of "messaging component display mode".

Minimum height of desktop message input field in HORIZONTAL display mode

com.unblu.conversation.messaging.ui.messageInputMinHeightDesktopHorizontal

  • Type: Integer

  • Default: 32

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The height is specified in pixels. For information about the different display modes, refer to the description of "messaging component display mode".

Minimum height of desktop message input field in STACKED display mode

com.unblu.conversation.messaging.ui.messageInputMinHeightDesktopStacked

  • Type: Integer

  • Default: 60

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The height is specified in pixels. For information about the different display modes, refer to the description of "messaging component display mode".

Minimum height of mobile message input field in HORIZONTAL display mode

com.unblu.conversation.messaging.ui.messageInputMinHeightMobileHorizontal

  • Type: Integer

  • Default: 40

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The height is specified in pixels. For information about the different display modes, refer to the description of "messaging component display mode".

Minimum height of mobile message input field in STACKED display mode

com.unblu.conversation.messaging.ui.messageInputMinHeightMobileStacked

  • Type: Integer

  • Default: 48

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The height is specified in pixels. For information about the different display modes, refer to the description of "messaging component display mode".

"Send message" trigger

com.unblu.conversation.messaging.ui.messageInputSendBehavior

  • Type: String with allowed values:

    • on_enter

    • on_shift_enter

  • Default: ON_ENTER

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Define which keyboard input to send a message on. Possible values are ENTER and SHIFT + ENTER. The key combination not selected will create a new line in the message.

Minimum width for each multiple choice option button

com.unblu.conversation.messaging.ui.multiChoiceButtonMinWidth

  • Type: Integer

  • Default: 48

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Number of multiple choice option buttons to display

com.unblu.conversation.messaging.ui.multiChoiceMaxVisibleButtons

  • Type: Integer

  • Default: 6

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

If the number of multiple-choice option buttons is greater than the number specified here, the remaining options are grouped under the "More" button

Number of initially displayed messages

com.unblu.conversation.messaging.ui.numberInitiallyDisplayedMessages

  • Type: Integer

  • Default: 100

  • Allowed scopes: GLOBAL, ACCOUNT

Applied to the message view when a conversation is opened. Additional messages are displayed when the user scrolls to the top of the message list. The minimum value is 50.

Number of additional messages displayed when scrolling to top

com.unblu.conversation.messaging.ui.numberOfAdditionalMessagesDisplayedWhenScrolledToTop

  • Type: Integer

  • Default: 50

  • Allowed scopes: GLOBAL, ACCOUNT

The minimum value is 10

Paragraph bottom margin in px

com.unblu.conversation.messaging.ui.paragraphMarginBottom

  • Type: Integer

  • Default: 4

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The value is applied to the bottom of paragraphs in a message

Text color used in input field for internal messages

com.unblu.conversation.messaging.ui.textColorInternalMessageInput

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorLinkDark\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Header text color of internal messages

com.unblu.conversation.messaging.ui.textColorInternalMsgHeader

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorTextBody\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default color is "text color medium"

Text color of text input field for public messages

com.unblu.conversation.messaging.ui.textColorMessageInput

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorLinkDark\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Message header text color

com.unblu.conversation.messaging.ui.textColorMsgHeader

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorTextBody\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default color is "text color medium"

Text color of body of my internal messages

com.unblu.conversation.messaging.ui.textColorMyInternalMsgBody

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorTextBody\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default color is "text color dark"

com.unblu.conversation.messaging.ui.textColorMyInternalMsgLink

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorLink\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Text color of links in my internal messages

Text color of body of my messages

com.unblu.conversation.messaging.ui.textColorMyMsgBody

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorTextBody\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default color is "text color dark"

Text color of body of internal messages from others

com.unblu.conversation.messaging.ui.textColorOtherInternalMsgBody

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorTextBody\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default color is "text color dark"

com.unblu.conversation.messaging.ui.textColorOtherInternalMsgLink

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorLink\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Text color of body of messages from others

com.unblu.conversation.messaging.ui.textColorOtherMsgBody

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorTextBody\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default color is "text color dark"

Text color of internal system message body

com.unblu.conversation.messaging.ui.textColorSystemInternalMsgBody

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorTextBody\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default color is "text color dark"

com.unblu.conversation.messaging.ui.textColorSystemInternalMsgLink

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorLink\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Text color of links in internal system messages

System message body text color

com.unblu.conversation.messaging.ui.textColorSystemMsgBody

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorTextBody\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default color is "text color dark"

Header text size of internal messages

com.unblu.conversation.messaging.ui.textSizeInternalMsgHeader

  • Type: Integer

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default size is "small"

Input text size for public messages

com.unblu.conversation.messaging.ui.textSizeMessageInput

  • Type: Integer

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default size is the same as "paragraph". On iPhones, a minimum size of 16px is enforced to avoid issues caused by Safari’s auto-zoom behavior.

H1 heading size in px

com.unblu.conversation.messaging.ui.textSizeMsgBodyH1

  • Type: Integer

  • Default: 18

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The value is applied to Markdown H1 headings in the message body

H2 heading size in px

com.unblu.conversation.messaging.ui.textSizeMsgBodyH2

  • Type: Integer

  • Default: 16

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Applied to Markdown H2 headings in the message body

H3 heading size in px

com.unblu.conversation.messaging.ui.textSizeMsgBodyH3

  • Type: Integer

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The value is applied to Markdown H3 headings in the message body

Message header text size

com.unblu.conversation.messaging.ui.textSizeMsgHeader

  • Type: Integer

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default size is "small"

Text size for body of my internal messages

com.unblu.conversation.messaging.ui.textSizeMyInternalMsgBody

  • Type: Integer

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default size is "paragraph"

Text size for my messages

com.unblu.conversation.messaging.ui.textSizeMyMsgBody

  • Type: Integer

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default size is "paragraph"

Text size for body of internal messages from others

com.unblu.conversation.messaging.ui.textSizeOtherInternalMsgBody

  • Type: Integer

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default size is "text size paragraph"

Text size for messages from others

com.unblu.conversation.messaging.ui.textSizeOtherMsgBody

  • Type: Integer

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default size is "paragraph"

Text size of internal system message body

com.unblu.conversation.messaging.ui.textSizeSystemInternalMsgBody

  • Type: Integer

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default size is "text size small"

Text size of system message body

com.unblu.conversation.messaging.ui.textSizeSystemMsgBody

  • Type: Integer

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The default size is "text size small"

"Send internal message" button configuration

Hover background color

com.unblu.conversation.messaging.ui.send_internal_message_button.backgroundHover

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.primary.backgroundHover\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "send internal message" button in "hovered" state

"Normal" background color

com.unblu.conversation.messaging.ui.send_internal_message_button.backgroundNormal

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.primary.backgroundNormal\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "send internal message" button in "normal" state

"Pressed" background color

com.unblu.conversation.messaging.ui.send_internal_message_button.backgroundPress

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.primary.backgroundPress\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "send internal message" button in "pressed" state

"Hovered" border color

com.unblu.conversation.messaging.ui.send_internal_message_button.borderHover

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.primary.borderHover\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of the "send internal message" button in "hovered" state

"Normal" border color

com.unblu.conversation.messaging.ui.send_internal_message_button.borderNormal

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.primary.borderNormal\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of the "send internal message" button in "normal" state

"Pressed" border color

com.unblu.conversation.messaging.ui.send_internal_message_button.borderPress

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.primary.borderPress\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of the "send internal message" button in "pressed" state

Border width

com.unblu.conversation.messaging.ui.send_internal_message_button.borderWidth

  • Type: Integer

  • Default: 1

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Border width of the "send internal message" button

Hover foreground color

com.unblu.conversation.messaging.ui.send_internal_message_button.foregroundHover

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.primary.foregroundHover\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "send internal message" button in "hovered" state

"Normal" foreground color

com.unblu.conversation.messaging.ui.send_internal_message_button.foregroundNormal

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.primary.foregroundNormal\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "send internal message" button in "normal" state

"Pressed" foreground color

com.unblu.conversation.messaging.ui.send_internal_message_button.foregroundPress

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.primary.foregroundPress\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "send internal message" button in "pressed" state

"Send public message" button configuration

"Hovered" background color

com.unblu.conversation.messaging.ui.send_public_message_button.backgroundHover

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.primary.backgroundHover\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "send public message" button in "hovered" state

Normal background color

com.unblu.conversation.messaging.ui.send_public_message_button.backgroundNormal

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.primary.backgroundNormal\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "send public message" button in "normal" state

"Pressed" background color

com.unblu.conversation.messaging.ui.send_public_message_button.backgroundPress

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.primary.backgroundPress\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "send public message" button in "pressed" state

"Hovered" border color

com.unblu.conversation.messaging.ui.send_public_message_button.borderHover

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.primary.borderHover\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "send public message" button in "hovered" state

"Normal" border color

com.unblu.conversation.messaging.ui.send_public_message_button.borderNormal

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.primary.borderNormal\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of the "send public message" button in "normal" state

"Pressed" border color

com.unblu.conversation.messaging.ui.send_public_message_button.borderPress

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.primary.borderPress\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "send public message" button in "pressed" state

Border width

com.unblu.conversation.messaging.ui.send_public_message_button.borderWidth

  • Type: Integer

  • Default: 1

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Border width of the "send public message" button

"Hovered" foreground color

com.unblu.conversation.messaging.ui.send_public_message_button.foregroundHover

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.primary.foregroundHover\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "send public message" button in "hovered" state

"Normal" foreground color

com.unblu.conversation.messaging.ui.send_public_message_button.foregroundNormal

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.primary.foregroundNormal\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "send public message" button in "normal" state

"Press" foreground color

com.unblu.conversation.messaging.ui.send_public_message_button.foregroundPress

  • Type: Complex color

  • Default: $\{com.unblu.theme.button.primary.foregroundPress\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "send public message" button in "pressed" state

QuickReplyUiConfig

backgroundHover

com.unblu.conversation.messaging.ui.quickreply.backgroundHover

  • Type: Complex color

  • Default: $\{com.unblu.conversation.messaging.ui.colorMyMsgBackground\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

backgroundNormal

com.unblu.conversation.messaging.ui.quickreply.backgroundNormal

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.backgroundLight\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

backgroundPress

com.unblu.conversation.messaging.ui.quickreply.backgroundPress

  • Type: Complex color

  • Default: adjust-color($\{com.unblu.conversation.messaging.ui.quickreply.backgroundHover\},$lightness: -8%)

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

borderHover

com.unblu.conversation.messaging.ui.quickreply.borderHover

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

borderNormal

com.unblu.conversation.messaging.ui.quickreply.borderNormal

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.primary200\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

borderPress

com.unblu.conversation.messaging.ui.quickreply.borderPress

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

borderWidth

com.unblu.conversation.messaging.ui.quickreply.borderWidth

  • Type: Integer

  • Default: 1

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

foregroundHover

com.unblu.conversation.messaging.ui.quickreply.foregroundHover

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorLinkDark\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

foregroundNormal

com.unblu.conversation.messaging.ui.quickreply.foregroundNormal

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorLinkDark\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

foregroundPress

com.unblu.conversation.messaging.ui.quickreply.foregroundPress

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorLinkDark\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

overflowButtonStyle

com.unblu.conversation.messaging.ui.quickreply.overflowButtonStyle

  • Type: String with allowed values:

    • button_group

    • flat_inverse

    • flat_primary

    • flat_secondary

    • primary

    • secondary

  • Default: FLAT_SECONDARY

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Style used for the quick reply overflow button

Visitor UI sidebar toggle configuration

Agent desk conversation individual UI toggle button style: Background hover

com.unblu.conversation.individualui.sidebar.togglebutton.backgroundHover

  • Type: Complex color

  • Default: $\{com.unblu.conversation.individualui.sidebar.togglebutton.backgroundNormal\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Agent desk conversation individual UI toggle button style: Background normal

com.unblu.conversation.individualui.sidebar.togglebutton.backgroundNormal

  • Type: Complex color

  • Default: #ffffff

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Agent desk conversation individual UI toggle button style: Background press

com.unblu.conversation.individualui.sidebar.togglebutton.backgroundPress

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.gray050\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Agent desk conversation individual UI toggle button style: Border hover

com.unblu.conversation.individualui.sidebar.togglebutton.borderHover

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.gray200\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Agent desk conversation individual UI toggle button style: border normal

com.unblu.conversation.individualui.sidebar.togglebutton.borderNormal

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.gray200\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Agent desk conversation individual UI toggle button style: Border normal

Agent desk conversation individual UI toggle button style: Border press

com.unblu.conversation.individualui.sidebar.togglebutton.borderPress

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.gray200\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Agent desk conversation individual UI toggle button style: Border radius

com.unblu.conversation.individualui.sidebar.togglebutton.borderRadius

  • Type: Integer

  • Default: 32

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Agent desk conversation individual UI toggle button style: Border width

com.unblu.conversation.individualui.sidebar.togglebutton.borderWidth

  • Type: Integer

  • Default: 1

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Agent desk conversation individual UI toggle button style: Foreground hover

com.unblu.conversation.individualui.sidebar.togglebutton.foregroundHover

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorLink\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Agent desk conversation individual UI toggle button style: Foreground normal

com.unblu.conversation.individualui.sidebar.togglebutton.foregroundNormal

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorLinkDark\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Agent desk conversation individual UI toggle button style: Foreground press

com.unblu.conversation.individualui.sidebar.togglebutton.foregroundPress

  • Type: Complex color

  • Default: adjust-color($\{com.unblu.conversation.individualui.sidebar.togglebutton.foregroundHover\},$lightness: -10%)

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Notification badge color

com.unblu.conversation.individualui.sidebar.togglebutton.notificationBadgeColor

  • Type: Complex color

  • Default: $\{com.unblu.ui.notificationbadge.notificationBadgeBackgroundColor\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Background color of the unread message notification badge

Conversation template service

Allow starting chat invite conversations

com.unblu.core.client.core.service.conversationtemplate.ConversationTemplateService.allowStartChatInviteConversations

  • Type: Boolean

  • Default: false

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Allows agents to start conversations with the initial engagement type "chat invite" from the "Start conversation" menu.

Allow starting chat PIN conversations

com.unblu.core.client.core.service.conversationtemplate.ConversationTemplateService.allowStartChatPinConversations

  • Type: Boolean

  • Default: false

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Allows agents to start conversations with the initial engagement type "chat PIN" from the "Start conversation" menu.

Queue icon configuration

Queue item icon background color for incoming external messenger requests

com.unblu.queue.ui.agentForwardingIconBackground

  • Type: Simple color

  • Default: #ffc1cb

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Queue item icon background color for incoming external messenger requests.

Queue item icon background color for incoming external messenger requests

com.unblu.queue.ui.agentInvitationIconBackground

  • Type: Simple color

  • Default: #fff0c2

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

The background color of the queue item icon for incoming external messenger requests

Queue item icon background color for incoming audio call requests

com.unblu.queue.ui.audioCallIconBackground

  • Type: Simple color

  • Default: #c4f1b5

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Queue item icon background color for incoming audio call requests.

Queue item icon background color for incoming chat requests

com.unblu.queue.ui.chatIconBackground

  • Type: Simple color

  • Default: #e9bde0

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Queue item icon background color for incoming chat requests.

Queue item icon background color for incoming co-browsing requests

com.unblu.queue.ui.cobrowsingIconBackground

  • Type: Simple color

  • Default: #fecfb9

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Background color of the queue item icon for incoming co-browsing requests

Queue item icon background color for incoming external messenger requests

com.unblu.queue.ui.externalMessengerIconBackground

  • Type: Simple color

  • Default: #dcdce0

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Background color of the queue item icon for incoming external messenger requests

Queue item icon background color for incoming video call requests

com.unblu.queue.ui.videoCallIconBackground

  • Type: Simple color

  • Default: #b9ddf2

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Background color of the queue item for incoming video call requests

Agent admission UI configuration

Content background color

com.unblu.agent.ui.admission.contentBackground

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.backgroundLight\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Background color of the centered content on the "Request admission", "Waiting room" and "Conversation ended" pages for agents

Conversation date and time text color

com.unblu.agent.ui.admission.textColorConversationInfoDate

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorTextBody\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

The text color of the conversation’s date and time. The default color is "text color medium".

Conversation topic text color

com.unblu.agent.ui.admission.textColorConversationInfoTopic

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorTextBody\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

The text color of the conversation’s topic. The default color is "text color medium".

"Status information" label text color

com.unblu.agent.ui.admission.textColorStatusInfo

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorTextBody\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

The text color of the status information label. The default color is "text color medium".

Title text color

com.unblu.agent.ui.admission.textColorTitle

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorTextBody\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

The text color of the title that appears on the first line of the content. The default color is "text color medium".

Window background color

com.unblu.agent.ui.admission.windowBackground

  • Type: Complex color

  • Default: $\{com.unblu.core.client.ui.dialog.ModalDialogHost.backdropColor\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Background color of the "Request admission", "Waiting room", and "Conversation ended" pages for agents

Agent "conversation ended" component group

Show date

com.unblu.agent.conversationended.showDate

  • Type: Boolean

  • Default: true

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Specify whether to show agents the start date of the conversation on the "Conversation canceled/ended" page

Show participants

com.unblu.agent.conversationended.showParticipants

  • Type: Boolean

  • Default: true

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Specify whether to show the avatars and names of an ended conversation’s participants to non-participating agents

Show topic

com.unblu.agent.conversationended.showTopic

  • Type: Boolean

  • Default: true

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Specify whether to show the agent the topic of the conversation on the "Conversation canceled/ended" page

Agent "request admission" component configuration

"Cancel" and "Retry" button style

com.unblu.agent.admission.request.cancelAndRetryButtonStyle

  • Type: String with allowed values:

    • button_group

    • flat_inverse

    • flat_primary

    • flat_secondary

    • primary

    • secondary

  • Default: SECONDARY

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Style used for the "Cancel admission request" and "Retry admission request" buttons

"Request admission" button style

com.unblu.agent.admission.request.joinConversationButtonStyle

  • Type: String with allowed values:

    • button_group

    • flat_inverse

    • flat_primary

    • flat_secondary

    • primary

    • secondary

  • Default: PRIMARY

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Style used for the "Request admission" button

Show date

com.unblu.agent.admission.request.showDate

  • Type: Boolean

  • Default: true

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Specify whether to show the start date of the conversation to an agent before they have been granted permission to join

Show participants

com.unblu.agent.admission.request.showParticipants

  • Type: Boolean

  • Default: true

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Specify whether to show the avatars and names of the conversation’s participants to the agent before they have been granted permission to join

Show topic

com.unblu.agent.admission.request.showTopic

  • Type: Boolean

  • Default: true

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Specify whether to show the topic of the conversation to agents before they have been granted permission to join

Closed conversation configuration

com.unblu.desk.conversation.closed.logo

  • Type: String with allowed values:

    • account_avatar

    • brand_logo

    • brand_logo_inverse

    • named_area_avatar

    • none

  • Default: BRAND_LOGO_INVERSE

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Specifies which logo should be displayed at the top of "Conversation closed" page. Do not use the NAMED_AREA_AVATAR logo, as it would always fall back to ACCOUNT_AVATAR anyway.

Agent Desk UI configuration

audioCallIconBackground

com.unblu.desk.ui.audioCallIconBackground

  • Type: Complex color

  • Default: $\{com.unblu.queue.ui.audioCallIconBackground\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Background color of the conversation tab icon for audio call conversations

Show agent workspace

com.unblu.desk.ui.automaticallyStartPinConversation

  • Type: Boolean

  • Default: false

  • Allowed scopes: GLOBAL, ACCOUNT

Specify whether to automatically launch a new PIN-based conversation with embedded co-browsing when opening the Agent Desk

chatIconBackground

com.unblu.desk.ui.chatIconBackground

  • Type: Complex color

  • Default: $\{com.unblu.queue.ui.chatIconBackground\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Background color of the conversation tab icon for chat conversations

Icon on conversation tabs

com.unblu.desk.ui.conversationTabIcon

  • Type: String with allowed values:

    • counterpart_avatar

    • initial_engagement_type

    • none

  • Default: COUNTERPART_AVATAR

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

The icon to be display on conversation tabs

Default root page

com.unblu.desk.ui.defaultRootPage

  • Type: String with allowed values:

    • home

    • inbox

    • queue

    • scheduled

  • Default: INBOX

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Specify the default root page users are redirected to, e.g. when a conversation is closed

embeddedCobrowsingIconBackground

com.unblu.desk.ui.embeddedCobrowsingIconBackground

  • Type: Complex color

  • Default: $\{com.unblu.queue.ui.cobrowsingIconBackground\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Background color of the conversation tab icon for embedded co-browsing conversations

externalMessengerIconBackground

com.unblu.desk.ui.externalMessengerIconBackground

  • Type: Complex color

  • Default: $\{com.unblu.queue.ui.externalMessengerIconBackground\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Background color of the conversation tab icon for conversations connect through an external messenger

mobileCobrowsingIconBackground

com.unblu.desk.ui.mobileCobrowsingIconBackground

  • Type: Complex color

  • Default: $\{com.unblu.queue.ui.cobrowsingIconBackground\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Background color of the conversation tab icon for mobile co-browsing conversations

scheduledConversationIconBackground

com.unblu.desk.ui.scheduledConversationIconBackground

  • Type: Complex color

  • Default: $\{com.unblu.queue.ui.audioCallIconBackground\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Background color of the conversation tab icon for audio call conversations

screenSharingIconBackground

com.unblu.desk.ui.screenSharingIconBackground

  • Type: Complex color

  • Default: $\{com.unblu.queue.ui.cobrowsingIconBackground\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Background color of the conversation tab icon for screen sharing conversations

universalCobrowsingIconBackground

com.unblu.desk.ui.universalCobrowsingIconBackground

  • Type: Complex color

  • Default: $\{com.unblu.queue.ui.cobrowsingIconBackground\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Background color of the conversation tab icon for universal co-browsing conversations

videoCallIconBackground

com.unblu.desk.ui.videoCallIconBackground

  • Type: Complex color

  • Default: $\{com.unblu.queue.ui.videoCallIconBackground\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Background color of the conversation tab icon for video call conversations

Background color of whiteboard conversation tab icon

com.unblu.desk.ui.whiteboardIconBackground

Only visible if: com.unblu.platform.enablePreview=true

  • Type: Complex color

  • Default: $\{com.unblu.queue.ui.cobrowsingIconBackground\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Background color of the conversation tab icon for whiteboard conversations

Conversation tab shortcut configuration

Shortcut to switch to 5th conversation tab

com.unblu.desk.conversationtabs.shortcuts.fifthConversationTabShortcut

  • Type: Keyboard shortcut

  • Default: alt+5

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Keyboard shortcut to switch to the fifth open conversation tab. Make sure it is not already used by the browser itself and works on your keyboard layout.

Shortcut to switch to 1st conversation tab

com.unblu.desk.conversationtabs.shortcuts.firstConversationTabShortcut

  • Type: Keyboard shortcut

  • Default: alt+1

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Keyboard shortcut to switch to the first open conversation tab. Make sure it is not already used by the browser itself and works on your keyboard layout.

Shortcut to switch to 4th conversation tab

com.unblu.desk.conversationtabs.shortcuts.fourthConversationTabShortcut

  • Type: Keyboard shortcut

  • Default: alt+4

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Keyboard shortcut to switch to the fourth open conversation tab. Make sure it is not already used by the browser itself and works on your keyboard layout.

Shortcut to switch to 2nd conversation tab

com.unblu.desk.conversationtabs.shortcuts.secondConversationTabShortcut

  • Type: Keyboard shortcut

  • Default: alt+2

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Keyboard shortcut to switch to the second open conversation tab. Make sure it is not already used by the browser itself and works on your keyboard layout.

Shortcut to switch to 3rd conversation tab

com.unblu.desk.conversationtabs.shortcuts.thirdConversationTabShortcut

  • Type: Keyboard shortcut

  • Default: alt+3

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Keyboard shortcut to switch to the third open conversation tab. Make sure it is not already used by the browser itself and works on your keyboard layout.

Conversation history configuration

exportAs

com.unblu.conversationhistory.exportAs

  • Type: String with allowed values:

    • csv

    • excel

  • Default: CSV

  • Allowed scopes: GLOBAL, ACCOUNT

The file format that the conversation history be exported as

Limit

com.unblu.conversationhistory.limit

  • Type: Integer

  • Default: 100

  • Allowed scopes: GLOBAL, ACCOUNT

The maximum number of records to be shown in the list

Desktop navigation shortcut configuration

Shortcut to open inbox

com.unblu.desk.leftnav.shortcuts.openInboxShortcut

  • Type: Keyboard shortcut

  • Default: alt+i

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Keyboard shortcut to open the inbox. Make sure it is not already used by the browser itself and works on your keyboard layout.

Shortcut to open queue

com.unblu.desk.leftnav.shortcuts.openQueueShortcut

  • Type: Keyboard shortcut

  • Default: alt+q

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Keyboard shortcut to open the queue. Make sure it is not already used by the browser itself and works on your keyboard layout.

Shortcut to open scheduled conversations overview

com.unblu.desk.leftnav.shortcuts.openScheduledShortcut

  • Type: Keyboard shortcut

  • Default: alt+s

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Keyboard shortcut to open the scheduled conversations overview. Make sure it is not already used by the browser itself and works on your keyboard layout.

Queue UI configuration

Actions for "inbound request" queue entries for agents

com.unblu.queue.ui.agentTargetedInboundRequestAvailableNotificationActions

  • Type: List of string with allowed values:s

    • decline

    • later

  • Default: []

  • Allowed scopes: GLOBAL, ACCOUNT

The actions available for "inbound request" queue entries aimed at agents. "Decline" cancels the request for everyone. "Later" accepts the request internally and sends the predefined message to the conversation about dealing with the request later.

Automatically answer calls when accepting invitations

com.unblu.queue.ui.autoAnswerCallsOnAccept

  • Type: Boolean

  • Default: false

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

When an agent accepts an invitation with a ringing or active call, they immediately join the call, publishing camera and microphone according to the configured defaults when they open the conversation

Enable chat preview

com.unblu.queue.ui.chatQueuePreviewEnabled

  • Type: Boolean

  • Default: true

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Displays the preview button in the chat queue

Waiting time threshold of when a non-accepted incoming conversation will turn to the error color

com.unblu.queue.ui.dangerTimeThresholdSeconds

  • Type: Integer

  • Default: 120

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Waiting time threshold of when a non-accepted incoming conversation will turn to the error color.

Default queue filter languages

com.unblu.queue.ui.defaultFilterLocaleLanguages

  • Type: List of strings

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Languages to use as the default filter for the queue

Default named areas for queue filter

com.unblu.queue.ui.defaultFilterNamedAreas

  • Type: List of strings

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Named areas to use as the default filter for the queue

"Deputy delegation" notification actions

com.unblu.queue.ui.deputyDelegationAvailableNotificationActions

  • Type: List of string with allowed values:s

    • decline

    • later

  • Default: []

  • Allowed scopes: GLOBAL, ACCOUNT

The available actions for "deputy delegation" notifications. "Decline" declines the request for everyone. "Later" accepts the request internally and sends the predefined message to the conversation about dealing with the request later.

Enable declining invitations and forwardings from an agent

com.unblu.queue.ui.enableDeclineAgentInvitationsAndForwardings

  • Type: Boolean

  • Default: true

  • Allowed scopes: GLOBAL, ACCOUNT

Allow queue filter changes

com.unblu.queue.ui.enableFilterChanges

  • Type: Boolean

  • Default: true

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Specify whether it is possible to change the default queue filter in the UI

"Reserved" label background color

com.unblu.queue.ui.queueItemReservedLabelBackground

  • Type: Simple color

  • Default: #9751b9

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Background color for the "reserved" label of reserved queue items

Display an icon after a queue item’s waiting time when in a "danger" state

com.unblu.queue.ui.showDangerTimeIcon

  • Type: Boolean

  • Default: true

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Display icon when in "danger" state

Show queue items of sub-teams

com.unblu.queue.ui.showSubTeamQueues

  • Type: Boolean

  • Default: false

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Specify whether supervisors should see the queues of their team’s sub-teams

Show icon in "warning" state

com.unblu.queue.ui.showWarnTimeIcon

  • Type: Boolean

  • Default: false

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Show icon behind a queue item’s waiting time when in "warning" state

The waiting time in seconds until an incoming conversation that hasn’t been accepted will turn the "warning" color

com.unblu.queue.ui.warningTimeThresholdSeconds

  • Type: Integer

  • Default: 60

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Time in seconds until a warning is displayed on incoming requests

Automatic Request Dispatching configuration

Allow accepting inbound conversations directly with automatic dispatching

com.unblu.queue.ui.autodispatching.allowAcceptFromQueueForAutoDispatchedQueueCategories

Only visible if: com.unblu.queue.ui.autodispatching.autoRequestDispatchingEnabled=true

  • Type: Boolean

  • Default: false

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Allow agents to accept inbound conversations directly from the queue, even if they have enabled automatic dispatching

Automatically dispatched queue categories

com.unblu.queue.ui.autodispatching.autoDispatchedQueueCategories

Only visible if: com.unblu.queue.ui.autodispatching.autoRequestDispatchingEnabled=true

  • Type: List of string with allowed values:s

    • inbound

    • person

    • person_deputy

    • sub_team

    • team

  • Default: INBOUND

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Queue categories that automatic dispatching is enabled for. If more than one category has pending queue items, the dispatch order is determined by this configuration property.

Enable automatic request dispatching

com.unblu.queue.ui.autodispatching.autoRequestDispatchingEnabled

Only visible if: com.unblu.desk.ui.showQueue=true

  • Type: Boolean

  • Default: true

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Next conversation push timeout (ms)

com.unblu.queue.ui.autodispatching.nextConversationPushTimeoutAfterAccepting

Only visible if: com.unblu.queue.ui.autodispatching.autoRequestDispatchingEnabled=true

  • Type: Integer

  • Default: 2000

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Time in milliseconds before a new conversation is pushed to an agent after they have accepted an inbound conversation

Scheduled conversation shortcut configuration

Shortcut to open "Ongoing" scheduled conversation tab

com.unblu.agent.scheduled.shortcuts.openScheduledOngoingShortcut

  • Type: Keyboard shortcut

  • Default: alt+shift+o

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Keyboard shortcut to open the ongoing scheduled conversations tab. Make sure it is not already used by the browser itself and works on your keyboard layout.

Shortcut to open "Upcoming" scheduled conversation tab

com.unblu.agent.scheduled.shortcuts.openScheduledUpcomingShortcut

  • Type: Keyboard shortcut

  • Default: alt+shift+u

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Keyboard shortcut to open the upcoming scheduled conversations tab. Make sure it is not already used by the browser itself and works on your keyboard layout.

Media device access configuration

Video stream resolution

com.unblu.conversation.call.videoResolution

  • Type: String with allowed values:

    • any

    • res_1280x720

    • res_320x240

    • res_640x480

  • Default: RES_1280X720

  • Allowed scopes: GLOBAL, ACCOUNT

Defines the resolution that the video is streamed in.

Reconnect feeder

Maximum reconnect attempts

com.unblu.core.client.player.reconnect.ReconnectFeeder.maxReconnectRetries

  • Type: Integer

  • Default: 15

  • Allowed scopes: GLOBAL, ACCOUNT

Maximum number of reconnect attempts

Reconnect retry interval (ms)

com.unblu.core.client.player.reconnect.ReconnectFeeder.maxReconnectRetryIntervalMilis

  • Type: Integer

  • Default: 30000

  • Allowed scopes: GLOBAL, ACCOUNT

Maximum interval, in milliseconds, between reconnect attempts

Browser shortcut configuration

Shortcut to 5th collaboration browser tab

com.unblu.collaboration.browser.shortcuts.fifthCollaborationBrowserTabShortcut

  • Type: Keyboard shortcut

  • Default: alt+shift+5

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Keyboard shortcut to switch to the fifth open tab in the active collaboration layer. Make sure it is not already used by the browser itself and works on your keyboard layout.

Shortcut to 1st collaboration browser tab

com.unblu.collaboration.browser.shortcuts.firstCollaborationBrowserTabShortcut

  • Type: Keyboard shortcut

  • Default: alt+shift+1

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Keyboard shortcut to switch to the first open tab in the active collaboration layer. Make sure it is not already used by the browser itself and works on your keyboard layout.

Shortcut to 4th collaboration browser tab

com.unblu.collaboration.browser.shortcuts.fourthCollaborationBrowserTabShortcut

  • Type: Keyboard shortcut

  • Default: alt+shift+4

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Keyboard shortcut to switch to the fourth open tab in the active collaboration layer. Make sure it is not already used by the browser itself and works on your keyboard layout.

Shortcut to open new tab in collaboration layer

com.unblu.collaboration.browser.shortcuts.openNewTab

  • Type: Keyboard shortcut

  • Default: alt+t

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Keyboard shortcut to open a new tab in a collaboration layer. Make sure it is not already used by the browser itself and works on your keyboard layout.

Shortcut to 2nd collaboration browser tab

com.unblu.collaboration.browser.shortcuts.secondCollaborationBrowserTabShortcut

  • Type: Keyboard shortcut

  • Default: alt+shift+2

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Keyboard shortcut to switch to the second open tab in the active collaboration layer. Make sure it is not already used by the browser itself and works on your keyboard layout.

Shortcut to 3rd collaboration browser tab

com.unblu.collaboration.browser.shortcuts.thirdCollaborationBrowserTabShortcut

  • Type: Keyboard shortcut

  • Default: alt+shift+3

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Keyboard shortcut to switch to the third open tab in the active collaboration layer. Make sure it is not already used by the browser itself and works on your keyboard layout.

Click feedback animation

"Click feedback" color

com.unblu.core.client.player.ui.clickfeedback.ClickFeedbackAnimation.clickFeedbackColor

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.primary500\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Co-browsing remote control "click feedback" color

Desktop box layout

Co-browsing initial layout mode

com.unblu.core.client.player.ui.desktop.DesktopBoxLayout.initialLayoutMode

  • Type: String with allowed values:

    • show_active_window

    • show_all_windows

  • Default: SHOW_ACTIVE_WINDOW

  • Allowed scopes: GLOBAL, ACCOUNT

The initial layout mode of the desktop children used when a co-browsing session is started.

Collaboration layer window layout

Co-browsing initial zoom mode

com.unblu.core.client.player.ui.desktop.DesktopLayout.initialZoomMode

  • Type: String with allowed values:

    • actual_size

    • zoom_to_fit

  • Default: ZOOM_TO_FIT

  • Allowed scopes: GLOBAL, ACCOUNT

The initial zoom mode of the desktop content used when a co-browsing session is started.

Marker configuration

Mark mode color

com.unblu.core.client.player.ui.marker.MarkerManager.markerColor

  • Type: Complex color

  • Default: change-color($\{com.unblu.theme.color.highlightSuccess\}, $alpha:0.8)

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The color that the marking dot and rectangle should have. By default, this is the "highlight success" color.

Embedded Visitor UI configuration

Action bar background color

com.unblu.si.embedded.ui.actionBarBackgroundColor

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.neutral700\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

The color used for the action bar’s background. It may be set to "transparent" to let a custom background shine through. If set to "transparent", make sure that "actionBarForeground" is set to "DARK" or "LIGHT", as "AUTO" won’t work in this case.

Action bar divider color

com.unblu.si.embedded.ui.actionBarDividerColor

  • Type: Complex color

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

The color of the divider at the bottom of the action bar. Only relevant if actionBarElevation is set to "FLAT".

Action bar elevation

com.unblu.si.embedded.ui.actionBarElevation

  • Type: String with allowed values:

    • elevated

    • flat

  • Default: ELEVATED

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

The elevation of the action bar: "FLAT" displays a divider beneath the action bar and no shadow. "ELEVATED" displays a shadow beneath the action bar and no divider.

Action bar foreground brightness

com.unblu.si.embedded.ui.actionBarForeground

  • Type: String with allowed values:

    • auto

    • dark

    • light

  • Default: AUTO

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

The brightness of the action bar’s foreground color. When set to "AUTO", the foreground color will be chosen based on the action bar’s background color to guarantee a maximum contrast.

Collaboration placeholder background color

com.unblu.si.embedded.ui.collaborationPlaceholderBackgroundColor

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.backgroundMid\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Background color of the collaboration placeholder

Collaboration space background color

com.unblu.si.embedded.ui.collaborationSpaceBackgroundColor

  • Type: Complex color

  • Default: #525659

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Background color of collaboration layers when in an embedded environment. This is only used for layers displayed on top of the visitor page.

Enable notifications in embedded UI

com.unblu.si.embedded.ui.enableNotificationUi

  • Type: Boolean

  • Default: true

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Show notifications for new messages and calls in the Unblu embedded UI

Key event propagation mode (embedded visitor UI)

com.unblu.si.embedded.ui.keyEventPropagationMode

  • Type: String with allowed values:

    • always

    • never

    • when_not_targeting_input_element

  • Default: WHEN_NOT_TARGETING_INPUT_ELEMENT

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Defines whether to propagate keyup, keydown, and keypress events from the Unblu embedded visitor UI component to elements further up the DOM tree

Left view width

com.unblu.si.embedded.ui.leftViewWidth

  • Type: Integer

  • Default: 300

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Width of the left view of the Unblu embedded UI

View mode switch breakpoint

com.unblu.si.embedded.ui.switchViewModeBreakpoint

  • Type: Integer

  • Default: 768

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Element width at which to switch between the split and single views. The property refers to the width of the embedded element, not the screen width.

Vertical divider color

com.unblu.si.embedded.ui.verticalDividerColor

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.border\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Color used for the vertical divider between the left view and the main view

Site integration configuration

Key event propagation mode (floating visitor UI)

com.unblu.core.client.si.floating.main.SiteIntegrationConfiguration.keyEventPropagationMode

  • Type: String with allowed values:

    • always

    • never

    • when_not_targeting_input_element

  • Default: WHEN_NOT_TARGETING_INPUT_ELEMENT

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Defines whether to propagate keyup, keydown, and keypress events from the Unblu floating visitor UI component to elements further up the DOM tree

Enable diagnostics UI

com.unblu.core.client.si.floating.main.SiteIntegrationConfiguration.showDiagUi

  • Type: Boolean

  • Default: false

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Show the diagnostics button to switch between "smart snippet" mode and "escalated" mode

Single Conversation Desk configuration

Single Agent Desk redirect URL

com.unblu.agent.singleconversation.desk.conversationClosedRedirectUrl

  • Type: String

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

The URL that the agent single conversation desk is redirected to when a conversation is closed. This setting can be overridden by using the query parameter conversationEndedRedirectUrl in the URL when opening the single conversation desk.

Redirect URL for failed agent join

com.unblu.agent.singleconversation.desk.conversationJoinFailedRedirectUrl

Redirect URL for when an agent fails to join a conversation. The setting can be overridden by using the query parameter "redirectOnFailure".

Site integration UI configuration

Action bar background color

com.unblu.siteintegration.ui.actionBarBackgroundColor

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.neutral700\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

The color used for the action bar’s background. It may be set to "transparent" to let a custom background shine through. If set to "transparent", make sure that "actionBarForeground" is set to "DARK" or "LIGHT", as "AUTO" won’t work in this case.

Action bar divider color

com.unblu.siteintegration.ui.actionBarDividerColor

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.neutral700\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

The color of the divider at the bottom of the action bar. Only relevant if actionBarElevation is set to "FLAT".

Action bar elevation

com.unblu.siteintegration.ui.actionBarElevation

  • Type: String with allowed values:

    • elevated

    • flat

  • Default: ELEVATED

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

The elevation of the action bar: "FLAT" displays a divider beneath the action bar and no shadow. "ELEVATED" displays a shadow beneath the action bar and no divider.

Action bar foreground brightness

com.unblu.siteintegration.ui.actionBarForeground

  • Type: String with allowed values:

    • auto

    • dark

    • light

  • Default: AUTO

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

The brightness of the action bar’s foreground color. When set to "AUTO", the foreground color will be chosen based on the action bar’s background color so as to guarantee a maximum contrast.

Auto-collapse floating Ui when conversation is closed

com.unblu.siteintegration.ui.autoCollapseIndividualUiWhenConversationCloses

  • Type: Boolean

  • Default: false

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Automatically close the floating visitor UI when a conversation is closed

Background color of collaboration layers when in a site embedded environment. This is only used for layers displayed on top of the visitor’s page.

com.unblu.siteintegration.ui.collaborationSpaceBackgroundColor

  • Type: Complex color

  • Default: #525659

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Background color of collaboration layers when in a site embedded environment. This is only used for layers, which are displayed on top of the visitor page.

Launch button border radius

com.unblu.siteintegration.ui.launcherButtonBorderRadius

  • Type: Integer

  • Default: 100

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Unblu UI launch button border radius. The default value draws a circle.

Launcher button border width

com.unblu.siteintegration.ui.launcherButtonBorderWidth

  • Type: Integer

  • Default: 0

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Border width of the Unblu UI launcher button

Unblu UI launch button background color when hovered

com.unblu.siteintegration.ui.launcherButtonColorBackgroundHover

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.primary600\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Unblu UI launch button background color normal state

com.unblu.siteintegration.ui.launcherButtonColorBackgroundNormal

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.primary500\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Unblu UI launch button background color when pressed

com.unblu.siteintegration.ui.launcherButtonColorBackgroundPress

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.primary700\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Border color of the Unblu UI launcher button in the "hover" state

com.unblu.siteintegration.ui.launcherButtonColorBorderHover

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Border color of the Unblu UI launcher button border color in the "hover" state

Launcher button border color, "normal" state

com.unblu.siteintegration.ui.launcherButtonColorBorderNormal

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Border color of the Unblu UI launcher button in its "normal" state

Launcher button border color, "pressed" state

com.unblu.siteintegration.ui.launcherButtonColorBorderPress

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Border color of the Unblu UI launcher button when pressed

Launcher button icon and text color, "hover" state

com.unblu.siteintegration.ui.launcherButtonColorForegroundHover

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorTextInverted\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Icon and text color of the Unblu UI launcher button in the "hover" state

Launcher button icon and text color, "normal" state

com.unblu.siteintegration.ui.launcherButtonColorForegroundNormal

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorTextInverted\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

The icon and text color of the Unblu UI launcher button in the "normal" state

Launcher button icon and text color when pressed

com.unblu.siteintegration.ui.launcherButtonColorForegroundPress

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorTextInverted\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

The icon and text color of the Unblu UI launcher button when pressed

Launcher button display mode

com.unblu.siteintegration.ui.launcherButtonDisplayMode

  • Type: String with allowed values:

    • always

    • never

    • when_agent_available

    • when_in_conversation

  • Default: ALWAYS

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Specify when the Unblu launcher button should be displayed. When set to NEVER, the Unblu UI must be opened and closed via the Visitor JS API. Only set to NEVER with a corresponding API implementation.

Launcher button initial engagement icon

com.unblu.siteintegration.ui.launcherButtonIcon

  • Type: String with allowed values:

    • bell

    • camera

    • chat

    • co_browse

    • help

    • new_chat

    • phone

  • Default: CHAT

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Icon to use as the initial engagement icon on the launcher button

Launcher button icon size

com.unblu.siteintegration.ui.launcherButtonIconSize

  • Type: Integer

  • Default: 24

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

The size of the icon on the Unblu UI launcher button

Background color of launcher button notification badge

com.unblu.siteintegration.ui.launcherButtonNotificationBadgeColorBackground

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.neutral700\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

The background color of the Unblu UI launcher button’s notification badge

Text color of launcher button notification badge

com.unblu.siteintegration.ui.launcherButtonNotificationBadgeColorForeground

  • Type: Complex color

  • Default: #ffffff

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Text color on the Unblu UI launcher button’s notification badge

Launcher button padding

com.unblu.siteintegration.ui.launcherButtonPadding

  • Type: Integer

  • Default: 16

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Padding on the Unblu UI launcher button. Increasing the value will make the button bigger, decreasing it will make it smaller.

Launcher button style

com.unblu.siteintegration.ui.launcherButtonStyle

  • Type: String with allowed values:

    • icon

    • icon_and_text

    • text

  • Default: ICON

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

The visual style the Unblu UI launch button should have.

Launcher button text size

com.unblu.siteintegration.ui.launcherButtonTextSize

  • Type: Integer

  • Default: 16

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Text size for the Unblu UI launcher button

The border color of the Unblu individual UI.

com.unblu.siteintegration.ui.unbluUiBorderColor

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

Unblu UI border radius

com.unblu.siteintegration.ui.unbluUiBorderRadius

  • Type: Integer

  • Default: 6

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

The border radius of the Unblu individual UI.

Unblu UI border width

com.unblu.siteintegration.ui.unbluUiBorderWidth

  • Type: Integer

  • Default: 0

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

The border width of the Unblu individual UI.

Unblu UI content spacing

com.unblu.siteintegration.ui.unbluUiContentSpacing

  • Type: Integer

  • Default: 16

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

The spacing in pixels between the individual UI and the launcher button.

Unblu UI default height

com.unblu.siteintegration.ui.unbluUiDefaultHeight

  • Type: Integer

  • Default: 600

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

The default height of the Unblu individual UI.

Unblu UI default width

com.unblu.siteintegration.ui.unbluUiDefaultWidth

  • Type: Integer

  • Default: 360

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

The default width of the floating visitor UI

Individual UI horizontal margin (in pixels)

com.unblu.siteintegration.ui.unbluUiHorizontalMargin

  • Type: Integer

  • Default: 32

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

The margin, in pixels, between the Individual UI and the website’s left or right edge, depending on the UI’s configured position

Maximized Individual UI horizontal margin (in pixels)

com.unblu.siteintegration.ui.unbluUiHorizontalMarginMaximized

  • Type: Integer

  • Default: 16

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

The margin, in pixels, between the maximized Individual UI and the website’s left or right edge, depending on the UI’s configured position

Unblu UI position

com.unblu.siteintegration.ui.unbluUiPosition

  • Type: String with allowed values:

    • bottom_left

    • bottom_right

    • top_left

    • top_right

  • Default: BOTTOM_RIGHT

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

The position of the Unblu UI on the website.

Individual UI vertical margin (in pixels)

com.unblu.siteintegration.ui.unbluUiVerticalMargin

  • Type: Integer

  • Default: 32

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

The margin, in pixels, between the Individual UI and the website’s top or bottom edge, depending on the UI’s configured position

Maximized individual UI vertical margin

com.unblu.siteintegration.ui.unbluUiVerticalMarginMaximized

  • Type: Integer

  • Default: 16

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

The margin, in pixels, between the maximized Individual UI and the website’s top or bottom edge, depending on the UI’s configured position

Agent Desk sidebar style

Color of active navigation entry

com.unblu.nav.ui.activeHighlight

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.primary500\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Agent Desk

Background color of hovered navigation entry

com.unblu.nav.ui.backgroundHover

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.neutral800\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Agent Desk

Background color of hovered active navigation entry

com.unblu.nav.ui.backgroundHoverActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.neutral800\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Agent Desk

Normal background color of navigation entry

com.unblu.nav.ui.backgroundNormal

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Agent Desk

Normal background color of active navigation entry

com.unblu.nav.ui.backgroundNormalActive

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Agent Desk

Background color of pressed navigation entry

com.unblu.nav.ui.backgroundPress

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.neutral900\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Agent Desk

Background color of pressed active navigation entry

com.unblu.nav.ui.backgroundPressActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.neutral900\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Agent Desk

Border color of hovered navigation entry

com.unblu.nav.ui.borderHover

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Agent Desk

Border color of hovered active navigation entry

com.unblu.nav.ui.borderHoverActive

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Agent Desk

Normal border color of navigation entry

com.unblu.nav.ui.borderNormal

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Agent Desk

Normal border color of active navigation entry

com.unblu.nav.ui.borderNormalActive

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Agent Desk

Border color of pressed navigation entry

com.unblu.nav.ui.borderPress

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Agent Desk

Border color of pressed active navigation entry

com.unblu.nav.ui.borderPressActive

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Agent Desk

Border radius of navigation entry

com.unblu.nav.ui.borderRadius

  • Type: Integer

  • Default: 4

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Agent Desk

Border width of navigation entry

com.unblu.nav.ui.borderWidth

  • Type: Integer

  • Default: 1

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Agent Desk

Foreground color of hovered navigation entry

com.unblu.nav.ui.foregroundHover

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorTextInvertedMid\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Agent Desk

Foreground color of hovered active navigation entry

com.unblu.nav.ui.foregroundHoverActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorTextInverted\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Agent Desk

Foreground color of navigation entry

com.unblu.nav.ui.foregroundNormal

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorTextInvertedMid\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Agent Desk

Normal foreground color of active navigation entry

com.unblu.nav.ui.foregroundNormalActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorTextInverted\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Agent Desk

Foreground color of pressed navigation entry

com.unblu.nav.ui.foregroundPress

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorTextInvertedMid\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Agent Desk

Foreground color of pressed active navigation entry

com.unblu.nav.ui.foregroundPressActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorTextInverted\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Agent Desk

Background color

com.unblu.nav.ui.navBarBackground

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.neutral700\}

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Agent Desk

Font color of navigation section header

com.unblu.nav.ui.sectionHeaderColor

  • Type: String with allowed values:

    • announcement

    • body

    • dark

    • error

    • inverted

    • inverted_mid

    • link

    • link_dark

    • mid

    • success

    • warn

  • Default: INVERTED_MID

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Agent Desk

Section header font size

com.unblu.nav.ui.sectionHeaderSize

  • Type: String with allowed values:

    • heading1

    • heading2

    • heading3

    • paragraph

    • small

    • tiny

  • Default: TINY

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Agent Desk

Section header font weight

com.unblu.nav.ui.sectionHeaderWeight

  • Type: String with allowed values:

    • normal

    • semibold

  • Default: SEMIBOLD

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Used in the sidebar of the Agent Desk

Unblu list UI configuration

Background color of list control bar’s advanced panel

com.unblu.theme.list.controlBarColorAdvancedPanelBackground

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.backgroundLight\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Background color of list control bar’s "advanced" panel

Background color of list control bar

com.unblu.theme.list.controlBarColorBackground

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.backgroundLight\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Background color of clickable list items when hovered

com.unblu.theme.list.listItemBackgroundHover

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.backgroundMid\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Background color of clickable list items

com.unblu.theme.list.listItemBackgroundNormal

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Background color of clickable list items when pressed

com.unblu.theme.list.listItemBackgroundPress

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.gray100\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color for list item dividers

com.unblu.theme.list.listItemDividerColor

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.border\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for list item dividers

Default overflow behavior

com.unblu.theme.list.listItemValueOverflow

  • Type: String with allowed values:

    • clip

    • ellipsis

    • inherit

    • initial

  • Default: ELLIPSIS

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Default overflow behavior if a value in the list is too long to be fully displayed

Font used for primary list item values

com.unblu.theme.list.listItemValuePrimaryFont

  • Type: String with allowed values:

    • body

    • body_inverted

    • body_italic

    • dark

    • dark_inverted

    • link

    • link_dark

  • Default: LINK_DARK

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Font for primary list item values

Font used for secondary list item values

com.unblu.theme.list.listItemValueSecondaryFont

  • Type: String with allowed values:

    • body

    • body_inverted

    • body_italic

    • dark

    • dark_inverted

    • link

    • link_dark

  • Default: BODY

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Font for secondary list item values

Info toast UI configuration

Alert toast background color

com.unblu.infotoast.ui.colorAnnouncementToastBackground

  • Type: Complex color

  • Default: scale-color($\{com.unblu.theme.color.highlightAnnouncement\},$lightness: 90%)

  • Allowed scopes: GLOBAL, ACCOUNT

Announcement toast background color

Alert toast border color

com.unblu.infotoast.ui.colorAnnouncementToastBorder

  • Type: Complex color

  • Default: scale-color($\{com.unblu.theme.color.highlightAnnouncement\},$lightness: 50%)

  • Allowed scopes: GLOBAL, ACCOUNT

Announcement toast border color

Alert toast text color

com.unblu.infotoast.ui.colorAnnouncementToastForeground

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorTextAnnouncement\}

  • Allowed scopes: GLOBAL, ACCOUNT

Announcement toast text color

Announcement toast icon color

com.unblu.infotoast.ui.colorAnnouncementToastIcon

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.highlightAnnouncement\}

  • Allowed scopes: GLOBAL, ACCOUNT

"Announcement" toast icon color

Error toast background color.

com.unblu.infotoast.ui.colorErrorToastBackground

  • Type: Complex color

  • Default: scale-color($\{com.unblu.theme.color.highlightError\},$lightness: 90%)

  • Allowed scopes: GLOBAL, ACCOUNT

"Error" toast background color

Error toast border color

com.unblu.infotoast.ui.colorErrorToastBorder

  • Type: Complex color

  • Default: scale-color($\{com.unblu.theme.color.highlightError\},$lightness: 50%)

  • Allowed scopes: GLOBAL, ACCOUNT

"Error" toast border color

Error toast text color

com.unblu.infotoast.ui.colorErrorToastForeground

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorTextError\}

  • Allowed scopes: GLOBAL, ACCOUNT

"Error" toast text color

Error toast icon color

com.unblu.infotoast.ui.colorErrorToastIcon

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.highlightError\}

  • Allowed scopes: GLOBAL, ACCOUNT

Error toast icon color.

Neutral toast background color

com.unblu.infotoast.ui.colorNeutralToastBackground

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.backgroundMid\}

  • Allowed scopes: GLOBAL, ACCOUNT

"Neutral" toast background color

Neutral toast border color

com.unblu.infotoast.ui.colorNeutralToastBorder

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.border\}

  • Allowed scopes: GLOBAL, ACCOUNT

"Neutral" toast border color

Neutral toast text color

com.unblu.infotoast.ui.colorNeutralToastForeground

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorTextBody\}

  • Allowed scopes: GLOBAL, ACCOUNT

Neutral toast icon color

com.unblu.infotoast.ui.colorNeutralToastIcon

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorTextBody\}

  • Allowed scopes: GLOBAL, ACCOUNT

Success toast background color

com.unblu.infotoast.ui.colorSuccessToastBackground

  • Type: Complex color

  • Default: scale-color($\{com.unblu.theme.color.highlightSuccess\},$lightness: 90%)

  • Allowed scopes: GLOBAL, ACCOUNT

"Success" toast background color

Success toast border color

com.unblu.infotoast.ui.colorSuccessToastBorder

  • Type: Complex color

  • Default: scale-color($\{com.unblu.theme.color.highlightSuccess\},$lightness: 50%)

  • Allowed scopes: GLOBAL, ACCOUNT

"Success" toast border color

Success toast text color

com.unblu.infotoast.ui.colorSuccessToastForeground

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorTextSuccess\}

  • Allowed scopes: GLOBAL, ACCOUNT

"Success" toast text color

Success toast icon color

com.unblu.infotoast.ui.colorSuccessToastIcon

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.highlightSuccess\}

  • Allowed scopes: GLOBAL, ACCOUNT

"Success" toast icon color

Warning toast background color

com.unblu.infotoast.ui.colorWarningToastBackground

  • Type: Complex color

  • Default: scale-color($\{com.unblu.theme.color.highlightWarning\},$lightness: 90%)

  • Allowed scopes: GLOBAL, ACCOUNT

"Warning" toast background color

Warning toast border color

com.unblu.infotoast.ui.colorWarningToastBorder

  • Type: Complex color

  • Default: scale-color($\{com.unblu.theme.color.highlightWarning\},$lightness: 50%)

  • Allowed scopes: GLOBAL, ACCOUNT

"Warning" toast border color

Warning toast text color

com.unblu.infotoast.ui.colorWarningToastForeground

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorTextWarn\}

  • Allowed scopes: GLOBAL, ACCOUNT

"Warning" toast text color

Warning toast icon color

com.unblu.infotoast.ui.colorWarningToastIcon

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.highlightWarning\}

  • Allowed scopes: GLOBAL, ACCOUNT

"Warning" toast icon color

Agent Desk top bar button style

"Hovered" background color

com.unblu.tab.ui.button.backgroundHover

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.gray050\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "tab bar" button in "hovered" state

Normal background color

com.unblu.tab.ui.button.backgroundNormal

  • Type: Complex color

  • Default: #ffffff

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of "top bar" buttons in "normal" state

"Pressed" background color

com.unblu.tab.ui.button.backgroundPress

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.gray100\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of "top bar" buttons in "pressed" state

"Hovered" border color

com.unblu.tab.ui.button.borderHover

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.border\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of "top bar" buttons in "hovered" state

Normal border color

com.unblu.tab.ui.button.borderNormal

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.border\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of "top bar" buttons in "normal" state

"Pressed" border color

com.unblu.tab.ui.button.borderPress

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.border\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of "top bar" buttons in "pressed" state

"Hovered" foreground color

com.unblu.tab.ui.button.foregroundHover

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorLink\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of "top bar" buttons in "hovered" state

Normal foreground color

com.unblu.tab.ui.button.foregroundNormal

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorLinkDark\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of "top bar" buttons in "normal" state

"Pressed" foreground color

com.unblu.tab.ui.button.foregroundPress

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorLink\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of "top bar" buttons in "pressed" state

Agent Desk top bar tab style

com.unblu.tab.ui.link.backgroundHover

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.gray050\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Used for the top bar in the Agent Desk and Configuration interfaces

com.unblu.tab.ui.link.backgroundNormal

  • Type: Complex color

  • Default: #ffffff

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

The color is applied to the entire top bar unless overridden, for example when a user hovers over a tab. Used for the top bar in the Agent Desk and Configuration interfaces.

com.unblu.tab.ui.link.backgroundPress

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.gray100\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Used for the top bar in the Agent Desk and Configuration interfaces

com.unblu.tab.ui.link.borderActive

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.primary500\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Applied to the bottom border of the tab that’s currently open. Used for the top bar in the Agent Desk and Configuration interfaces.

com.unblu.tab.ui.link.borderActiveWidth

  • Type: Integer

  • Default: 3

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Applied to the top border of all tabs and the bottom border of the tab that’s currently open. Used for the top bar in the Agent Desk and Configuration interfaces.

com.unblu.tab.ui.link.borderHover

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Applied to the top border of the hovered tab. Used for the top bar in the Agent Desk and Configuration interfaces.

com.unblu.tab.ui.link.borderNormal

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Applied to the top border of all tabs that are neither hovered nor pressed. Used for the top bar in the Agent Desk and Configuration interfaces.

com.unblu.tab.ui.link.borderPress

  • Type: Complex color

  • Default: transparent

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Applied to the top border of the pressed tab. Used for the top bar in the Agent Desk and Configuration interfaces.

com.unblu.tab.ui.link.foregroundHover

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorLink\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Used for the top bar in the Agent Desk and Configuration interfaces

com.unblu.tab.ui.link.foregroundNormal

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorLinkDark\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Used for the top bar in the Agent Desk and Configuration interfaces

com.unblu.tab.ui.link.foregroundPress

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorLink\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Used for the top bar in the Agent Desk and Configuration interfaces

User menu configuration

Enable change language menu item

com.unblu.ui.usermenu.showChangeLanguage

  • Type: Boolean

  • Default: true

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Enable the "Change language" menu item

Show "Help"

com.unblu.ui.usermenu.showHelp

  • Type: Boolean

  • Default: true

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Enable the "Help" menu item

Show "Keyboard shortcuts" menu item

com.unblu.ui.usermenu.showKeyboardShortcuts

  • Type: Boolean

  • Default: true

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Enable the "Keyboard shortcuts" menu item

Show "Manage account"

com.unblu.ui.usermenu.showManageAccount

  • Type: Boolean

  • Default: true

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Enable the "Manage account" menu item

Show "Canned responses"

com.unblu.ui.usermenu.showManageCannedResponses

  • Type: Boolean

  • Default: true

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Enable the "Canned responses" menu item

Show "Deputy relationships" menu item

com.unblu.ui.usermenu.showManageDeputyRelationships

Only visible if: com.unblu.messenger.enableDeputyDelegation=true

  • Type: Boolean

  • Default: true

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Enable the "Deputy relationships" menu item

Show "Manage global server settings"

com.unblu.ui.usermenu.showManageGlobal

  • Type: Boolean

  • Default: true

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Enable the "Manage global server settings" menu item

Show "Manage profile"

com.unblu.ui.usermenu.showManageProfile

  • Type: Boolean

  • Default: true

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Enable the "Manage profile" menu item. The setting only has an effect if user profiles are managed in Unblu.

Show "Open agent desk" menu item

com.unblu.ui.usermenu.showOpenAgentDesk

  • Type: Boolean

  • Default: true

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Enable the "Open agent desk" menu item

Show pause notifications editor

com.unblu.ui.usermenu.showPauseNotificationsEditor

Only visible if: com.unblu.pausenotifications.enableManualPauseNotificationsMode=true

  • Type: Boolean

  • Default: true

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Enable the "pause notifications" menu item

Show "Sign out"

com.unblu.ui.usermenu.showSignout

  • Type: Boolean

  • Default: true

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Enable the "Sign out" menu item if it is available

Show status editor item

com.unblu.ui.usermenu.showStatusEditor

  • Type: Boolean

  • Default: true

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Enable changing online status and setting a status message in the user menu

signoutUrlForPropagatedUsers

com.unblu.ui.usermenu.signoutUrlForPropagatedUsers

  • Type: String

  • Allowed scopes: GLOBAL, ACCOUNT

The signout URL to be used for users logged in via ID propagation

Set target URL for custom help

com.unblu.ui.usermenu.uriHelp

The target URL called when agents click on the "Help" menu item. If the URL includes a ${lang} placeholder, the placeholder will be replaced with a two-letter language code, e.g. "de" or "en".

Fallback language for help URL

com.unblu.ui.usermenu.uriHelpFallbackLanguage

  • Type: String

  • Default: en

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Specify the fallback language of the help URL, if the language requested is not supported

Supported languages for help URL

com.unblu.ui.usermenu.uriHelpSupportedLanguages

  • Type: List of strings

  • Default: en

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

The languages supported by the help URL

Enable user menu

com.unblu.ui.usermenu.userMenuEnabled

  • Type: Boolean

  • Default: true

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Enable the user menu. If set to 'false', the setting disables the entire menu. This may be useful in single sign-on (SSO) implementations.

Audio notification settings

The agent’s "message sent" notification sound

com.unblu.core.client.ui.audio.chatMessageSentAgentSide

  • Type: String with allowed values:

    • call_space

    • call_tubes_big

    • call_tubes_small

    • call_wood

    • incoming_enigmatic

    • incoming_glass

    • incoming_space

    • incoming_spaceball

    • incoming_wood

    • none

    • notification_glass

    • notification_harpup

    • notification_softbell

    • notification_softup

    • notification_spaceball

    • notification_swoosh

    • notification_toy

  • Default: NOTIFICATION_SWOOSH

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

"Message sent" notification sound (agent)

The visitor’s "message sent" notification sound

com.unblu.core.client.ui.audio.chatMessageSentClientSide

  • Type: String with allowed values:

    • call_space

    • call_tubes_big

    • call_tubes_small

    • call_wood

    • incoming_enigmatic

    • incoming_glass

    • incoming_space

    • incoming_spaceball

    • incoming_wood

    • none

    • notification_glass

    • notification_harpup

    • notification_softbell

    • notification_softup

    • notification_spaceball

    • notification_swoosh

    • notification_toy

  • Default: NOTIFICATION_SWOOSH

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, APIKEY

"Message sent" notification sound (visitor)

"Incoming call" notification sound

com.unblu.core.client.ui.audio.incomingCall

  • Type: String with allowed values:

    • call_space

    • call_tubes_big

    • call_tubes_small

    • call_wood

    • incoming_enigmatic

    • incoming_glass

    • incoming_space

    • incoming_spaceball

    • incoming_wood

    • none

    • notification_glass

    • notification_harpup

    • notification_softbell

    • notification_softup

    • notification_spaceball

    • notification_swoosh

    • notification_toy

  • Default: CALL_TUBES_SMALL

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

"Layer inactivity" notification sound

com.unblu.core.client.ui.audio.layerInactivityNotificationSound

  • Type: String with allowed values:

    • call_space

    • call_tubes_big

    • call_tubes_small

    • call_wood

    • incoming_enigmatic

    • incoming_glass

    • incoming_space

    • incoming_spaceball

    • incoming_wood

    • none

    • notification_glass

    • notification_harpup

    • notification_softbell

    • notification_softup

    • notification_spaceball

    • notification_swoosh

    • notification_toy

  • Default: NOTIFICATION_SOFTUP

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

"Layer inactivity" notification sound (agent)

"New message received" notification sound (agent)

com.unblu.core.client.ui.audio.newChatMessageAgentSide

  • Type: String with allowed values:

    • call_space

    • call_tubes_big

    • call_tubes_small

    • call_wood

    • incoming_enigmatic

    • incoming_glass

    • incoming_space

    • incoming_spaceball

    • incoming_wood

    • none

    • notification_glass

    • notification_harpup

    • notification_softbell

    • notification_softup

    • notification_spaceball

    • notification_swoosh

    • notification_toy

  • Default: NOTIFICATION_GLASS

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

"New chat queue item" notification sound

com.unblu.core.client.ui.audio.newInQueueNotificationSound

  • Type: String with allowed values:

    • call_space

    • call_tubes_big

    • call_tubes_small

    • call_wood

    • incoming_enigmatic

    • incoming_glass

    • incoming_space

    • incoming_spaceball

    • incoming_wood

    • none

    • notification_glass

    • notification_harpup

    • notification_softbell

    • notification_softup

    • notification_spaceball

    • notification_swoosh

    • notification_toy

  • Default: INCOMING_GLASS

  • Allowed scopes: GLOBAL, ACCOUNT, TEAM, USER

Notification sound for new conversations in the queue and for automatically dispatched conversations

"Outgoing call" notification sound

com.unblu.core.client.ui.audio.outgoingCall

  • Type: String with allowed values:

    • call_space

    • call_tubes_big

    • call_tubes_small

    • call_wood

    • incoming_enigmatic

    • incoming_glass

    • incoming_space

    • incoming_spaceball

    • incoming_wood

    • none

    • notification_glass

    • notification_harpup

    • notification_softbell

    • notification_softup

    • notification_spaceball

    • notification_swoosh

    • notification_toy

  • Default: CALL_TUBES_BIG

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Avatar configuration

awayOnDarkBg

com.unblu.avatar.ui.awayOnDarkBg

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.highlightWarning\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color of the avatar’s online state indicator when the person is away and the avatar is in front of a dark background

awayOnLightBg

com.unblu.avatar.ui.awayOnLightBg

  • Type: Complex color

  • Default: adjust-color($\{com.unblu.avatar.ui.awayOnDarkBg\},$lightness: -12%)

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color of the avatar’s online state indicator when the person is away and the avatar is in front of a light background

hiddenOverlayBg

com.unblu.avatar.ui.hiddenOverlayBg

  • Type: Complex color

  • Default: change-color($\{com.unblu.theme.color.neutral700\}, $alpha: 0.7)

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Background color of the avatar’s overlay for hidden participants

hiddenOverlayFg

com.unblu.avatar.ui.hiddenOverlayFg

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.backgroundLight\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Foreground color of the avatar’s overlay for hidden participants

offlineOnDarkBg

com.unblu.avatar.ui.offlineOnDarkBg

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.gray200\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color of the avatar’s online state indicator when the person is offline and the avatar is in front of a dark background

offlineOnLightBg

com.unblu.avatar.ui.offlineOnLightBg

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.gray500\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color of the avatar’s online state indicator when the person is offline and the avatar is in front of a light background

onlineOnDarkBg

com.unblu.avatar.ui.onlineOnDarkBg

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.highlightSuccess\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color of the avatar’s online state indicator when the person is online and the avatar is in front of a dark background

onlineOnLightBg

com.unblu.avatar.ui.onlineOnLightBg

  • Type: Complex color

  • Default: adjust-color($\{com.unblu.avatar.ui.onlineOnDarkBg\},$lightness: -10%)

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color of the avatar’s online state indicator when the person is online and the avatar is in front of a light background

showOfflineSymbol

com.unblu.avatar.ui.showOfflineSymbol

  • Type: Boolean

  • Default: false

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Displays an offline icon when a person is offline

Show online state indicator

com.unblu.avatar.ui.showOnlineStateIndicator

  • Type: Boolean

  • Default: true

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Display the online state of agents and visitors in the avatar and related texts

Banner color configuration

Background color for "announcement" banners

com.unblu.core.client.ui.banner.color.backgroundAnnouncement

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.highlightAnnouncement\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Background color for "error" banners

com.unblu.core.client.ui.banner.color.backgroundError

  • Type: Complex color

  • Default: #bf0f26

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Background color for "neutral" banners

com.unblu.core.client.ui.banner.color.backgroundNeutral

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.gray100\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Background color for "success" banners

com.unblu.core.client.ui.banner.color.backgroundSuccess

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.highlightSuccess\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Background color for "warning" banners

com.unblu.core.client.ui.banner.color.backgroundWarning

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.highlightWarning\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

"Announcement" banner border color

com.unblu.core.client.ui.banner.color.borderAnnouncement

  • Type: Complex color

  • Default: $\{com.unblu.core.client.ui.banner.color.backgroundAnnouncement\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Border color for "announcement" banners

Border color for "error" banners

com.unblu.core.client.ui.banner.color.borderError

  • Type: Complex color

  • Default: $\{com.unblu.core.client.ui.banner.color.backgroundError\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

"Error" banner border color

Border color for "neutral" banners

com.unblu.core.client.ui.banner.color.borderNeutral

  • Type: Complex color

  • Default: $\{com.unblu.core.client.ui.banner.color.backgroundNeutral\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Neutral banner border color

Border color for "success" banners

com.unblu.core.client.ui.banner.color.borderSuccess

  • Type: Complex color

  • Default: $\{com.unblu.core.client.ui.banner.color.backgroundSuccess\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

"Success" banner border color

Border color for "warning" banners

com.unblu.core.client.ui.banner.color.borderWarning

  • Type: Complex color

  • Default: $\{com.unblu.core.client.ui.banner.color.backgroundWarning\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

"Warning" banner border color

Border width for all banners

com.unblu.core.client.ui.banner.color.borderWidth

  • Type: Integer

  • Default: 0

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Border width

Font color for "announcement" banners

com.unblu.core.client.ui.banner.color.fontAnnouncement

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorTextInverted\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Font color for "error" banners

com.unblu.core.client.ui.banner.color.fontError

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorTextInverted\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Font color for "neutral" banners

com.unblu.core.client.ui.banner.color.fontNeutral

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorTextBody\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Font color for "success" banners

com.unblu.core.client.ui.banner.color.fontSuccess

  • Type: Complex color

  • Default: #00331a

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Font color for "warning" banners

com.unblu.core.client.ui.banner.color.fontWarning

  • Type: Complex color

  • Default: #403106

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Icon color for "announcement" banners

com.unblu.core.client.ui.banner.color.iconAnnouncement

  • Type: Complex color

  • Default: $\{com.unblu.core.client.ui.banner.color.fontAnnouncement\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

"Announcement" banner icon color

Icon color for "error" banners

com.unblu.core.client.ui.banner.color.iconError

  • Type: Complex color

  • Default: $\{com.unblu.core.client.ui.banner.color.fontError\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

"Error" icon color

"Neutral" banner icon color

com.unblu.core.client.ui.banner.color.iconNeutral

  • Type: Complex color

  • Default: $\{com.unblu.core.client.ui.banner.color.fontNeutral\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Icon color for neutral banners

Icon color for "success" banners

com.unblu.core.client.ui.banner.color.iconSuccess

  • Type: Complex color

  • Default: $\{com.unblu.core.client.ui.banner.color.fontSuccess\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

"Success" banner icon color

Icon color for "warning" banners

com.unblu.core.client.ui.banner.color.iconWarning

  • Type: Complex color

  • Default: $\{com.unblu.core.client.ui.banner.color.fontWarning\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

"Warning" banner icon color

PlaceholderButtonConfiguration

Hover background color

com.unblu.placeholder.button.backgroundHover

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.neutral100\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "placeholder" button in "hovered" state

Normal background color

com.unblu.placeholder.button.backgroundNormal

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.neutral050\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "placeholder" button in "normal" state

Press background color

com.unblu.placeholder.button.backgroundPress

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.neutral200\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the background of the "placeholder" button in "pressed" state

Hover border color

com.unblu.placeholder.button.borderHover

  • Type: Complex color

  • Default: $\{com.unblu.placeholder.button.backgroundHover\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of the "placeholder" button in "hovered" state

Normal border color

com.unblu.placeholder.button.borderNormal

  • Type: Complex color

  • Default: $\{com.unblu.placeholder.button.backgroundNormal\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of the "placeholder" button in "normal" state

Press border color

com.unblu.placeholder.button.borderPress

  • Type: Complex color

  • Default: $\{com.unblu.placeholder.button.backgroundPress\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the border of the "placeholder" button in "pressed" state

Border width

com.unblu.placeholder.button.borderWidth

  • Type: Integer

  • Default: 1

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Border width of the "placeholder" button

Hover foreground color

com.unblu.placeholder.button.foregroundHover

  • Type: Complex color

  • Default: $\{com.unblu.placeholder.button.foregroundNormal\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "placeholder" button in "hovered" state

Normal foreground color

com.unblu.placeholder.button.foregroundNormal

  • Type: Complex color

  • Default: $\{com.unblu.theme.font.colorLinkDark\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "placeholder" button in "normal" state

Press foreground color

com.unblu.placeholder.button.foregroundPress

  • Type: Complex color

  • Default: $\{com.unblu.placeholder.button.foregroundNormal\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Color used for the foreground of the "placeholder" button in "pressed" state

Modal dialog configuration

Radial gradient outer color for modal dialog backdrops

com.unblu.core.client.ui.dialog.ModalDialogHost.backdropColor

  • Type: Complex color

  • Default: adjust-color($\{com.unblu.theme.color.neutral300\},$alpha:-0.30)

  • Allowed scopes: GLOBAL, ACCOUNT

Radial gradient outer color used for modal dialog backdrops

Scroll lock when dialog open

com.unblu.core.client.ui.dialog.ModalDialogHost.lockScrollingWhenDialogOpen

  • Type: Boolean

  • Default: true

  • Allowed scopes: GLOBAL, ACCOUNT

If enabled, scrolling will be locked on the window as soon as a dialog is opened using event listeners. The scroll lock will be reverted when the dialog closes.

UI notification service

Notification destination

com.unblu.core.client.ui.notification.NotificationService.notificationDestination

  • Type: String with allowed values:

    • both

    • desktop

    • toast

  • Default: BOTH

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Define where notifications should be displayed. Possible values are DESKTOP, TOAST, and BOTH.

Auto-hide timeout for toast notifications (in ms)

com.unblu.core.toaster.autoHideTimeout

  • Type: Integer

  • Default: 5000

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Timeout, in milliseconds, before web notifications and toasts are automatically hidden

Local toast notifications

Toast notifications horizontal alignment

com.unblu.core.client.ui.notification.NotificationService.toastNotificationAlignmentX

  • Type: String with allowed values:

    • left

    • middle

    • right

  • Default: LEFT

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Define where toast notifications should be displayed horizontally. Possible values are LEFT, MIDDLE, and RIGHT.

Toast notifications vertical alignment

com.unblu.core.client.ui.notification.NotificationService.toastNotificationAlignmentY

  • Type: String with allowed values:

    • bottom

    • middle

    • top

  • Default: BOTTOM

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Defines where notification toasts should be displayed vertically. Possible values are TOP, MIDDLE, and BOTTOM.

Maximum number of toasts

com.unblu.core.toaster.maxItemsShown

  • Type: Integer

  • Default: 3

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Maximum number of notification toasts shown

Notification toast configuration

Notification toast background color

com.unblu.notification.ui.notificationBackgroundColor

  • Type: Complex color

  • Default: $\{com.unblu.theme.color.backgroundLight\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Notification toast border color

com.unblu.notification.ui.notificationBorderColor

  • Type: Complex color

  • Default: $\{com.unblu.notification.ui.notificationBackgroundColor\}

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Notification toast border width

com.unblu.notification.ui.notificationBorderWidth

  • Type: Integer

  • Default: 0

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

"Notification" toast border width

Background color for "admission request" notification toast icon

com.unblu.notification.ui.notificationIconBackgroundColorAdmissionRequest

  • Type: Simple color

  • Default: ` #CBB1E6`

  • Allowed scopes: GLOBAL, ACCOUNT, AREA, TEAM, USER, APIKEY

Notification toast icon background color for "admission request" notifications

Background color for "incoming call" notification toast icon

com.unblu.notification.ui.notificationIconBackgroundColorIncomingCall

  • Type: Simple color

  • Default: ` #BBBBBB`