> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/en/build/conversation-settings/platform-settings/interaction-settings.md).

# Interaction Settings

Interaction behavior in the web chat window: greetings, conversation starters, including greeting options in Agent context, conversation display settings (resume the last conversation, conversation hi

<mark style="color:blue;">Interaction Settings</mark> controls how the chat window behaves at three stages: the start, the conversation itself, and the end. It determines what to say at the start and which questions to suggest; whether to resume the last conversation and how long to wait before ending an idle conversation; and whether to ask for satisfaction feedback afterward and what to display when the quota runs out. These settings are available only on web and internal platforms. Messaging platforms such as LINE control their own conversation interfaces. For the overall settings page structure, see [Conversation Platform Settings Overview](https://docs.maiagent.ai/maiagent-user-guide/en/build/conversation-settings/platform-settings.md).

{% hint style="info" %}
**Solution guide**: This page covers one step in configuring a conversation platform. For the complete text customer service launch process, see [Text Customer Service: From Setup to Launch](https://docs.maiagent.ai/maiagent-user-guide/en/serve/text-service.md); for voice customer service, see [Voice Customer Service: From Setup to Launch](https://docs.maiagent.ai/maiagent-user-guide/en/serve/voice.md).
{% endhint %}

## 1. When to Use These Settings <a href="#when-to-use" id="when-to-use"></a>

A customer service manager notices that visitors often do not know what to ask after opening the window, and many conversations contain only “Hello.” He opens <mark style="color:blue;">Interaction Settings</mark> for the web platform and enters “Hello! I can help you with orders, returns and exchanges, and business hours” in <mark style="color:blue;">Greeting</mark>. He then adds three <mark style="color:blue;">Conversation Starters</mark>: “How do I request a return?”, “When will my order arrive?”, and “What are your business hours?”, and enables <mark style="color:blue;">Include Greeting Options in Agent Context</mark>. After saving, visitors see three question buttons as soon as they open the window and can start a conversation with one click. When they reply “2,” the Agent also knows they are asking about delivery times.

## 2. Text Greetings <a href="#greeting" id="greeting"></a>

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-27f3085ad725f5d6b8ef3a6ca9ca9c5bb9bf58f3%2Fwebchat-interaction-greetings-prod.png?alt=media" alt="Interaction settings: text greetings, greetings by locale, voice greetings, and conversation starters"><figcaption><p>Interaction settings: greetings and conversation starters</p></figcaption></figure>

### Greeting <a href="#greeting-text" id="greeting-text"></a>

Click <mark style="color:blue;">＋ Add</mark> to add a greeting so the Agent can introduce itself or say hello at the start of a conversation. You can add multiple greetings; one is selected at random each time a conversation starts. Click the delete icon to the right of an item to remove it.

Common approaches:

* **Branded greeting**: “Welcome to our website! I’m your dedicated customer service assistant.”
* **Guided opening**: “I can help you find product information, answer usage questions, and handle orders,” clearly outlining the scope of service.

### Add Text Links to a Greeting <a href="#greeting-links" id="greeting-links"></a>

Greetings support Markdown’s `[link text](full URL)` syntax. Visitors see clickable text that opens the specified page in a new tab.

For example, a customer service manager wants visitors to read the instructions before asking questions. She enters the following in <mark style="color:blue;">Greeting</mark>:

```markdown
Hello! Welcome to our customer service demo.

Please read the [MaiAgent User Guide](https://docs.maiagent.ai/) before asking your questions.
```

After saving, open a new web conversation. Visitors will see a “MaiAgent User Guide” text link that opens the guide when clicked. Enter the full URL and test the link before publishing to confirm that it opens the correct page.

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-a9c58670632249ea6eb965c48d97f355d3ccfc48%2Fwebchat-greeting-markdown-link-prod.png?alt=media" alt="MaiAgent User Guide appears as a blue text link in the web chat greeting bubble"><figcaption><p>The greeting visitors see: a text link embedded in the greeting</p></figcaption></figure>

### Greetings by Locale <a href="#greeting-by-locale" id="greeting-by-locale"></a>

Click <mark style="color:blue;">＋ Add</mark> next to <mark style="color:blue;">Greetings by Locale</mark> to write a separate greeting for a specific locale. When the user’s language matches, that locale’s version takes priority. If no locale matches, the default greeting above is used. If a locale has multiple greetings, one is selected at random.

### Voice Greeting <a href="#voice-greeting" id="voice-greeting"></a>

Expand <mark style="color:blue;">Voice Greeting</mark> to configure a separate opening for voice conversations on platforms with voice features connected. This is unnecessary for text-only customer service.

## 3. Conversation Starters <a href="#starter-questions" id="starter-questions"></a>

Click <mark style="color:blue;">＋ Add</mark> next to <mark style="color:blue;">Conversation Starters</mark> to add guiding questions or frequently asked questions, such as “How do I request a return?” or “What are your business hours?” These questions appear as buttons at the start of a conversation. Users can click one to send it without typing.

* <mark style="color:blue;">Number to Display Randomly</mark>: When you configure multiple questions, this sets how many are randomly selected at the start of each conversation (default: 2).
* <mark style="color:blue;">Conversation Starters by Locale</mark>: As with greetings, questions for a matching locale take priority.

Conversation starters are a fixed list displayed only at the beginning of a conversation. The platform has no setting to dynamically generate suggested questions based on the conversation. To let the Agent offer clickable options based on context during a conversation, use [Quick Reply](https://docs.maiagent.ai/maiagent-user-guide/en/build/tools/agent-ui/quick-reply.md) in [Agent UI](https://docs.maiagent.ai/maiagent-user-guide/en/build/tools/agent-ui.md) (a row of buttons below an Agent reply) or the [Ask User Question tool](https://docs.maiagent.ai/maiagent-user-guide/en/build/tools/agent-ui.md#ask-user-question) (the Agent asks a question with options for the user to select).

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-3062bdaf23ab7a259e4d955d06166969931febb4%2Fwebchat-greeting-starters-prod.png?alt=media" alt="Chat window displaying a greeting and conversation starter buttons"><figcaption><p>Greeting and conversation starters at the beginning of the chat window</p></figcaption></figure>

## 4. Include Greeting Options in Agent Context <a href="#include-greeting-in-context" id="include-greeting-in-context"></a>

<mark style="color:blue;">Include Greeting Options in Agent Context</mark> is disabled by default. When enabled, the system provides the AI with the greeting text and a **numbered list of options**, allowing it to recognize selections even when users reply with a number or a short phrase.

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-1751740ab52f7e08eed37a375aac50a73f2a39f6%2Fwebchat-greeting-context-toggle-prod.png?alt=media" alt="Include Greeting Options in Agent Context toggle in interaction settings"><figcaption><p>The Include Greeting Options in Agent Context toggle</p></figcaption></figure>

### Before and After Enabling <a href="#greeting-context-comparison" id="greeting-context-comparison"></a>

Consider airline customer service: the greeting is “How can we help you?” and the conversation starters are, in order, “Flight information,” “Baggage rules,” and “Membership miles.” Once enabled, the system automatically numbers them in order. A visitor enters only “2”:

| Item                              | Disabled (default)                                                                          | Enabled                                                                                     |
| --------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| What the visitor sees             | Greeting + a randomly selected subset of starter questions                                  | Greeting + **all starter questions in the configured order**                                |
| Information available to the AI   | Greeting text only, without the options list                                                | Greeting text + numbered options list                                                       |
| When the visitor replies “2”      | The AI does not know which option “2” refers to and may ask, “What would you like to know?” | The AI understands that “2” means baggage rules and replies with the baggage rules directly |
| Starter question display behavior | Shuffled randomly and limited by Number to Display Randomly                                 | All questions appear in order; Number to Display Randomly has no effect                     |

### Use Cases <a href="#greeting-context-use-cases" id="greeting-context-use-cases"></a>

Enable this when you combine a greeting with multiple conversation starters to create menu-based guidance, allowing visitors to choose from a fixed set of services:

* **Finance / banking**: Greeting: “Welcome to online customer service. Please select a service.” Options: “Account balance,” “Credit card application status,” “Insurance policy inquiry,” and “Speak to a representative.” When a customer replies “3,” the AI goes straight to the insurance policy inquiry flow.
* **Healthcare / clinics**: Greeting: “Hello! Which service do you need?” Options: “Clinic hours,” “Book an appointment,” “Queue status,” and “Health information.” When someone replies “appointment,” the AI can also match it to option 2.
* **Government / public sector**: Greeting: “Please select the service you would like to apply for.” Options: “Subsidy application,” “Event registration,” and “Service locations.” When a resident replies “1,” the AI follows up by asking which type of subsidy they want to apply for.

| Your Guidance Style                                                                                                                                             | Recommendation                         |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- |
| **Menu-based guidance**: Multiple conversation starters are configured, and visitors are expected to reply with numbers or short phrases to follow a fixed flow | ✅ Recommended to enable                |
| **Open conversation**: Only a general greeting is configured, with no conversation starters                                                                     | ❌ No need to enable; saves Token costs |

### Things to Know When Enabled <a href="#greeting-context-side-effects" id="greeting-context-side-effects"></a>

1. **Number to Display Randomly has no effect**: To ensure that visitors see the same numbering that the AI understands, conversation starters are no longer shuffled or limited in number. All are displayed in the configured order. Before enabling, make sure you have a manageable number of questions.
2. **Higher Token costs**: A yellow warning appears when enabled to remind you that this feature increases the context length of each request. More options lead to a greater cost increase.

{% hint style="info" %}
When disabled, behavior remains the same as before: the AI can still see the greeting text but does not receive the numbered options list. If a user replies only “1,” the AI may be unable to match it to an option.
{% endhint %}

## 5. Conversation Display Settings <a href="#conversation-display" id="conversation-display"></a>

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-913aefb7e9a13d38d8985cd5ab3f4cd9772f6b8a%2Fwebchat-interaction-display-prod.png?alt=media" alt="Conversation display settings, satisfaction survey settings, and quota exhausted message"><figcaption><p>Conversation display settings, satisfaction survey settings, and quota exhausted message</p></figcaption></figure>

| Toggle                             | Description                                                                                            | Example                                                                                                    |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------- |
| **Resume Last Conversation**       | Retains the previous conversation so users can continue it when they reopen the window                 | A customer asked “When will my order arrive?” yesterday and can still see that conversation today          |
| **Show Conversation History List** | Lets users view and switch between past conversations and start new ones                               | A customer can see previous conversations such as “Today’s order question” and “Last week’s usage inquiry” |
| **Idle Timer**                     | Automatically ends the current conversation after the user has been inactive for the configured period | A customer leaves for 10 minutes after asking a question, and the conversation is marked as ended          |

Enabling <mark style="color:blue;">Idle Timer</mark> reveals two additional settings:

* <mark style="color:blue;">Idle Time (Minutes)</mark>: A range of 3 to 60 minutes.
* <mark style="color:blue;">Show Reminder Dialog</mark>: When disabled, the conversation resets immediately after the timeout. When enabled, a reminder first says, “The conversation has timed out. Please start a new conversation.” A new conversation starts only after the user clicks <mark style="color:blue;">Start New Conversation</mark>. The settings page provides a <mark style="color:blue;">Reminder Dialog Preview</mark>; actual colors follow the theme color.

{% hint style="info" %}
The idle timer applies only to substantive conversations: a greeting such as “Hello” alone does not start the timer. Timing begins after the user starts asking substantive questions. If a user leaves and returns before the idle timeout, they can continue the same conversation.
{% endhint %}

## 6. Satisfaction Survey Settings <a href="#satisfaction-survey" id="satisfaction-survey"></a>

When <mark style="color:blue;">Enable Satisfaction Survey</mark> is on, a satisfaction survey automatically appears after the conversation has been idle for a period of time. Users can rate the conversation from 1 to 5 (dissatisfied, somewhat dissatisfied, neutral, somewhat satisfied, satisfied), leave feedback, or skip the survey. Available settings:

* <mark style="color:blue;">Delay (Minutes)</mark>: How long the conversation must be idle before the survey appears.
* <mark style="color:blue;">Survey Title Text</mark>: Leave blank to use the default, “How satisfied are you with this conversation overall?”, displayed in the user’s locale.
* <mark style="color:blue;">Survey Preview</mark>: Preview the survey’s appearance in real time.

## 7. Quota Exhausted Message <a href="#quota-exhausted-message" id="quota-exhausted-message"></a>

When this platform’s Credits quota runs out or it has no valid quota, users receive the message configured here when they send a message, instead of getting no response. Enter text in <mark style="color:blue;">Default Message</mark>, such as “This service has reached its quota limit. Please try again later or contact customer service.” Click <mark style="color:blue;">＋ Add</mark> next to <mark style="color:blue;">Messages by Locale</mark> to override it for each visitor locale; locales without a setting use the default text. You can save messages for later use even before configuring a quota. Configure the quota itself on the <mark style="color:blue;">Quota</mark> main tab at the top of the settings page. See [Conversation Platform Credits Quota Management](https://docs.maiagent.ai/maiagent-user-guide/en/others/credits/inbox-credit-quota.md).

## 8. Frequently Asked Questions <a href="#faq" id="faq"></a>

### Q: Is the greeting sent to the AI? <a href="#faq-greeting-to-ai" id="faq-greeting-to-ai"></a>

The AI can see the greeting text. The options list is provided only when <mark style="color:blue;">Include Greeting Options in Agent Context</mark> is enabled. See [Section 4](#include-greeting-in-context).

### Q: Are old conversations retained after disabling Resume Last Conversation? <a href="#faq-history-kept" id="faq-history-kept"></a>

Yes. Disabling it only affects whether users resume the previous conversation when they open the window. <mark style="color:blue;">All Conversations</mark> in the admin interface still retains the full history.

### Q: Can I configure a greeting for LINE? <a href="#faq-line" id="faq-line"></a>

Interaction settings are available only on web and internal platforms. Configure LINE welcome messages in the LINE Official Account admin console.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/maiagent-user-guide/en/build/conversation-settings/platform-settings/interaction-settings.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
