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

# Suggested Messages: show clickable reply suggestions in chat

> Display clickable reply suggestions to help customers navigate conversations more efficiently

The Chatbase Suggested Messages Action shows clickable reply suggestions under your AI agent's answers, so customers can pick a next step instead of typing it. It's for teams that want to guide website visitors through common questions or a set journey. Suggestions can be written by AI for each conversation or set by hand, and they appear on the Chat Bubble, Help Page and Center Stage.

> [card] Best for:
>
> Guiding customers through a defined journey, offering obvious next steps, and cutting down on typing in channels where it's awkward.

**Common Use Cases:**

* Offering the likely follow-up questions after an answer
* Presenting a short menu of paths at the start of a conversation
* Walking a customer through a guided workflow one choice at a time

> [!NOTE]
>
> This Action changes the suggestions dynamically as the conversation develops. For fixed wordings that do not change, use the **Suggested messages** control under **Playground → Display → Content**. See [Chat Bubble display settings](https://chatbase.co/docs/user-guides/chatbot/channels.md#chat-bubble-display).

## How to create the Action

**1. Navigate to Actions**

Go to your [Chatbase dashboard](https://www.chatbase.co/dashboard/) and select your AI agent. Click **Build > Actions** in the left sidebar.

**2. Create the Action**

Click **Create Action**, then select **Suggested Messages**.

**3. Configure General Settings**

**Action Name:** A descriptive name for the Action. It's used internally to identify the Action and is not visible to customers.

**When to use:** Define when the Action should be triggered and what type of suggestions should be shown. These instructions help the AI agent determine when the Action should appear, what suggestions should be displayed, and how they should relate to the current conversation. The more specific your instructions, the more relevant the generated suggestions will be.

To restrict the Action to [Procedure](https://chatbase.co/docs/user-guides/chatbot/procedures/procedures-overview.md) steps only, turn on [**Only use in Procedures**](https://chatbase.co/docs/user-guides/chatbot/actions/actions-overview.md#only-use-in-procedures). When it's on, the **When to use** field is hidden, because the AI agent no longer decides when to call the Action.

**4. Configure the suggestions**

Choose how suggestions are produced and how they behave. See [Settings](#settings) below.

**5. Choose Channels**

This Action is compatible with the **Chat Bubble**, **Help Page**, and **Center Stage** channels only. Every other channel is incompatible and can't be selected. Toggle it on or off for each configured channel. See [Channels](https://chatbase.co/docs/user-guides/chatbot/actions/actions-overview.md#channels) for what configured, unconfigured, and incompatible mean.

**6. Enable and Test**

Ensure the Action is toggled to **Enabled**, then test it.

## Settings

**Auto generate suggested messages:** When enabled, Chatbase generates suggestions automatically from the conversation context, the customer's latest message, and the instructions in your **When to use** field. Use this when you want suggestions to adapt to each conversation.

**Manual suggested messages:** When **Auto generate suggested messages** is disabled, you can configure up to **4 suggested messages** by hand. Each one can contain up to 40 characters, appears as a clickable option, and can be edited or removed at any time. Manual suggestions give you complete control over the options presented.

Turning off **Auto generate suggested messages** changes only **what** is shown, not **when**. Your **When to use** text still decides when the suggestions appear: the AI agent shows your fixed list only when the conversation matches it.

**Disable input field:** When enabled, the message box is hidden while the latest reply shows suggestions, so customers must select one of the options to continue. Useful for guided workflows where customers should follow a predefined path. The message box comes back when:

* the customer taps a suggestion and the next reply has no suggestions,
* a reply is loading, or
* there are no suggestions to show (the box is never hidden without options).

**Generate after every message:** When enabled, Chatbase checks for suggested messages after every reply instead of letting the AI agent decide when to run the Action. This is more reliable, particularly on smaller models, which are less consistent at triggering the Action on their own.

> [!WARNING]
>
> **Generate after every message** runs after every reply even when no suggestions fit, so it adds your base model's credits to each reply. Only one Action per agent can use this setting. It's turned off when **Only use in Procedures** is on, and it isn't available on AppSumo accounts.

## How suggestions appear

Each suggestion is a button under the AI agent's reply. When a customer clicks one, its text is sent exactly as if they had typed it, and it's answered and billed like any other message. Replies that trigger the Action use credits like any other Action: see [Credit usage](https://chatbase.co/docs/user-guides/chatbot/actions/actions-overview.md#credit-usage).

**Example.** With **When to use** set to "After answering a pricing question, suggest follow-ups about plans and billing", a conversation could look like this:

> **Customer:** How much is the Business plan?
>
> **AI agent:** The Business plan is billed monthly or yearly. Here's what it includes...
>
> *Suggestions:* **Compare plans** · **Is there a free trial?** · **Talk to sales**

If the customer clicks **Is there a free trial?**, that text is sent as their next message.

## Channels

This Action currently supports:

* Chat Bubble
* Help Page
* Center Stage

It isn't available on WhatsApp, Messenger, Instagram, email, Slack, phone or the API.

Disable a channel to prevent the Action from appearing there.

> [!TIP]
>
> Test the Action by having a conversation that should produce suggestions, and confirm the right options appear and are clickable.

## Limitations

* **Manual suggestions are capped.** You can configure at most 4, each up to 40 characters.
* **Only one Action per AI agent can use Generate after every message.**
* **Not available on every channel.** Suggested messages work on the Chat Bubble, Help Page and Center Stage only.
* **Generate after every message is off in Procedures-only mode.** It's turned off when **Only use in Procedures** is on.

## Best Practices

> [card] Keep Suggestions Concise
>
> Use short, action-oriented messages that are easy to scan and select.

> [card] Be Specific in Your Instructions
>
> Clearly describe when the Action should appear and the type of suggestions that should be generated.

> [card] Use Manual Suggestions for Guided Flows
>
> Hand-written suggestions are ideal when customers should follow a specific journey or workflow.

> [card] Restrict Input Only When Necessary
>
> Enable **Disable input field** only when customers genuinely must choose from the options, since it blocks them from asking anything else.

## Frequently asked questions

> [accordion] Which channels show suggested messages?
>
> The Chat Bubble, Help Page and Center Stage. The Action can't be turned on for WhatsApp, Messenger, Instagram, email, Slack, phone or the API.

> [accordion] Do suggested messages cost extra credits?
>
> Clicking a suggestion sends a normal message, billed like a typed one. Replies that trigger the Action are billed like any Action reply (see [Credit usage](https://chatbase.co/docs/user-guides/chatbot/actions/actions-overview.md#credit-usage)). With **Generate after every message** on, every reply also uses your base model's credits for the suggestion check, even when no suggestions are shown.

> [accordion] With manual suggestions, when do they show?
>
> Your **When to use** text still decides. Turning off **Auto generate suggested messages** only replaces AI-written suggestions with your fixed list; it doesn't make them appear on every reply.

> [accordion] Why can't my customers type a message?
>
> **Disable input field** is on and the latest reply shows suggestions, so the message box is hidden. It comes back once the customer taps a suggestion and the next reply has none, or whenever there are no suggestions to show.

> [accordion] How is this different from the suggested messages in Chat Bubble settings?
>
> The suggested messages under **Playground → Display → Content** are fixed prompts shown when a customer opens the chat (and, optionally, after the first reply). This Action shows suggestions during the conversation, chosen by **When to use** and, if you like, written by AI for each reply. See [Chat Bubble display settings](https://chatbase.co/docs/user-guides/chatbot/channels.md#chat-bubble-display).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.