> ## Documentation Index
> Fetch the complete documentation index at: https://www.revve.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Welcome Messages and Conversation Starters

> Configure what visitors see when they first open your chat widget.

When a visitor opens your chat widget for the first time, you control the initial experience through **Welcome Messages** and **Conversation Starters**. These settings are found on the **Appearance** tab under the **Content** section.

<img src="https://mintcdn.com/revve/TaVT04ULnmLhXdhq/screenshots/website-content.png?fit=max&auto=format&n=TaVT04ULnmLhXdhq&q=85&s=52bc539a3f5db1f14f131136705b261c" alt="Welcome Messages and Conversation Starters on the Appearance Content tab" width="1440" height="1800" data-path="screenshots/website-content.png" />

## Overview

| Feature                   | What It Does                                                                  | Where It Appears                                        |
| ------------------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------- |
| **Welcome Messages**      | Pre-written messages displayed as if the agent sent them when the chat opens. | At the top or bottom of the chat window (configurable). |
| **Conversation Starters** | Clickable prompt buttons that help visitors begin a conversation quickly.     | Below or above the message area, depending on layout.   |

## Welcome Messages

Welcome messages are assistant-style messages that appear automatically when a visitor opens the chat widget. They set the tone for the conversation and let visitors know what the agent can help with.

### How to Configure

1. Navigate to **Agents > Chat Agents** and select your agent.
2. Click the **Appearance** tab.
3. Select **Content** from the left sidebar.
4. Click **Start Editing** if not already in edit mode.
5. Under **Welcome Messages**, click **Add welcome message** to create a new message.
6. Type the message text in the input field.
7. Add additional messages if you want a multi-message greeting sequence.
8. Click **Save** when done.

### Welcome Messages Position

You can choose where welcome messages appear within the chat window:

| Position   | Behavior                                                                                  |
| ---------- | ----------------------------------------------------------------------------------------- |
| **Top**    | Messages appear at the top of the chat area, above any conversation. This is the default. |
| **Bottom** | Messages appear at the bottom, closer to the input field.                                 |

Select the position using the visual radio cards in the **Welcome messages location** section.

### Tips for Welcome Messages

* **Keep it brief.** One to two short messages work best. Long welcome sequences may feel overwhelming.
* **Set expectations.** Let visitors know what the agent can help with. For example: "Hi! I can help you with product questions, pricing, and scheduling a demo."
* **Use multiple messages for a natural feel.** Instead of one long paragraph, split your greeting across two messages to mimic natural conversation flow.
* **Leave it empty if using conversation starters.** If you prefer to let visitors initiate the conversation, you can skip welcome messages entirely and rely on conversation starters instead.

## Conversation Starters

Conversation starters are clickable buttons that appear in the chat widget. When a visitor clicks one, the text is sent as their first message, immediately starting a conversation on that topic.

### How to Configure

1. On the **Appearance > Content** tab, scroll down to **Conversation Starters (up to 4)**.
2. Click **Add starter** to create a new entry.
3. Type a prompt that represents a common visitor question or intent.
4. Add up to 4 conversation starters total.
5. To remove a starter, click the trash icon next to it.
6. Click **Save** when done.

### Shuffle Conversation Starters

Enable the **Shuffle Conversation Starters** toggle to randomize the order of starters each time the chat widget is opened or the page reloads. This is useful when you have multiple starters and want to give them equal visibility.

### Tips for Conversation Starters

* **Write them from the visitor's perspective.** Use first-person phrasing like "I'd like to learn about pricing" or "Help me schedule a demo."
* **Cover your top use cases.** Choose the 3-4 most common reasons visitors contact you.
* **Keep them short.** Starters appear as buttons, so concise text (under 50 characters) works best.
* **Use them alongside welcome messages** for the best visitor experience. The welcome message introduces the agent, and starters give visitors clear next steps.

## Example Configuration

**Welcome Messages:**

1. "Hi there! I'm your Customer Support assistant."
2. "I can help with product questions, account issues, and scheduling. How can I help you today?"

**Conversation Starters:**

1. "Tell me about your pricing plans"
2. "I need help with my account"
3. "Schedule a demo"
4. "Talk to a human"

## Related

* [Configuring Agent Identity](/docs/general-configuration/configuring-agent-identity) -- set the agent name that appears alongside welcome messages.
* [Language and Tone Settings](/docs/general-configuration/language-and-tone-settings) -- ensure welcome messages match your agent's configured tone.
