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

# Message steps: text, buttons and templates

> Everything you need to send messages to your customers, from simple text messages to interactive buttons and approved WhatsApp or Messenger templates.

Most automations are built from these steps. The **Basic** category sends your customers a message: plain text, a message with buttons, a link, or an approved template.

![Flow Builder with the Basic tab selected, showing the Text Message, Button Message, Call To Action, and WhatsApp Template tiles, and a flow connecting a Start Trigger to a Button Message whose three buttons lead to a Call To Action, an Ask Question, a Media Message, and a Text Message](https://mintcdn.com/chatflows-docs/wJMcyFv6gdBNOsVY/automation/img/basic/basic-flow-steps.png?fit=max\&auto=format\&n=wJMcyFv6gdBNOsVY\&q=85\&s=640f987429fed802c7f3558175f11dee)

## Text Message

**What it does.** Sends a plain text reply — no buttons, no image. The simplest way to say something.

**When to use it.** Greetings, confirmations, opening hours, an address, a thank-you at the end of a flow.

**How to set it up.** Click the card and type your message in the **Message Text** box. Type **@** anywhere to insert a [merge field](https://docs.chatflows.io/messaging/merge-fields.md).

The **Message Text** field is required. It supports up to **4,096 characters** on WhatsApp and **2,000 characters** on Messenger. A character counter below the field shows how many characters you've used.

![Text Message settings on a WhatsApp flow, with a Message Text box containing a greeting that uses the contact first name merge field and a character counter reading 118 of 4096](https://mintcdn.com/chatflows-docs/wJMcyFv6gdBNOsVY/automation/img/basic/text-message-settings-whatsapp.png?fit=max\&auto=format\&n=wJMcyFv6gdBNOsVY\&q=85\&s=afc3c35b2a55c5d27a21bbb265cae233)

**Example**

> Hi \{\{contact.first\_name}}, thanks for reaching out to Sunrise Cafe! We're open 8am to 10pm every day. How can we help?

## ![A Start Trigger set to exact match on the keyword menu, connected to a Text Message step containing a greeting that uses the contact first name merge field](https://mintcdn.com/chatflows-docs/wJMcyFv6gdBNOsVY/automation/img/basic/text-message.png?fit=max\&auto=format\&n=wJMcyFv6gdBNOsVY\&q=85\&s=b5a9ed3675e8724fd8e6826863478efd)

## Button Message

**What it does.** Sends a message with up to three clickable buttons. The customer chooses an option by clicking a button, and the chatbot continues with the next flow step for that option.

**When to use it.** Use button messages when you want customers to choose from a list of options instead of typing a reply. They're ideal for main menus, yes/no questions, or letting customers select a service.

**How to set it up.**

1. Type the message in the **Message** box.
2. Under **Buttons**, add each button and fill in its **Button Text** — for example, `Yes, continue`.
3. **Value (payload)** is optional; leave it blank and it defaults to the button text.
4. Back in the Flow Builder, each button has its own connection point on the right. You must connect each button to the flow step you want the chatbot to run when that button is selected.

The **Message Text** field is required and supports up to **1,024 characters**. You can add up to **3 buttons**, and each Button Text is required and limited to **20 characters**.

![Button Message settings with a Message Text box, a Buttons counter reading 3 of 3, and three buttons each with its Button Text and Value payload filled in](https://mintcdn.com/chatflows-docs/wJMcyFv6gdBNOsVY/automation/img/basic/button-message-settings.png?fit=max\&auto=format\&n=wJMcyFv6gdBNOsVY\&q=85\&s=115bba5c2f19a81b5f020e9e84fb1905)

**Example**

> **Message:** What would you like to do today?
> **Buttons:** `Book a table` · `See the menu` · `Talk to us`

Connect `Book a table` to an [**Ask Question**](https://docs.chatflows.io/automation/flow-steps/ask.md#ask-question) asking for the date, `See the menu` to a [**Media Message**](https://docs.chatflows.io/automation/flow-steps/interactive.md#media-message) with your PDF menu, and `Talk to us` to a [**Text Message**](#text-message) saying someone will reply shortly.

![A Button Message with the buttons Book a table, See the menu, and Talk to us, each connected to a different next step — an Ask Question and two Text Messages](https://mintcdn.com/chatflows-docs/8QSpoWsCTFEf5plZ/automation/img/basic/button-message.png?fit=max\&auto=format\&n=8QSpoWsCTFEf5plZ\&q=85\&s=798f8bae4a04145658b0c12aec96a2cf)

***

## Call To Action

**What it does.** Sends a message with a button that opens a website or web page. When the customer clicks the button, they're taken directly to the link you've provided.

**When to use it.** Sending someone to a product page, a payment link, a booking page, or a form.

**How to set it up.** Enter the **Body Text**, the **Button Text** (for example, `Learn More`), and the **Button Link** you want the button to open. You can also add an optional **Header** and **Footer**.

The Body Text, Button Text, and Button Link fields are all required. The Body Text supports up to **1,024 characters**, Button Text up to **20 characters**, and the optional Header and Footer up to **60 characters** each.

![Call To Action settings with a Summer Sale header, a Body Text box, a Button Text of Shop now, a Button Link, a footer, and the Show typing indicator switch turned on](https://mintcdn.com/chatflows-docs/wJMcyFv6gdBNOsVY/automation/img/basic/call-to-action-settings.png?fit=max\&auto=format\&n=wJMcyFv6gdBNOsVY\&q=85\&s=937e0c2c3bee3138174094cf006a879b)

**Example**

> **Header:** Summer Sale
> **Body Text:** Everything in store is 20% off until Sunday. Tap below to browse.
> **Button Text:** Shop now
> **Button Link:** `https://example.com/sale`
> **Footer:** Free delivery over ₹999

![A Start Trigger set to exact match on the keyword sale, connected to a Call To Action step showing the Summer Sale message with a Shop now button](https://mintcdn.com/chatflows-docs/wJMcyFv6gdBNOsVY/automation/img/basic/call-to-action.png?fit=max\&auto=format\&n=wJMcyFv6gdBNOsVY\&q=85\&s=3772a80b79fb462178ae66cd666374a5)

***

## WhatsApp Template

**What it does.** Sends one of your approved [WhatsApp templates](https://docs.chatflows.io/messaging/whatsapp-templates.md).

**When to use it.** Use this step to send a ready-made, approved message from your flow — such as an order confirmation or a delivery update.

**How to set it up.** Click the step and select your template. If it has [variables](https://docs.chatflows.io/getting-started/concepts.md#the-building-blocks), fill in each **Body variable** field — type **@** to insert a [merge field](https://docs.chatflows.io/messaging/merge-fields.md) like the contact's name. If the template has a media header, upload the image, video, or document here too.

You must select a template before the flow can be saved. Length limits come from the template itself, which Meta has already approved.

![WhatsApp Template settings with the order\_shipped marketing template selected and two body variable fields filled with the contact first name and order number merge fields](https://mintcdn.com/chatflows-docs/wJMcyFv6gdBNOsVY/automation/img/basic/whatsapp-template-settings.png?fit=max\&auto=format\&n=wJMcyFv6gdBNOsVY\&q=85\&s=41f661771258b1c720d9b78a67b4c8fc)

**Example**

A Shopify-triggered flow starts with the `order_shipped` template:

> Hi \{\{1}}, your order \{\{2}} has shipped and should arrive in 2–3 days.

Map `{'{{1}}'}` to the contact's first name and `{'{{2}}'}` to the order number.

![A Start Trigger set to the Shopify Order shipped event, connected to a WhatsApp Template step previewing the shipping confirmation message with the contact first name and order number merge fields](https://mintcdn.com/chatflows-docs/wJMcyFv6gdBNOsVY/automation/img/basic/whatsapp-template.png?fit=max\&auto=format\&n=wJMcyFv6gdBNOsVY\&q=85\&s=1374d83492e51b0f3b5237aec57e8215)

> [!NOTE]
>
> You need at least one approved template first. See [WhatsApp Templates](https://docs.chatflows.io/messaging/whatsapp-templates.md). This step is hidden on Messenger flows.

***

## WhatsApp Flow

**What it does.** Sends one of your [WhatsApp Forms](https://docs.chatflows.io/messaging/whatsapp-forms.md) as part of the conversation — the customer clicks a button to open the form right inside WhatsApp. In the builder, this step is called **WhatsApp Flow**.

**When to use it.** Use this to collect structured answers from within an automated conversation — for example, a return request or a delivery address, after a Button Message option like "Return an item."

**How to set it up.** Select the **WhatsApp Flow** to send. You can also add optional **Body Text** and change the **Button Text** shown on the message (defaults to "Open").

Only **Published** flows on the same WhatsApp account as this automation appear in the dropdown. Selecting a flow is required — the flow can't be saved without one.

![WhatsApp Flow settings with the Order feedback form selected, body text asking how the order went, and a Button Text field showing Share feedback](https://mintcdn.com/chatflows-docs/rriwZ7XlN4L4cQGe/automation/img/basic/whatsapp-flow-settings.png?fit=max\&auto=format\&n=rriwZ7XlN4L4cQGe\&q=85\&s=0cecfbc30c10d85a569ed15b107b6c75)

> [!NOTE]
>
> This step needs an open 24-hour conversation window with the customer, and isn't supported on Messenger flows.

***

## Messenger Template

**What it does.** Sends one of your [Messenger templates](https://docs.chatflows.io/messaging/messenger-templates.md).

**When to use it.** Use this step to send a ready-made template from a Messenger flow — such as a welcome message or a quick reply menu.

**How to set it up.** Select your Messenger template. If it has [variables](https://docs.chatflows.io/getting-started/concepts.md#the-building-blocks), fill in each **Body variable** field — type **@** to insert a [merge field](https://docs.chatflows.io/messaging/merge-fields.md) like the contact's name. A **Preview** below shows how the message will look, including any buttons.

You must select a template before the flow can be saved.

![Messenger Template settings with the welcome\_message button template selected, one body variable set to the contact first name merge field, and a preview showing the greeting with Know More and Click Here buttons](https://mintcdn.com/chatflows-docs/wJMcyFv6gdBNOsVY/automation/img/basic/messenger-template-settings.png?fit=max\&auto=format\&n=wJMcyFv6gdBNOsVY\&q=85\&s=f6de7d166ac63245b78e09c8740bb003)

**Example**

A flow triggered by the keywords `hi` or `hello` starts with a `welcome_message` template:

> Hi \{\{1}}, welcome to our store! How can we help you today?

Map `{'{{1}}'}` to the contact's first name. The template's **Know More** and **Click Here** buttons are shown in the preview.

![A Start Trigger set to exact match on the keywords hi and hello, connected to a Messenger Template step previewing a greeting with Know More and Click Here buttons](https://mintcdn.com/chatflows-docs/wJMcyFv6gdBNOsVY/automation/img/basic/messenger-template.png?fit=max\&auto=format\&n=wJMcyFv6gdBNOsVY\&q=85\&s=c875484ba257a8c12aa6d698239872e3)

> [!NOTE]
>
> This step only appears on Messenger flows and is hidden on WhatsApp flows. See [Messenger Templates](https://docs.chatflows.io/messaging/messenger-templates.md).

***

## Show Typing Indicator

Turn this on to show a **"typing..."** bubble for a moment before your message arrives, so the chat feels more natural. It's available on every step in this category except **Messenger Template**.

![The Show typing indicator switch turned on, with helper text explaining it briefly shows the WhatsApp typing bubble before the message sends and requires an inbound trigger](https://mintcdn.com/chatflows-docs/wJMcyFv6gdBNOsVY/automation/img/basic/show-typing-indicator.png?fit=max\&auto=format\&n=wJMcyFv6gdBNOsVY\&q=85\&s=615d589622aa8ba260dd29163e272927)

***

## A worked example

A small clinic wants a flow that greets new patients and routes them:

1. [**Start Trigger**](https://docs.chatflows.io/automation/flow-builder.md#the-start-trigger) — First message from lead/customer.
2. [**Text Message**](#text-message) — "Hi \{\{contact.first\_name}}, welcome to Green Valley Clinic."
3. [**Button Message**](#button-message) — "How can we help?" with `Book an appointment`, `Opening hours`, `Speak to reception`.
4. From `Opening hours`, a **Text Message** with the timings.
5. From `Speak to reception`, a **Text Message** saying a team member will reply.
6. From `Book an appointment`, continue into the [Ask](https://docs.chatflows.io/automation/flow-steps/ask.md) steps to collect the details.

![The finished clinic flow — a Start Trigger on first message leading to a welcome Text Message, then a Button Message with Book an appointment, Opening hours, and Speak to reception, each connected to an Ask Question or a Text Message](https://mintcdn.com/chatflows-docs/wJMcyFv6gdBNOsVY/automation/img/basic/worked-example-clinic-flow.png?fit=max\&auto=format\&n=wJMcyFv6gdBNOsVY\&q=85\&s=47ec9a6a1dde820dc7774c3fb39a73e9)

## What's next

> [card] [Interactive](https://docs.chatflows.io/automation/flow-steps/interactive.md)
>
> Menus, images, videos, map pins, and contact cards.

> [card] [Ask](https://docs.chatflows.io/automation/flow-steps/ask.md)
>
> Collect answers and save them against the contact.


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