# Chat Window

### Chat Window

The **Chat Window** settings allow you to customize how your chatbot interface looks and behaves for end users. From live chat options and color themes to restart controls and advanced features, this section helps you create a seamless, branded, and user-friendly chat experience.

Use this page to:

* Customize bot and agent display labels
* Enable or disable live chat and WhatsApp transfers
* Control chat restart, ratings, and placeholder text
* Configure advanced options like ticketing, knowledge base, and AI streaming

All changes made here directly affect how users interact with your chatbot.

#### Navigation:

* Go to the “Bots” section from the left sidebar.
* Select any website bot
* Select your bot and click on “Settings”.

<figure><img src="/files/lRuSmODAXjLxmjUXTl44" alt=""><figcaption></figcaption></figure>

* Click on Chat Window tab.

<figure><img src="/files/KAw7WbulERBhiirfiMg1" alt=""><figcaption></figcaption></figure>

***

### Section Details

#### 1. Indicative Text for Bot Message

Define the label shown for bot messages in the chat window (e.g., *Bot*, *Assistant*, *Support*). This helps users clearly identify automated responses.

***

#### 2. Allow Users to Request Live Chat

Enable this option to allow users to request a conversation with a human agent during the chat.

**Additional settings include:**

* **Live/Agent Chat Display Name**: The name shown for human agents.
* **Live Chat to Bot Transfer Option**: Controls how chats are transferred back to the bot.
* **Live Chat Request Expiry Time**: Time (in seconds) after which a live chat request expires if not accepted.

***

#### 3. Live Chat Message Colors

Customize the appearance of live chat messages:

* **Primary Color**: Main message bubble color
* **Secondary Color**: Supporting message or UI color
* **Unavailable Color**: Displayed when live agents are unavailable

These options help match the chat UI with your brand identity.

***

#### 4. Enable Option to Restart Chat

Allow users to restart the conversation at any time.

* **Restart Chat Menu Option Text**: Text shown for the restart option (e.g., *Restart Chat*, *Start Over*).

<figure><img src="/files/N4lsrUv9NpftIy7lNcbJ" alt=""><figcaption></figcaption></figure>

***

#### 5. Enable Transfer to WhatsApp

Allow users to move the conversation from the website chat to WhatsApp.

* **Transfer Chat to WhatsApp Option Text**: Text displayed for the WhatsApp transfer option.

***

#### 6. Enable Rate the Chat Screen

Enable a rating screen at the end of the conversation to collect user feedback on chat experience.

<figure><img src="/files/FqCygy5jveNAaQBJiWlM" alt=""><figcaption></figcaption></figure>

***

#### 7. Enable Custom Chat Reply Placeholder Text

Customize the placeholder text shown in the chat input field (e.g., *Type your message here…*).

***

#### 8. Enable Ticketing Management

Allow users to raise support tickets directly from the chat window for follow-ups and issue tracking.

***

#### 9. Enable Knowledge Base

Enable access to your knowledge base so users can view help articles or FAQs within the chat.

***

#### 10. Clear Chat on Reload

Automatically clears the chat history when the page is refreshed.

***

#### 11. Clear Chat on Restart

Clears the previous chat history when the user restarts the conversation.

***

#### 12. Real-time AI Response Streaming

Enable streaming responses so users can see AI replies appear in real time instead of waiting for the full message.

***

#### Save Changes

Click **Save Changes** to apply all Chat Window customizations. Changes will reflect immediately on the live chatbot.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.botpenguin.com/bots/website-mobile-app-bot/chatbot-settings/chat-window.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.