THEME

Style information for chat experience themes

Themes apply to chat flows for every marketing channel except Facebook and Instagram. The branding for chats on Facebook and Instagram are configured using Facebook and Instagram page administrator settings.

Request

{
    "name":               "STRING",
    "iconUrl":            "STRING",
    "logoUrl":            "STRING",
    "header":             "STRING",
    "responseBackground": "STRING",
    "chatBackground":     "STRING",
    "responseText":       "STRING",
    "mainText":           "STRING",
    "headerText":         "STRING",
    "button":             "STRING",
    "buttonBackground":   "STRING",
    "bubbleBackground":   "STRING",
    "bubble":             "STRING",
    "bubbleIconUrl":      "STRING",
    "advancedCSS":        "STRING",
    "timing":             FLOAT,
}

Response

{ 
    "themeId":            INTEGER IDENTIFIER,
    "name":               "STRING",
    "iconUrl":            "STRING",
    "logoUrl":            "STRING",
    "header":             "STRING",
    "responseBackground": "STRING",
    "chatBackground":     "STRING",
    "responseText":       "STRING",
    "mainText":           "STRING",
    "headerText":         "STRING",
    "button":             "STRING",
    "buttonBackground":   "STRING",
    "bubbleBackground":   "STRING",
    "bubble":             "STRING",
    "bubbleIconUrl":      "STRING",
    "advancedCSS":        "STRING",
    "timing":             FLOAT,
    "updated":            DATETIME
}

Meta Attributes

headerText

A human readable string that is displayed in the header bar of the chat experience. If logoUrl is set, headerText is not applicable.

name

The human readable name for the theme.

themeId

The unique integer identifier for the theme which is generated while creating the theme.

timing

The number of seconds before an alert appears beside the chat bubble. This attribute only applies to website chats.

updated

The datetime the chat theme was created in RFC3339 format.

Image Icons

Custom images can be used in some places within the chat.

iconUrl

The URL for the hosted image. This image will automatically be cropped to a circular shape.

logoUrl

The URL for the hosted image. If logoUrl is set, headerText is not applicable.

bubbleIconUrl

The URL for the hosted image. If bubbleIconUrl is set, bubble color is not applicable.

Theme Colors

Themes can be customized and created by setting hex color codes for a pre-defined set of elements. Themes can also be customized using CSS. Keep in mind, there is no validation on custom CSS and invalid CSS may break your chats.

The hex color code for the header bar background color.

chatBackground

The hex color code for the background color of the main chat window.

mainText

The hex color code for the primary text color, including server chat text.

responseText

The hex color code for the secondary text color, including user chat text.

responseBackground

The hex color code for the background of the user chat text bubble.

button

The hex color code for the button text and border color.

buttonBackground

The hex color code for the button background color.

bubble

The hex color code for the chat bubble icon color. A chat bubble will only appear for website integrations.

bubbleBackground

The hex color code for the chat bubble background color. A chat bubble will only appear for website integrations.

advancedCSS

A string containing CSS information that will be applied without validation to chat experience and bubble.

Last updated