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

# WhatsApp forms (Flows)

> Build a form that opens inside WhatsApp, send it in a chat, and save the answers on the lead.

A **form** (Meta calls it a *Flow*) opens inside WhatsApp, so a customer fills it in without leaving the chat. When they send it, the answers come back to Marro as a note on their lead and, if you chose, as lead fields.

> [!NOTE]
>
> Forms need a connected WhatsApp Business number. Meta requires a verified business to publish and send forms, and may refuse a form it finds a problem with. Marro shows Meta's messages as they come back.

## Build a form

**1. Start from a template**

Open **Inbox → Settings → Forms** and choose **New form**. Pick a starting point (Contact request, Appointment request, Feedback) or start blank. Everything can be changed.

**2. Shape the form**

Name the form (only your team sees the name), then write the heading and an optional introduction. Beside the builder, a phone shows the form the way your customer sees it in WhatsApp, and updates as you type. Tap a question in the phone to edit it.

**3. Add and arrange questions**

**Add a question** offers short answer, long answer, email, phone, number, drop-down, pick one, pick several, date and tick box, plus a heading or a note for words on the form. Drag a question by its handle to reorder it. Open a question to change its words, its options (press Enter for the next one), whether it is required, and where the answer is saved: choose **Save on the lead as** to put an answer in a lead field; otherwise it appears only in the note. A form can have up to 20 questions.

**4. Publish**

**Save draft** keeps your work. **Publish** checks the form with WhatsApp and makes it ready to send from any chat; if WhatsApp finds a problem, the form stays a draft and the problem is shown. A published form cannot be changed: choose **Make a copy**, change the copy and publish that. **Retire** stops a published form being sent.

## Send a form

A published form is sent into a lead's chat, with a short message and a button that opens it. Like other free messages, it can only go while the chat's 24-hour window is open and never after the customer replied STOP. In a chat, choose **Send a form** (the clipboard icon beside the message box), pick the form, check the message and button label, and send. You can also ask the assistant to send it; it shows you the message for approval first.

## What comes back

When the customer submits, Marro matches the answer to the form you sent them, adds a note to the lead ("Completed the form …") and fills the mapped lead fields. A value a lead field does not accept is left out, and the note still shows what they wrote. Sending the same answer twice changes nothing.

## Limits in this version

Forms are a single screen without a server behind them. Forms with several screens, data that changes while the customer fills it in, and forms inside message templates are not available yet.


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