---
updatedAt: 2026-09-04T07:07:25.000Z
agentTools:
  projectIndex: https://documentation.indigitall.com/llms.txt
---

# Customization

We can add the following fields are custom. If they are not added, the Chat will show the default values.

```xml
<com.indigitall.android.chat.Chat
        android:id="@+id/your_id"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:channelKey="your_channel_key"
        //custom options
        app:externalKey="your_external_key"
        app:titleChat="your_title_chat"
        app:botName="your_bot_name"
        app:defaultUserName="your_user_name_default"
        app:messagePlaceholder="your_message_place_holder"
        app:openFileText="your_text_open_file"
        app:backgroundColor="your_background_color"
        app:backgroundBarColor="your_background_bar_color"
        app:primaryColor="your_primary_color"
        app:fullscreen="bool"
        app:defaultChatIconResource="your_chat_custom_icon"
        app:addContactTextButton="your_contact_text_button"
        app:contactAddedMessage="your_contact_added_message"
        app:infoContactIconsColor="your_info_contact_icons_color"
        app:infoContactTopBarTitle="your_info_contact_top_bar_title"
        app:chatAutoOpenTime="your_chat_auto_open_time_in_seconds"                                  app:clearMessages="bool"
				app:clearMessages="bool"
        app:welcomeEvent="your_welcome_event"
				app:welcomeMessage="your_html_welcome_message"
        />
```

* **externalCode** is a string that identifies each device.
* **titleChat** It is a string with the title that you want to be shown in the chat.
* **botName** is a string with the name of the bot that will be displayed above the bubble on the left side.
* **defaultUserName** It is a string with the default name that the user will have and will be displayed above the user's bubble.
* **messagePlaceholder** It is a string with the message that is displayed in the text field where it must be written.
* **openFileText** It is a string with the text that will be displayed in the case a file has to be downloaded.
* **backgroundColor** is a string with the chat background color in hexadecimal or object color.
* **backgroundBarColor** is a string with the background color of the upper and lower bars in hexadecimal or object color.
* **primaryColor** is a string with the main color of the chat, buttons and floating icon in hexadecimal or object color.
* **fullscreen** is a boolean where you indicate if you want the chat to occupy the entire screen (true) or have a certain margin of the device (false).
* **defaultChatIconResource** is a reference with the icon resource taht show on the chat main icon.
* **addContactTextButton** is a string with the message text to add a contact.
* **contactAddedMessage** is a string with the message when you added a new contact.
* **infoContactIconsColor** is a string with the color of the icons of info contact view
* **infoContactTopBarTitle** is a string top bar title of info contact view.
* **chatAutoOpenTime** is an integer that indicates the seconds for the chat to open automatically. If no *chatAutoOpenTime* is specified, such as if you press the bubble before the specified time expires, the chat can be opened manually.
* **clearMessages** is a boolean that indicate if you want to delete or clear all messages from session storage every time you open the chat
* **welcomeEvent** is a string to define the welcome message one time you open the chat
* **welcomeMessage** is a string with custom html type by user to show as first message when chat is open.

## Functionalities

You can check if the welcome event has been fired with this method:

```kotlin
val indigitallChat = findViewById<Chat>(R.id.chat)

val isEmitted = indigitallChat.isWelcomeEmitted();
```

If you want to send a message custom you can use this method:

```kotlin
val indigitallChat = findViewById<Chat>(R.id.chat)

indigitallChat.setCustomEvent("Your_event");
```

You can also control the action of deleting messages with this method:

```kotlin
val indigitallChat = findViewById<Chat>(R.id.chat)

indigitallChat.clearAllMessages()
```