Flow Builder: Messages Block

How do I add a Messages block?

1. Open the flow in the Flow Builder.
2. Click Add block and choose Messages. To edit an existing block, click it on the canvas.
3. Write your first message in the configuration panel on the right.
4. Click Add message to append another message inside the same block.
5. Drag the handle (⠿) next to a message to change the order of the sequence.

Every flow needs a trigger before it can send anything. You define it in the Starting point block, which is the mandatory first block of every flow.

What does the block show on the canvas?

On the canvas the block carries a green Messages header with a chat icon, plus everything you need to judge it at a glance:

• A counter: "This block contains X messages".
• Live metrics for the block: Sent, Delivered, Read, Skipped and CTR.
• A WA Pending badge on any message still waiting for approval.
• Quick reply buttons as the contact will see them, each showing where it leads.
• Connections under each message: Starting point, Message X or End point.

How do I write a single message?

Click a message and the Message content panel opens on the right:

• Internal message title — an internal name for your own orientation. The contact never sees it.
• Content — the actual WhatsApp text. The formatting bar gives you bold, italic, strikethrough, monospace and emoji, and Variables inserts personalised values such as the first name.
• Media (Optional) — under Advanced content you can attach an image, video or PDF (JPG, JPEG, PNG, MP4, PDF) by drag and drop or by clicking.
• Headline — an optional heading above the message body.
• Footer (Optional) — a line below the message, typically the stop notice that lets contacts end the communication.

Which interaction modes can I choose?

Switch on the Interactions toggle and pick one of three modes per message:

• Buttons — quick replies, link buttons and a phone number appear under the message.
• Await reply — the flow waits for a free-text reply from the contact before it sends the next message.
• Auto-send — the next message goes out without waiting for any reaction.

How do quick replies set labels and the opt-in level?

A quick reply is more than a branch in the conversation. Each button carries four settings:

• Button text — what the contact taps, for example "Yes, count me in".
• Leads to — which message follows that tap.
• Labels — the label written to the contact on tap, so the answer segments your audience automatically. See how labels work.
• Change opt-in level — the opt-in status the contact gets on tap, for example Double Opt-In or Unsubscribed. The levels themselves are explained in opt-in levels: how subscribing and unsubscribing works.

Because the contact taps the button themselves, a quick reply is a clean way to collect consent inside a running conversation. What a valid consent has to look like is a separate question — our guide to collecting WhatsApp opt-ins the GDPR-compliant way covers it.

Next to quick replies you can add link buttons (button text plus target URL) and a phone number. Both use the same Add and drag-handle controls as quick replies.

How do I test a message before the flow goes live?

The message editor has a Test messages section: "See messages and connections live in WhatsApp". Search the contact list by name or phone number, select one contact and click Send test. The message arrives on that phone exactly as your customers will receive it, which is the fastest way to catch a broken variable or a button that leads nowhere.

Why does a message show WA Pending?

Message content used in a flow has to be approved by Meta before it can be sent. While a message carries the WA Pending badge, you can keep editing and saving the flow, but you cannot activate it. Once the approval lands, the badge disappears and the flow can go live.

How do I put a pause between two messages?

Messages inside one block follow each other according to their interaction mode. For a deliberate wait — a reminder three days later, for instance — put a Delay block between two Messages blocks. Blocks can be combined and repeated as often as your sequence needs.