# How to use Suggestions in Chat component

### What Are Chat Suggestions?

Chat Suggestions are **predefined or AI-generated prompts** displayed to users during a conversation. Users can tap these suggestions instead of typing, making interactions faster and more intuitive.

***

### Where to Find the Suggestions Setting

1. Open your **Bot and select the bot**
2. Go to **Chat Flow**.
3. Open or add a **Chat (AI Agent) AI Responses component**.

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

4. On the **right-side configuration panel**, scroll to the **Suggestions section**.

***

### Step-by-Step: Enable and Configure Suggestions

#### Step 1: Enable Query Suggestions

* Enable the checkbox\
  \&#xNAN;**“Query Suggestions every time with AI”**

This ensures suggestions are generated dynamically by AI during the conversation.

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

***

#### Step 2: Set Number of User Queries (Optional)

* In **“Number of user queries to handle via AI”**, enter the limit (e.g., `10`).

This defines how many user messages the AI should handle before handing off to another flow or logic.

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

***

#### Step 3: Add Chat Suggestions

1. Under **Chat Suggestions**, click the **➕ (plus)** icon.
2. Enter a suggestion text (example):
   * “Book an appointment”
   * “Talk to a doctor”
   * “Check pricing”
3. Repeat to add multiple suggestions.

💡 These suggestions will be shown to users as clickable options.

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

***

#### Step 4: (Optional) Add Custom Prompt for Suggestions

* Use **Custom Prompt for Suggestions** to guide AI on what type of suggestions to generate.

**Example:**

> “Suggest common healthcare-related questions users usually ask.”

This helps make suggestions more contextual and relevant.

<figure><img src="/files/8V3zJQwknG7DVbajJPbb" alt="" width="375"><figcaption></figcaption></figure>

***

#### Step 5: Save and Install

1. Click **Save**.
2. Click **Install** to apply the changes.
3. A success message **“Bot Updated Successfully”** confirms the update.

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

***

### How Suggestions Appear to Users

* Suggestions are shown as **quick reply buttons** inside the chat.
* Users can tap a suggestion instead of typing.
* Once selected, the suggestion is sent as a user query to the AI.


---

# 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/whatsapp-bot/manage-chatflow/how-to-use-suggestions-in-chat-component.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.
