> ## 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.

# WhatsApp Forms for collecting customer details

> Build forms that open inside a WhatsApp chat to collect feedback, delivery addresses or return requests, without the customer leaving WhatsApp.

A WhatsApp Form is a form that opens inside a WhatsApp chat. Customers can fill in details, choose options, and submit the form without leaving WhatsApp. Use one to collect feedback, a delivery address, or a return request.

WhatsApp itself calls these **Flows**, so some buttons and screens in the app still say "flow".

## Building a form

**1. Create the form**

Go to **WhatsApp Forms** in the sidebar. Click **Add WhatsApp Flow** and fill in the details.

* **Name** — for your own reference.
* **WhatsApp Account** — choose the WhatsApp number for this form.
* **Categories** — select a category, such as Lead Generation or Survey. You cannot create a new category.

![The Add WhatsApp Flow form with fields for name, WhatsApp account, and categories](https://docs.chatflows.io/appointment-and-flow/img/whatsapp-flows/flow-form.png)

Image shows the Add WhatsApp Flow form.

**2. Design its screens**

Click a form name to open the builder.

The builder has three sections: the list of **form pages** on the left, the **page editor** in the middle, and a **phone preview** on the right.

![The WhatsApp Flow builder with a screens list and field palette on the left, the screen being edited in the middle, and a phone preview on the right](https://docs.chatflows.io/appointment-and-flow/img/whatsapp-flows/form-creation.png)

Image shows the flow builder.

Drag a field to a form page to add it.

* **Text** — A single-line text field.
* **Text Area** — A multi-line text field.
* **Phone** — A phone number field.
* **Date** — A date picker.
* **Dropdown** — Select one option from a list.
* **Radio** — Select one option from a few options.
* **Checkboxes** — Select one or more options.
* **Opt-in** — A checkbox for customer consent.

Each field includes:

* **Label** — The name shown to the customer, such as *Your name*.
* **Name (answer key)** — A unique name used to identify the answer. You can see it later in [submissions](#submissions) and [field mapping](#field-mapping).
* **Required** — Turn it on to make the field mandatory.

Each form page has a button at the bottom. Continue opens the next page, and Submit finishes the form.

**3. Publish**

Click **Publish** to send the form to Meta for approval. If Meta returns any issues, the form will remain in Draft status. Click the form name to view the errors, fix the issues, and publish the form again.

## Start from a ready-made form

You do not have to build from scratch. Click **WhatsApp Flow Collection** to see ready-made forms you can copy:

![WhatsApp Flow Collection with My Favourites and All tabs, and ready-made forms such as Lead Capture, Customer Survey, Support Ticket, Event Registration and Callback Request, each with a category label, a star and a Use This button](https://docs.chatflows.io/appointment-and-flow/img/whatsapp-flows/flow-collection.png)

Image shows the WhatsApp Flow Collection.

Select one and **Use This** copies it into your workspace as a draft you can change and publish.

## The forms list

The WhatsApp Forms page shows all your forms. Each form shows its **name**, **channel**, **status**, **category**, and an **Active** switch to turn it on or off.

![A list of six forms, such as Order feedback, Return request and Delivery address, with their status, category, channel, an Active switch and created date, plus Sync from Meta, WhatsApp Flow Collection and Add WhatsApp Flow buttons](https://docs.chatflows.io/appointment-and-flow/img/whatsapp-flows/flow.png)

Image shows the WhatsApp Forms list.

| Action | What it does |
| - | - |
| **Flow Builder** | Open the builder to edit the form. |
| **View** | View the form details. |
| **Edit details** | Change the name, account, or categories. |
| **Mapping** | Save answers into contact records. See [Field mapping](#field-mapping). |
| **Submissions** | See who [submitted](#submissions) the form. |
| **Publish** | Publish the draft form. |
| **Deprecate** | Deprecate a published form. |
| **Duplicate** | Make a copy of the form. |
| **Delete** | Remove a draft form. |

## Form statuses

Every form shows a status so you know if it is ready to send.

| Status | It means |
| - | - |
| **Draft** | The form is not published yet. You can still edit it. |
| **Published** | The form is ready to use. |
| **Deprecated** | The form is no longer active, but its data is still available. |
| **Blocked** | Meta has blocked the form. |
| **Throttled** | Meta is temporarily limiting the form because of too many errors. |

## Field mapping

The answers people give in a form can go straight into your customer records. From the forms table `⋮` menu, choose **Mapping** to set it up.

For each field in the form, choose what to do with its answer:

* **Skip** — do not save it.
* **Contact field** — save it to a built-in contact field, like name or email.
* **Custom field** — save it to one of your [customer fields](https://docs.chatflows.io/core-setup/custom-fields.md).
* **Tag** — add a [customer tag](https://docs.chatflows.io/core-setup/labels.md) to the contact.

> [!WARNING]
>
> Set up mapping before you send the form. Answers only save to contacts once mapping is done — anything submitted before that is not added automatically.

## Sending a form

Once a form is published, there are two ways to send it to a customer.

* From a [contact's](https://docs.chatflows.io/contacts/managing-contacts.md#actions-on-a-single-contact) row, choose **Send flow**.
* In the [Inbox](https://docs.chatflows.io/messaging/live-chat.md), use the **Send form** button under the message box.

## Submissions

When a customer fills in the form and submits it, their answers are saved. A card with the answers also appears in the [Inbox](https://docs.chatflows.io/messaging/live-chat.md).

From the forms table `⋮` menu, choose **Submissions** to see everyone who filled it in — their name, phone number, status, and the date. Click a row to read all of their answers, or use **Export** to download the list as a CSV file.

![The flow submissions list showing each person's name, phone number, status and date, with an Export button](https://docs.chatflows.io/appointment-and-flow/img/whatsapp-flows/submission.png)

Image shows a flow's submissions list.

## What's next

> [card] [WhatsApp Flow step](https://docs.chatflows.io/automation/flow-steps/basic.md#whatsapp-flow)
>
> Add a form to an automation with the WhatsApp Flow step.

> [card] [Automation](https://docs.chatflows.io/automation/overview.md)
>
> Send a form automatically as part of a chatbot conversation.


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