The goal of the following document is to enumerate the different fields controlling design attributes in the SDK. If a clearer view of which attribute corresponds with a design element is needed, refer to the Attributes Design Sheet.

For things like Brand name, which is a string, refer to string values.


Accessibility

snackbar_duration_for_accessibility

Number of milliseconds to show the TTR snackbar if the accessibility TalkBack option is on.

  • Type: integer
  • Default value: 60000

Note: This value was previously named snachbar_duration_for_accessibility, and its spelling has since been corrected.

announce_agent_typing

Announce when the agent is typing. This is applicable only in Activity mode.

  • Type: bool
  • Default value: true

Agent Assignment

send_agent_profile_updates_when_conversation_closed

When set to true the callback LivePersonCallback onAgentDetailsChanged calls with the agent detail updates even if the last conversation is closed. In this case, it provides the assigned agent of the last conversation. If false, this callback is only called when the current conversation is active.

  • Type: bool
  • Default value: true

Audio messaging

enable_voice_sharing

Enable or disable the audio messaging feature.

  • Type: bool
  • Default value: false

lp_record_max_time_seconds

Maximum voice recording time in seconds.

  • Type: int
  • Default value: 120

max_number_stored_voice_files

Maximum number of voice files stored on the device.

  • Type: int
  • Default value: 120

Avatars

avatar_margin_leading

Defines the remote avatar leading spacing (from the left edge to the avatar).

  • Type: dimen
  • Default value: @dimen/margin_regular
 

avatar_margin_trailing

Defines the remote avatar Trailing spacing (from the avatar to the bubble).

  • Type: dimen
  • Default value: @dimen/margin_regular
 

Brand

lp_brand_header_text_color

The configuration to change the Brand name / Agent name text color in the header.

  • Type: color
  • Default value: black
 

brand_bubble_stroke_width

Int number for the outline width.

  • Type: dimen
  • Default value: 0dp
strokewidth
 

brand_bubble_stroke_color

Color code for the outline color.

  • Type: color
  • Default value: #004DC9 (blue)
strokecolor
 

brand_bubble_message_text_color

Color code for the text of the brand bubble.

  • Type: color
  • Default value: @android:color/white
textcolor
 

Color code for links in the text of the brand bubble.

  • Type: color
  • Default value: @android:color/white
linktextcolor
 

brand_bubble_timestamp_text_color

Color code for the timestamp of the brand bubble.

  • Type: color
  • Default value: #46474A (dark gray)
timestamptextcolor
 

brand_bubble_background_color

Color code for the background of the brand bubble.

  • Type: color
  • Default value: #004DC9 (blue)
backgroundcolor
 

brand_logo_background_color

Color code for the background of the default brand logo next to the bubble.

  • Type: color
  • Default value: #007AFF (light blue)
logobackgroundcolor
 

brand_bubble_padding_right

Brand's welcome message bubble right padding.

  • Type: dimen
  • Default value: 8dp
brand_bubble_right_padding
 

brand_bubble_padding_left

Brand's welcome message bubble left padding.

  • Type: dimen
  • Default value: 8dp
brand_bubble_left_padding
 

brand_bubble_padding_top

Brand's welcome message bubble top padding.

  • Type: dimen
  • Default value: 8dp
brand_bubble_top_padding
 

brand_bubble_padding_bottom

Brand's welcome message bubble bottom padding.

  • Type: dimen
  • Default value: 8dp
brand_bubble_bottom_padding
 

custom_font_name_conversation_feed

The font name for all conversation feed’s element.

  • Type: string
  • Default value: Empty (use the device font)
  • Example: sans-serif-thin

custom_font_name_non_conversation_feed

The font name for all elements that are not in the conversation feed.

  • Type: string
  • Default value: Empty (use the device font)
  • Example: customFont.ttf

Connection status bar

connection_status_connecting_bg_color

Define the color of status bar background color while trying to connect.

  • Type: color
  • Default value: #F2F5F5F5
connectingbgcolor
 

connection_status_not_connected_bg_color

Define the color of status bar background color when connection is unavailable.

  • Type: color
  • Default value: #CC000000
notconnectedbgcolor
 

connection_status_connecting_text_color

Define the color of status bar text color while trying to connect.

  • Type: color
  • Default value: #46474A
connectingtextcolor
 

connection_status_not_connected_text_color

Define the color of status bar text color when connection is unavailable.

  • Type: color
  • Default value: @android:color/black
notconnectedtextcolor
 

Controller Message

conversation_controller_message_text_color

Color code for the text of the automatic messages.

  • Type: color
  • Default value: #5b5c5e (dark gray)
automaticmessagecoller

Color code for the markdown hyperlink in the automatic messages.

  • Type: color
  • Default value: #5b5c5e (dark gray)
hyperlinkautomaticmessagecoller
 

Conversation Activity Style (activity mode only!)

lp_colorPrimary

Define the primary color of the activity.

  • Type: color
  • Default value: android:colorPrimary

lp_colorPrimaryDark

Define the primary dark color of the activity.

  • Type: color
  • Default value: android:colorPrimaryDark

lp_textColorSecondary

Define the color of menu button and back arrow on toolbar.

  • Type: color
  • Default value: black
secondarycolor
 

Conversations

conversation_background (color)

Define the color code for the entire view background.

In activity mode — also the color of android:windowBackground.

  • Type: color
  • Default value: white

conversation_background (image)

Sets the conversation background image.

If using Fragment mode, the minimum SDK version supports this configuration is v4.7.0.

Type: drawable

lp_caption_preview_fragment_background_color

Define the background color of caption preview screen when sending a file.

  • Type: color
  • Default value: #ffffff
captionpreviewbackgroundcolor
 

bubble_system_resolved_text_size

Conversation resolved message text size.

  • Type: dimen
  • Default value: 12sp
resolved_message_text_size
 

bubble_system_resolved_padding

Conversation resolved message padding.

  • Type: dimen
  • Default value: 4sp
resolved_message_padding
 

bubble_system_resolved_line_spacing

Conversation resolved message line spacing.

  • Type: dimen
  • Default value: 0dp
resolved_message_line_spacing
 

enable_conversation_resolved_message

Enable or disable the conversation resolved message.

  • Type: bool
  • Default value: true
conversationresolvedmessage
 

enable_conversation_resolved_separator

Enable or disable separators between conversations.

  • Type: bool
  • Default value: true
conversationresolvedseparator
 

conversation_separator_text_color

Color code for the conversation resolved message and separator.

  • Type: color
  • Default value: #555555 (gray)
conversationresolvedmessage
 

lp_hide_ui_until_auth

Define if SDK shows conversation until pass authentication check.

  • Type: bool
  • Default value: true

Data Masking

enable_client_only_masking

Defines whether to enable or disable client side only masking. False by default. This configuration is only applied for UnAuth consumer.

  • Type: bool
  • Default value: false
clientonlymasking
 

enable_real_time_masking

Defines whether to enable or disable real time masking.

  • Type: bool
  • Default value: false

client_only_masking_regex

Defines the java regex for client side only masking. By default does not contain any value.

  • Type: string
  • Default value: No value

client_only_mask_character

The character used to mask client only string.

  • Type: string
  • Default value: '*'

real_time_masking_regex

Defines the Java regex for real time masking.

  • Type: string
  • Default value: No value

real_time_mask_character

The character used to mask the real time message.

  • Type: string
  • Default value: '*'
realtimemaskcharacter
 

Date and Time

lp_date_format

Define date format.

  • Type: string
  • Default value: No value

lp_time_format

Define time format.

  • Type: string
  • Default value: No value

lp_date_time_format

Define date-time format.

  • Type: string
  • Default value: No value

message_status_numeric_timestamp_only

When false (default), timestamps display information relative to when sent/distributed/read, for example, "5 minutes ago". When true, shows as numeric only, for example, "11:32".

  • Type: bool
  • Default value: false

sendingMessageTimeoutInMinutes

Define timeout for automatic resending pending message before moving it to failed.

  • Type: integer
  • Default value: 60

Date Separator

lp_header_text_color

Text color for the Day/date header.

  • Type: color
  • Default value: #46474a (Dark gray)
header_text_color
 

lp_header_background_color

Background color for the Day/date header.

  • Type: color
  • Default value: @android:color/white
header_background_color
 

sticky_timestamp_text_size

Font text size for the Date Separator.

  • Type: dimen
  • Default value: @dimen/small_text_size
 

sticky_timestamp_margin_top

Top margin spacing of the Date Separator.

  • Type: dimen
  • Default value: 8dp
 

enter_message_top_separator_color

Top border color for the Input TextView.

  • Type: color
  • Default value: @android:color/darker_gray
 

enter_message_divider_visible

Enable (visible) or disable (hidden) the Enter Message edit text divider.

  • Type: bool
  • Default value: false
 

bubble_system_resolved_text_size

Defines the Resolved system message text size.

  • Type: dimen
  • Default value: small_text_size
 

bubble_system_resolved_padding

Defines the Resolved system message padding.

  • Type: dimen
  • Default value: margin_half
 

bubble_system_resolved_line_spacing

Defines the Resolved system message line spacing.

  • Type: dimen
  • Default value: 0dp
 

bubble_system_resolved_separator_padding_bottom

Defines the Resolved system message Separator padding.

  • Type: dimen
  • Default value: margin_half
 

lp_progress_bar_image

Defines the Progress bar image. If empty, the default Progress bar appears.

  • Type: drawable
  • Default value:
 

lpmessaging_ui_image_progress_bar.xml

Default progress bar vector drawable for downloading or uploading an image. It appears on the image, inside the bubble, until progress is done. To override this resource, create a vector drawable under the android drawable folder with the same resource name.


Delivery Notifications

message_receive_icons

For each message, there are three indicators available: Message sent, Message received, and Message read.

You can customize the indicators according to your needs, by using a number between 1 and 3.

Type: integer

  • 0: text (sent, delivered etc.) instead of icons
  • 1: Sent only
  • 2: Sent+received
  • 3: Sent+received+read
receiveicons
 

message_receive_text

If you set the resource message_receive_icons to 0, you can specify what texts appear for each state.

Type: string-array

You must have 4 items, in the following order:
  • 1st item: message sent
  • 2nd item: message delivered
  • 3rd item: message read
  • 4th item: message not delivered
  • 5th item: message sending
receivetext
 

clear_history_show_confirm_dialog

Define if to show confirm dialog before clearing history or not.

  • Type: bool
  • Default value: true

General Style

is_enable_enlarge_emojis

When true, user and remote user messages containing one or two emojis will be enlarged in chat. Messages with one emoji will be the largest, two emojis will be large, and three or more will be displayed as normal text.

  • Type: bool
  • Default value: false

vibrate_enabled

Enable or disable vibrate upon receiving messages from agent while conversation screen is in foreground. false by default.

  • Type: bool
  • Default value: false

contextual_menu_on_toolbar

Enable multiple message copy menu over the app toolbar. If true, when long pressing a message on chat it will select the message and enable a context menu over the toolbar, enabling the user to copy multiple messages. If false, long pressing a message will display a copy popup menu.

  • Type: bool
  • Default value: true

bubble_selected_background_color

Define the background color of item when it’s selected to be copied (if multiple message copy is enabled).

  • Type: color
  • Default value: #5597a7e3
bubbleselectedbackgroundcolor
 

encryptionVersion

Defines the encryption version to use. Currently available version 1 only.

  • Type: integer
  • Default value: 1 (encrypted)

csds_url

For vanity URL purposes.

  • Type: string
  • Default value: adminlogin.liveperson.net

idp_num_history_conversation

Defines the number of recent conversations (including messages) to fetch from the server when loading more conversations. Only for authenticated account.

  • Type: integer
  • Default value: 2

Defines the java regex for phone links in bubble messages.

  • Type: string
  • Default value: No value

Defines the java regex for url links in bubble messages.

  • Type: string
  • Default value: No value

Defines the java regex for email links in bubble messages. By default does not contain any value.

  • Type: string
  • Default value: No value

lpinfra_ui_ic_send_disabled.xml

You can display a different drawable to represent sending a message. Create a drawable file named lpinfra_ui_ic_send_disabled.xml, which overrides the SDK's default drawable.

To display an image instead of text, set the use_send_image_button boolean to true.

  • Type: color
  • Default value: #555555 (gray)
Default image
 

lpmessaging_ui_ic_gallery.xml

You can replace the existing Gallery image button. Create a drawable file named lpmessaging_ui_ic_gallery.xml, which overrides the SDK's default drawable.

  • Type: color
  • Default value: #004DC9 (blue)
Default image
 

lpmessaging_ui_ic_camera.xml

You can replace the existing Library image button. Create a drawable file named lpmessaging_ui_ic_camera.xml, which overrides the SDK's default drawable.

  • Type: color
  • Default value: #004DC9 (blue)
Default image
 

lpinfra_ui_ic_attach.xml

You can replace the existing Attach image. Create a drawable file named lpinfra_ui_ic_attach.xml, which overrides the SDK's default drawable.

  • Type: color
  • Default value: #555555 (gray)
Default image
 

lpinfra_ui_ic_close.xml

You can replace the existing Close image. Create a drawable file named lpinfra_ui_ic_close.xml, which overrides the SDK's default drawable.

  • Type: color
  • Default value: #555555 (gray)
Default image
 

Enable or disable link preview feature

  • Type: bool
  • Default value: true

Define which configuration to show when sending / receiving s link (big / small picture).

  • Type: bool
  • Default value: true

Define whether or not we should show a real time link preview. A preview while the consumer is typing an url.

  • Type: bool
  • Default value: true

parse only <og:> tags or others as well

  • false: use <og:title> tags only
  • true: use <og:title> and <title> tags

Message Edit Text

lp_enter_msg_text

Define the input message text color.

  • Type: color
  • Default value: @android:color/black
entermsgtext
 

lp_enter_msg_hint

Define the input message hint color.

  • Type: color
  • Default value: @android:color/darker_gray
entermsghint
 

lp_send_button_text_enable

Define the color of the send button when it’s enabled.

  • Type: color
  • Default value: #004DC9 (blue)
buttontextenable
buttontextenable2
 

lp_send_button_text_disable

Define the color of the send button when it’s disabled.

  • Type: color
  • Default value: #B7B8B9
buttontextdisable
buttontextdisable2
 

use_send_image_button

Use an icon for the send button instead of "Send" text.

  • Type: bool
  • Default value: false
sendimagebutton
 

enable_ime_options_action_send

Enable or disable the action button of the keyboard. If enabled, pressing the action button will send a message. Multi line messages are not supported if enabled.

  • Type: bool
  • Default value: false

lp_scroll_show_conversation

Configures the scroll behavior when open conversation screen from another screen of the app.

  • Type: string
  • Default value: Bottom

Available options:

  1. Bottom
  2. LastPosition
  3. FirstUnreadMessage

lp_scroll_when_foreground

Configures the scroll behavior when bring conversation screen to foreground from background.

  • Type: string
  • Default value: LastPosition

Available options:

  1. Bottom
  2. LastPosition
  3. FirstUnreadMessage

lp_scroll_when_push_notification

Configures the scroll behavior when open conversation screen by tapping on push notification.

  • Type: string
  • Default value: Bottom

Available options:

  1. Bottom
  2. LastPosition
  3. FirstUnreadMessage

lp_scroll_when_scroll_down

Configures the scroll behavior when tapping on the scroll down indicator.

  • Type: string
  • Default value: Bottom

Available options:

  1. Bottom
  2. LastPosition

scroll_down_indicator_enabled

Enable or disable the scroll down indicator (shown or invisible).

  • Type: bool
  • Default value: true
indicatorenabled
 

scroll_down_indicator_unread_summary_enabled

Enable or disable the summary in scroll down indicator (shown or invisible). If unread_indicator_bubble_enable is false, it's in minimized mode without a badge indicating number of unread message. Tapping scrolls to the last message.

The scroll to bottom button width is dynamic and will be auto adjusted based on length of the summary text.

  • Type: bool
  • Default value: true
summaryenabled1
summaryenabled2
 

scroll_down_indicator_unread_counter_text_color

Color of the unread messages counter text color.

  • Type: color
  • Default value: @android:color/white
unreadcountertextcolor
 

scroll_down_indicator_unread_summary_text_color

Color of the unread message summary (preview) text color.

  • Type: color
  • Default value: @android:color/white
unreadsummarytextcolor
 

scroll_down_indicator_unread_counter_stroke_color

Color of the unread messages counter stroke color.

  • Type: color
  • Default value: #CC000000
unreadcounterstrokecolor
 

scroll_down_indicator_unread_counter_stroke_width

Dimension of the unread messages counter stroke width.

  • Type: dimen
  • Default value: 1dp
unreadcounterstrokewidth
 

scroll_down_indicator_unread_counter_solid_color

Color of the unread messages counter solid color.

  • Type: color
  • Default value: #FF0000 (red)
unreadcountersolidcolor
 

scroll_down_indicator_background_color

Color of the scroll down background color.

  • Type: color
  • Default value: #CC000000
scrolldownindicatorbackgroundcolor
scrolldownindicatorbackgroundcolor2
 

scroll_down_indicator_arrow_down_color

Color of the image arrow scrolling down.

  • Type: color
  • Default value: @android:color/white
scrolldownindicatorarrowcolor
scrolldownindicatorarrowcolor2
 

scroll_down_indicator_radius

Left top and left bottom corner radius of the scroll down indicator.

  • Type: dimen
  • Default value: 20dp for left top and the left bottom the corners
indicatorenabled
 

scroll_down_indicator_counter_radius

Corner radius of the unread messages counter inside the scroll down indicator.

  • Type: dimen
  • Default value: 20dp for all the corners
summaryenabled1
 

Photo and file sharing

enable_photo_sharing

Enable or disable the photo sharing feature.

  • Type: bool
  • Default value: false

max_number_stored_images

Define the max number of images that will be stored locally.

  • Type: integer
  • Default value: 20

max_number_stored_documents

Define the max number of documents that will be stored locally.

  • Type: integer
  • Default value: 20

full_image_compression_rate

Define the image compression rate (percentage).

  • Type: integer
  • Default value: 50

thumbnail_longer_dimension_resize

Define the size of the thumbnail image longer dimension after resizing it (pixels).

  • Type: integer
  • Default value: 100

full_image_longer_dimension_resize

Define the size of the full image longer dimension after resizing it (pixels).

  • Type: integer
  • Default value: 800

max_image_size_kb

Define the maximum image size in KB that can be uploaded.

  • Type: integer
  • Default value: 3000

attachment_menu_item_background_color

Define the background color of the items in the attachment menu.

  • Type: color
  • Default value: #004DC9 (blue)
menuitembackgroundcolor
 

lp_attachment_menu_background_color

Define the background color of the attachment menu.

  • Type: color
  • Default value: #F5F5F5 (light gray)
attachmentmenubackgroundcolor
 

lp_attachment_menu_item_text_color

Define the items’ text color in the attachment menu.

  • Type: color
  • Default value: #46474A (gray)
attachmentmenuitemtextcolor
 

lp_attachment_menu_item_icon_color

Define the items’ icon color in the attachment menu.

  • Type: color
  • Default value: #F5F5F5 (light gray)
menuitemiconcolor
 

Quick replies

lpui_quick_reply_button_vertical_padding

Quick Replies button padding above and below the button text.

  • Type: dimen
  • Default value: 12dp

lpui_quick_reply_button_horizontal_padding

Quick Replies button padding on right and left of button text.

  • Type: dimen
  • Default value: 12dp

lpui_quick_reply_button_vertical_margin

Quick Replies button margin below.

  • Type: dimen
  • Default value: 12dp

lpui_quick_reply_button_horizontal_margin

Quick Replies button margin to the right.

  • Type: dimen
  • Default value: 8dp

lpui_quick_reply_button_border_width

Quick Replies button border width.

  • Type: dimen
  • Default value: 1dp

Secure Form

Define if to hide logo inside the pci secure form web view.

  • Type: bool
  • Default value: false

pci_form_font_name

Secure form custom font name to be used while user is filling out the secure form. If not set, the default font will be used. This is passed as CSS as secure forms are opened in a webview and will need to conform to web standards.

  • Type: string
  • Default value: No value (use device's default)

lpmessaging_ui_secure_form_progress_bar.xml

Default progress bar vector drawable for PCI secure form (after pressing to fill the form, the button changes to progress bar until we can show the form). To override this resource, create a vector drawable under the android drawable folder with the same resource name.


Survey screen

csatSurveyExpirationInMinutes

Expiration of CSAT in minutes from the moment the conversation was ended. If Survey exceeded the expiration, it does not present to the user.

  • Type: integer
  • Default value: 1440

feedback_fragment_background_color

Background color for the feedback dialog.

  • Type: color
  • Default value: @android:color/white
fragmentbackground
 

feedback_fragment_title_question

Title color for the feedback dialog.

  • Type: color
  • Default value: @android:color/black
fragmenttitle
 

feedback_fragment_star

Start color for the feedback dialog.

  • Type: color
  • Default value: #229A49 (green)
fragmentstar
 

feedback_fragment_rate_text

Rating title color for the feedback dialog.

  • Type: color
  • Default value: #5b5c5e (dark grey)
fragmentratetext
 

feedback_fragment_title_yesno

Yes and no color for the feedback dialog.

  • Type: color
  • Default value: #5b5c5e (dark grey)
fragmenttitleyesno
 

feedback_fragment_yesno_btn_selected_background

Background color of the yes or no selected in the feedback dialog.

  • Type: color
  • Default value: #229A49
fragmentyexnobtn
 

feedback_fragment_yesno_btn_default_background

Default background of the yes and no of the feedback dialog.

  • Type: color
  • Default value: @android:color/white
feedback_fragment_yesno_btn_default_background
 

feedback_fragment_yesno_btn_text_selected

Text color for the yes/no buttons when selected in the feedback dialog.

  • Type: color
  • Default value: @android:color/white
fragmentratetext
 

feedback_fragment_yesno_btn_text_default

Feedback dialog yes/no text color when in default.

  • Type: color
  • Default value: #5B5C5E
fragmentbtntextdefault
 

feedback_fragment_yesno_btn_stroke_default

Feedback dialog yes/no stroke color when in default.

  • Type: color
  • Default value: #E2E2E3
fragmentyesnobtbstroke
 

feedback_fragment_yesno_btn_stroke_selected

Feedback dialog yes/no stroke color when selected.

  • Type: color
  • Default value: #229A49
yesnobtnstrokeselected
 

feedback_fragment_yesno_btn_stroke_width_default

Feedback dialog yes/no stroke width size when in default.

  • Type: dimen
  • Default value: 1dp
yesnobtbnstrokewidth
 

feedback_fragment_yesno_btn_stroke_width_selected

Feedback dialog yes/no stroke width size when in selected.

  • Type: dimen
  • Default value: 1dp
yesnobtnstrokewidthselected
 

feedback_fragment_submit_message

Feedback dialog submit message text color.

  • Type: color
  • Default value: #565656
fragmentsubmitmessage
 

feedback_fragment_submit_btn_enabled

Feedback dialog submit button color when enabled.

  • Type: color
  • Default value: #229A49
fragmentsubmitbtnenabled
 

feedback_fragment_submit_btn_text_enabled

Feedback dialog submit button text color when enabled.

  • Type: color
  • Default value: @android:color/white
fragmentbtntextenabled
 

feedback_fragment_submit_btn_disabled

Feedback dialog submit button color when disabled.

  • Type: color
  • Default value: @android:color/white
fragmentsubmitbtndisabled
 

feedback_fragment_submit_btn_text_disabled

Feedback dialog submit button text color when disabled.

  • Type: color
  • Default value: #BDBDBD
submitbtntextdisabled
 

feedback_fragment_submit_btn_stroke_enabled

Feedback dialog submit button stroke color when enabled.

  • Type: color
  • Default value: #229A49
submitbtnstrokeenabled
 

feedback_fragment_submit_btn_stroke_disabled

Feedback dialog submit button stroke color when disabled.

  • Type: color
  • Default value: #E2E2E3
submitbtnstrokedisabled
 

feedback_fragment_submit_btn_stroke_width_enabled

Feedback dialog submit button stroke width size when enabled.

  • Type: dimen
  • Default value: 1dp
btnstrokewidthenabled
 

feedback_fragment_submit_btn_stroke_width_disabled

Feedback dialog submit button stroke width size when disabled.

  • Type: dimen
  • Default value: 1dp
btnstrokewidthdisabled
 

feedback_fragment_agent_details_name

Define the color of the agent name on agent details section in feedback dialog.Visible only if show_agent_details_csat is set to true.

  • Type: color
  • Default value: @android:color/black
fragmentagentdetailnames
 

show_feedback

Defines whether to show the feedback dialog.

  • Type: bool
  • Default value: true
 

show_agent_details_csat

Define if the agent’s name and avatar are visible on top of feedback dialog.

If both show_yes_no_question and show_agent_details_csat are set to true, then show_yes_no_question gets ignored and hidden.

  • Type: bool
  • Default value: true (show)
showyesno
 

show_yes_no_question

Defines whether to show or hide the yes/no question in the feedback dialog (true=show, false=hide).

If both show_yes_no_question and show_agent_details_csat are set to true, then show_yes_no_question gets ignored and hidden.

  • Type: bool
  • Default value: true
showyesno
 

show_csat_thank_you

Define if "thank you" screen will appear after submitting the survey.

  • Type: bool
  • Default value: true (show)
 

button_corner_radius

Makes CSAT Yes/No and Submit buttons corner radiuses customizable (through dimens.xml).

  • Type: dimen
  • Default value: 30dp
 

Structured Content

enable_structured_content

Enable or disable structured content feature.

  • Type: bool
  • Default value: false

structured_content_border_color

Color code for the structured content bubble outline color.

  • Type: color
  • Default value: #EDEDED (light gray)

structured_content_border_width

Integer in dp for the bubble stroke width of the structured content bubble.

  • Type: dimen
  • Default value: 1dp

structured_content_map_zoom&

Integer that defines the zoom level of the structured content map view. For more details, see Google map API.

  • Type: integer
  • Default value: 18

Set the Structured Content link as a callback (true) instead of a deep link intent (false).

  • Type: bool
  • Default value: false (deep link intent)

lp_google_maps_key

Set the host app's Google Map key to enable map views in Structured Content.

  • Type: string
  • Default value: no value

structured_content_background_color

The color of the background of structured content elements.

  • Type: color
  • Default value: #FFFFFF

structured_content_bottom_right_radius

Configuration for bottom right corner radius of structured content card.

  • Type: dimen
  • Default value: 0dp

structured_content_top_left_radius

Configuration for top left corner radius of structured content card.

  • Type: dimen
  • Default value: 0dp

structured_content_top_right_radius

Configuration for top right corner radius of structured content card.

  • Type: dimen
  • Default value: 0dp

structured_content_bottom_left_radius

Configuration for bottom left corner radius of structured content card.

  • Type: dimen
  • Default value: 0dp

structured_content_button_background_enabled

Enable or disable structured content button border.

  • Type: bool
  • Default value: true

structured_content_button_no_text_lines

Configuration to fit number of text lines in structured content button element.

  • Type: integer
  • Default value: 1

System messages

system_bubble_text_color

Color code for the text of the system messages.

  • Type: color
  • Default value: #46474A (dark gray)
separatortextcolor
 

Time to Response and Off Hours

disableTTRPopup

Defines whether to disable the TTR snackbar popup (true=disable) false by default.

  • Type: bool
  • Default value: false

When the auto messages feature is enabled, TTR notifications do not display when the auto messages feature is enabled, regardless of the value set for this attribute.

show_timestamp_in_ttr_notification

When true the TTR snackbar will display the time until the agent responds. If set to false, a general message is displayed.

  • Type: bool
  • Default value: true

ttr_duration

Set the duration that the TTR snackbar will be visible (ms).

  • Type: integer
  • Default value: 3000

ttrFirstTimeDelaySeconds

Set the time in seconds before the first the TTR snackbar will be displayed.

  • Type: integer
  • Default value: 10

ttr_message_off_hours_enabled

Defines whether to show the off hours snackbar popup (true=enable).

  • Type: bool
  • Default value: true

ttrShowFrequencyInSeconds

Define the frequency of the TTR (time to response) messages.

  • Type: integer
  • Default value: 8

Unread Messages

unread_indicator_bubble_enable

Toggle the mode of the unread_indicator_bubble_enable. If unread_indicator_bubble_enable is disabled, the "scroll to bottom" button will scroll to bottom of the conversation but the count indicator and message preview will not be displayed".

Note: Regardless of unread_indicator_bubble_enable value, the conversation screen will always scrolls to the last position where the user left off.

  • Type: bool
  • Default value: true

unread_indicator_bubble_text_color

Enable or disable the unread message indicator (shown or invisible) - true by default.

  • Type: color
  • Default value: #004DC9 (blue)
unreadindicatorbubbletextcolor
 

unread_indicator_bubble_background_color

Color code for the background of the unread messages bubble.

  • Type: color
  • Default value: #EDEDED (light gray)
unread_indicator_bubble_background_color
 

Bubbles

agent_bubble_stroke_width

Int number for the outline width.

  • Type: dimen
  • Default value: 0dp
strokewidth
 

agent_bubble_stroke_color

Color code for the outline color.

  • Type: color
  • Default value: #004DC9 (blue)
strokecolor
 

agent_bubble_message_text_color

Color code for the text of the agent bubble.

  • Type: color
  • Default value: white
textcolor
 

Color code for links in the text of the agent bubble.

  • Type: color
  • Default value: white
linktextcolor
 

agent_bubble_timestamp_text_color

Color code for the timestamp of the agent bubble.

  • Type: color
  • Default value: #46474A (dark gray)
timestamptextcolor
 

agent_bubble_background_color

Color code for the background of the agent bubble.

  • Type: color
  • Default value: #004DC9 (blue)
backgroundcolor
 

agent_avatar_background_color

Color code for the background of the agent default avatar next to the bubble.

  • Type: color
  • Default value: #949596 (gray)
agentavatarbackgroundcolor
 

agent_avatar_icon_color

Color code for the agent default icon in the avatar next to the bubble.

  • Type: color
  • Default value: #ffffffff
iconcolor
 

lp_messaging_ui_ic_agent_avatar

Default agent avatar appearing next to an agent’s bubble when no avatar URL is assigned on Conversational Cloud and on agent avatar appearing on the action bar.

If you want to define the background color for this avatar, override agent_avatar_background_color resource ID.

Default brand avatar on the avatar next to brand bubble (the first brand message) and on agent avatar appearing on the action bar before an agent is assigned.

If you want to define the background color for this avatar, override brand_logo_background_color resource ID. Only relevant for bubble brand’s avatar.

Background color of the agent avatar on action bar is agent_avatar_background_color.

Color code for the background of the agent bubble when url is presented.

  • Type: color
  • Default value: #ffffffff
previewbackgroundcolor
 

Color code for the background of the agent title text color when url is presented.

  • Type: color
  • Default value: #ffffffff
titletextcolor
 

Color code for the background of the agent description text color when url is presented.

  • Type: color
  • Default value: #555555 (gray)
descriptiontextcolor
 

agent_bubble_pci_form_invitation_background_color

background color of the form invitation bubble

  • Type: color
  • Default value: #ffffffff
invitationbackgroundcolor
 

agent_bubble_pci_form_invitation_background_btn_color

background color of the form invitation button only

  • Type: color
  • Default value: #ffffffff
buttontextcolor
 

agent_bubble_pci_form_invitation_stroke_color

color of the stroke (border) of the form invitation bubble.

  • Type: color
  • Default value: #949596 (gray)
strokecolor
 

agent_bubble_pci_form_invitation_button_text_color

color of the text on the button

  • Type: color
  • Default value: #004DC9 (blue)
invitationbuttoncolor
 

agent_bubble_pci_form_invitation_description_text_color

Text color on the description in the form invitation bubble.

  • Type: color
  • Default value: #949596 (gray)
descriptiontextcolor
 

agent_bubble_pci_form_invitation_title_text_color

text color on the title in the form invitation bubble.

  • Type: color
  • Default value: #ff000000
titletextcolor
 

agent_bubble_pci_form_invitation_icon_tint_color

color of the icon in the form invitation bubble.

  • Type: color
  • Default value: #004DC9 (blue)
tintcolor
 

chat_bubble_padding_right

Chat message (agent/consumer) bubble right padding.

  • Type: dimen
  • Default value: 8dp
agent_bubble_right_padding
 

chat_bubble_padding_left

Chat message (agent/consumer) bubble left padding.

  • Type: dimen
  • Default value: 8dp
agent_bubble_left_padding
 

chat_bubble_padding_top

Chat message (agent/consumer) bubble top padding.

  • Type: dimen
  • Default value: 8dp
agent_bubble_top_padding
 

chat_bubble_padding_bottom

Chat message (agent/consumer) bubble bottom padding.

  • Type: dimen
  • Default value: 8dp
agent_bubble_bottom_padding
 

show_agent_typing_in_message_bubble

True: The agent-is-typing-indicator appears in "temporary" bubble and the style is available in both fragment and activity modes.

False: The agent-is-typing-indicator appears in the status bar (under the agent name) and the style is available only in activity mode.

Only available as long as the announce_agent_typing configuration is on (set as true).

  • Type: bool
  • Default value: false
 

If you want to present a different animation or image, create a file and name it lp_messaging_ui_typing_animation_frames.xml to override the SDK's original animation.

Default value: LivePerson animation

The border color of the link preview bubble sent by the agent.

  • Type: color
  • Default value: #EDEDED

The border width of the link preview bubble sent by the agent.

  • Type: dimen
  • Default value: 1dp

consumer_bubble_stroke_width

integer in dp for the bubble stroke width of the consumer bubble.

  • Type: dimen
  • Default value: 1dp
strokewidth
 

consumer_bubble_message_text_color

Color code for the text of the consumer bubble.

  • Type: color
  • Default value: @android:color/black
messagetextcolor
 

Color code for links in the text of the consumer bubble.

  • Type: color
  • Default value: #004DC9 (blue)
linktextcolor
 

consumer_bubble_timestamp_text_color

Color code for the timestamp of the consumer bubble.

  • Type: color
  • Default value: #46474A (dark gray)
timestamptextcolor
 

consumer_bubble_background_color

Color code for the background of the consumer bubble.

  • Type: color
  • Default value: #EDEDED (light gray)
bubblebackgroundcolor
 

consumer_bubble_state_text_color

Color code for state text next to the consumer bubble.

  • Type: color
  • Default value: #46474A (dark gray)
statetextcolor
 

consumer_bubble_stroke_color

Color code for the stroke of the consumer bubble.

  • Type: color
  • Default value: #EDEDED (light gray)
strokecolor
 

Color code for the background of the consumer bubble when url is presented.

  • Type: color
  • Default value: white
previewbackgroundcolor
 

Color code for the background of the consumer title text color when url is presented.

  • Type: color
  • Default value: black
titletextcolor
 

Color code for the background of the consumer description text color when url is presented.

  • Type: color
  • Default value: #555555 (gray)
descriptiontextcolor
 

consumer_bubble_read_status_color

Color code for the read status icon (if enable).

  • Type: color
  • Default value: #004DC9 (blue)
readstatuscolor
 

consumer_bubble_received_status_color

Color code for the received status icon (if enable).

  • Type: color
  • Default value: #CECECE
statuscolor
 

consumer_bubble_sent_status_color

Color code for the sent status icon (if enable).

  • Type: color
  • Default value: #CECECE
sentstatuscolor
 

consumer_bubble_sending_status_color

Color code for the sending status icon (if enable).

  • Type: color
  • Default value: #949596 (gray)
sendingstatuscolor
 

The border color of the link preview bubble sent by the consumer.

  • Type: color
  • Default value: #EDEDED

The border width of the link preview bubble sent by the consumer.

  • Type: dimen
  • Default value: 1dp

end_bubble_bottom_left_radius

Corner radius of bottom left consumer bubbles (on the right side).

  • Type: dimen
  • Default value: 10dp, bottom_right is 0dp
strokewidth_consumer
 

end_bubble_top_left_radius

Corner radius of top left consumer bubbles (on the right side).

  • Type: dimen
  • Default value: 10dp, bottom_right is 0dp
strokewidth_consumer
 

end_bubble_top_right_radius

Corner radius of top right consumer bubbles (on the right side).

  • Type: dimen
  • Default value: 10dp, bottom_right is 0dp
strokewidth_consumer
 

end_bubble_bottom_right_radius

Corner radius of bottom right consumer bubbles (on the right side).

  • Type: dimen
  • Default value: 10dp, bottom_right is 0dp
strokewidth_consumer
 

start_bubble_bottom_left_radius

Corner radius of the bottom left agent/brand bubbles (on the left side).

  • Type: dimen
  • Default value: 10dp, bottom_left is 0dp
strokewidth_agnet
 

start_bubble_top_left_radius

Corner radius of the top left agent/brand bubbles (on the left side).

  • Type: dimen
  • Default value: 10dp, bottom_left is 0dp
strokewidth_agnet
 

start_bubble_top_right_radius

Corner radius of the top right agent/brand bubbles (on the left side).

  • Type: dimen
  • Default value: 10dp, bottom_left is 0dp
strokewidth_agnet
 

start_bubble_bottom_right_radius

Corner radius of the bottom right agent/brand bubbles (on the left side).

  • Type: dimen
  • Default value: 10dp, bottom_left is 0dp
strokewidth_agnet
 

unread_indicator_bubble_radius

Corner radius of the unread messages bubble.

  • Type: dimen
  • Default value: 20dp for all the corners
unreadindicatorbubbletextcolor
 

Enable or disable hyperlink support. Agent won’t be able to send hyperlink messages if set to false.

  • Type: bool
  • Default value: true
markdownhyperlinkmessage
 

Define the copy content of a link message. Copying the message will copy both message and hyperlink. Only the message will be copied if set to true.

  • Type: bool
  • Default value: false

Set the link message text color.

  • Type: color
  • Default value: @android:color/white

Schedule Slot List

lp_appointment_header_background_color

Appointment Scheduler window header background color.

  • Type: color
  • Default value: #0363AD

lp_appointment_header_text_color

Appointment Scheduler window text color code for title, date and confirm button (enabled) on header.

  • Type: color
  • Default value: #FFFFFF

lp_appointment_week_day_title_color

Color code for week days text: S, M, T, W, …

  • Type: color
  • Default value: #000000

lp_appointment_week_date_text_color

Color code for week date text color

  • Type: color
  • Default value: #ADBACC

lp_appointment_week_day_active_text_color

Color code for an active calendar day where appointments are available.

  • Type: color
  • Default value: #000000

lp_appointment_week_day_inactive_text_color

Color code for an in-active calendar day where appointments are not available.

  • Type: color
  • Default value: #ADBACC

lp_appointment_disabled_confirm_btn_color

Color code for Confirm button (disabled) when no appointment is selected.

  • Type: color
  • Default value: #ADBACC

lp_appointment_scheduler_background_color

Color code for background color of scheduler window.

  • Type: color
  • Default value: #FFFFFF

lp_appointment_selected_background_color

Color code for curretnly selected appointment slot.

  • Type: color
  • Default value: #0363AD

lp_appointment_title_text_color

Color code for an appointment's title and description for un-selected slots.

  • Type: color
  • Default value: #DE000000

lp_appointment_selected_title_text_color

Color code for an appointment's title and description when slot is currently selected.

  • Type: color
  • Default value: #FFFFFF

lp_appointment_time_text_color

Color code for an appointment's time for un-selected slots.

  • Type: color
  • Default value: #000000

lp_appointment_selected_time_text_color

Color code for an appointment's time when slot is currently selected.

  • Type: color
  • Default value: #FFFFFF

lp_appointment_header_date_format

Configuration to set date format of a header date on the appointment scheduler window.

  • Type: String
  • Default value: EEE, MMM d

lp_appointment_week_date_format

Configuration to set date format of a current week's date on the appointment scheduler window.

  • Type: String
  • Default value: MMMM yyyy

lp_appointment_time_format

Configuration to set time format of all appointment slots.

  • Type: String
  • Default value: hh:mm aaa

lp_appointment_date_format

Configuration to set date format of all chosen appointment slots in consumer's message.

  • Type: String
  • Default value: EEEE, MMMM d

Proactive and IVR Deflection to App Messaging

show_outbound_in_app_message

  • This configuration allows brands that want to display the outbound message in the in-app conversation interface to consumers even after they discard or ignore the message notification.

  • In case the consumer did not tap on the push notification to navigate to the in-app conversation, this configuration can be set to true if the brand wants to display the outbound message to the consumer even in the case that the look back period has expired. If set to false, the outbound message will not be displayed to consumers once they navigate to the in-app conversation screen from the app.

PushUnregisterType

Brands can choose either of the following configurations to unregister user from pusher:

enum class PushUnregisterType {
    NONE,
    ALL,
    AGENT
}

NONE: Do not unregister from pusher at all. Consumer will receive push notifications from both agent as well as outbound notification.

ALL (Default): Unregister/remove consumer from pusher. No push notifications will be sent if the consumer is logged out.

AGENT: Unregister only for agent push notification messages. Consumers will still receive outbound push notifications sent from the Proactive or Connect to Messaging (IVR) services.


Deprecated attributes

edit_text_underline_color

Color code for the Enter Message control underline color.

  • Type: color
  • Default value: #90CAF9
underlinecolor
 

custom_button_icon_name

String. Custom button icon filename without extension. This will be displayed on the toolbar.

custom_button_icon_description

String. Content description for custom button. It briefly describes the view and is primarily used for accessibility support. Set this property to enable better accessibility support for your application.

notification_large_icon_name

String. The name of a resource to use as the large icon of the push notification.

enter_message_divider_visible

Bool. Determine if the Enter Message edit text divider is visible or not.