What WhatsApp forms are
A WhatsApp form (Meta calls it WhatsApp Flows) is a questionnaire that opens right inside the chat. The customer taps a button under a message, fills in the fields on a WhatsApp screen and sends the answers. There is no need to go to a website, and the answers arrive in your chat with field labels.
What it is good for:
- Lead request: name, phone, what is needed, a convenient time for a call.
- Booking: a service from a list, a date, a comment.
- Questionnaire or survey: a few questions with answer options and consent to data processing.
The customer does not have to type a long message and guess what matters to you: you set the fields in advance, and they answer in a couple of taps.
Where it works
- Only on official WhatsApp lines: WhatsApp Business API and WhatsApp Cloud API. The line must be active.
- WhatsApp via QR, Telegram, Instagram, Messenger and other channels have no forms: this is a feature of official WhatsApp.
- Forms belong to a line. A form built on one line is not visible on another.
Where to find it
Dashboard → Templates section → Forms tab. If you have several official lines, pick the one you need in the Line field. If you have no official WhatsApp line, the tab will offer to connect one.
How to build a form
- Click New form.
- Enter a Name, for example "Measurement request". Only you and WhatsApp see it, the customer does not. Names cannot repeat on one line, up to 100 characters.
- Choose a Category: Leads, Sign-up, Booking, Contact us, Support, Survey, Sign-in or Other. WhatsApp requires a category for every form.
- Fill in the first step: the Screen title and the label of the Bottom button. On the last step this button sends the answers, on the others it leads to the next step.
- Click Add field and choose a type. Enter a label, tick Required if needed and add a Hint below the field. For choice fields, fill in the Options.
- If there are many questions, split them into steps with the Step button. Change the order of fields with Move up and Move down.
- The What the customer sees preview next to the builder shows roughly how the form will look.
- Click Save. The form is saved as a draft and sent to WhatsApp for checking right away.
Field types
| Type | What the customer sees |
|---|---|
| Heading, Text | Text on the screen: an explanation, terms, a greeting. Not included in the answers |
| Short answer | A field for a short answer, such as a name |
| Paragraph | A field for a long answer, such as a comment |
| Number, Email, Phone | A field for a number, an email address or a phone number |
| Single choice | A list of options, one can be chosen |
| Multiple choice | A list of options with checkboxes, several can be chosen |
| Dropdown | A dropdown list, handy when there are many options |
| Date | A date picker with a calendar |
| Consent | A checkbox with text, for example consent to personal data processing |
WhatsApp limits
- Up to 10 steps, up to 49 fields per step and no more than 5 Consent fields per step.
- Screen title up to 60 characters, bottom button label up to 35.
- Field label: up to 20 characters for Short answer, Paragraph, Number, Email, Phone and Dropdown, up to 30 for choice fields, up to 40 for Date, up to 120 for Consent. Heading up to 80 characters, Text up to 4096.
- Hint below the field up to 80 characters.
- Up to 20 options for Single choice and Multiple choice and up to 200 for Dropdown. Each option is up to 30 characters, and options cannot repeat.
- A form must have at least one field the customer fills in.
If a limit is exceeded, the dashboard highlights the field with the error before you save.
Checking before publishing
After saving, a Preview button appears on the form card: the official WhatsApp preview opens in a new tab and shows the form exactly as the customer will see it.
- If WhatsApp finds errors in the form, the card says "WhatsApp found errors: open the form", and the builder lists them. Fix them and save again.
- If WhatsApp did not respond, the draft is still saved in the dashboard. Click Save again a bit later.
- A draft without errors can be sent from a chat for testing, for example to your own number. In the chat form list it is marked "draft, for testing". Send customers the published form.
Publishing
Click Publish on the draft card. The button appears once WhatsApp has accepted the form without errors.
- WhatsApp allows publishing forms for companies with a verified business in Meta and good phone number quality. If this is not met, WhatsApp refuses, and the dashboard shows its response.
- A published form cannot be edited. To make changes, click Copy: a new draft with the same fields appears, which you can edit and publish.
| Status | What it means |
|---|---|
| Draft | The form can be edited, deleted and tested from a chat |
| Published | The form can be sent to customers. It cannot be edited, only copied |
| Retired | The form is retired and can no longer be sent |
| Limited | WhatsApp has limited the form to 10 sends per hour until its quality improves |
| Blocked | WhatsApp has blocked the form, customers cannot open it |
Retiring and deleting
- Retire stops a published form from being sent. Publishing cannot be restored. Customers who have already received the form can still send their answers.
- A published form cannot be deleted, this is a WhatsApp rule. Retire it first.
- A draft is deleted both in the dashboard and in WhatsApp. A retired form disappears from the dashboard list, while WhatsApp keeps retired forms forever.
- Forms built in WhatsApp Manager are shown at the bottom of the tab in a separate list, "Forms created in WhatsApp Manager". They can only be edited in WhatsApp Manager.
How to send a form to a customer
From a chat
In a chat on a WhatsApp Business API or WhatsApp Cloud API line, there is a Send a form button next to the message field. Pick a form, adjust the message text and the button label (up to 30 characters) and click Send. The button is visible while the 24-hour window after the customer's last message is open. Outside the window, send the form with a template button.
With a template button
Templates section → HSM (WABA) tab → Create. In the buttons block, choose the Form type and a published form. A template can have only one form button, and no other buttons can be added to it. The template goes through Meta review like any other. Such a template can be sent to a customer first, even if they have not written for a long time. Read more about templates in «Message templates».
As a menu bot step
The menu bot editor has a Form block. It appears in the block list when the line has published forms. Choose a form and the button label. The bot sends a message with a button, waits for the customer's answer and then continues along the flow. Read more in «Menu bots for WhatsApp».
Via API
From your own system, a form is sent with a POST /v1/messages/send request with interactive.type = "flow" on a WhatsApp Business API line. Fields and an example are in «Menus and buttons without a template via API».
Where to see the answers
The customer's answer arrives in the same chat as an incoming message, for example:
📋 Форма «Measurement request»
Name: Aigerim
Phone: +7 701 000 00 00
Service: Kitchen measurement
Date: 25.11.2026
- Labels are taken from the form, chosen options are shown by name, the date as DD.MM.YYYY, consent as «Да» (yes) or «Нет» (no). Empty fields are not shown. The service words of the answer («Форма», «Да», «Нет») are in Russian.
- This is a regular incoming customer message: it comes with a notification and goes wherever the line's other messages go, including a connected CRM and your API webhook.
- An answer to a form sent by a menu bot also appears in the chat as a regular message.
Limitations
- Only WhatsApp Business API and WhatsApp Cloud API lines. Sending via API works from WhatsApp Business API lines.
- From a chat and as a bot step, a form is sent only within the 24-hour window. To write first or outside the window, send a template with a form button.
- Publishing is available to companies with a verified business in Meta and good phone number quality.
- A published form cannot be edited or deleted: you can only copy it or retire it.
FAQ
Do I need a website or a developer?
No. The form is built in the dashboard from ready-made fields, and the answers arrive in the chat. The form does not need your own server.
Why is there no Publish button on the card?
WhatsApp has not accepted the form yet: the card shows a note about errors or that the form was not sent to WhatsApp. Open the form, fix what is highlighted and click Save.
WhatsApp refused to publish. What should I do?
Most often the company's business is not verified in Meta or the number quality is low. Complete business verification in Meta Business Suite and publish the form again.
How do I change a published form?
Click Copy, edit the new draft and publish it. You can retire the old form so nobody sends it by mistake.
Why is there no Send a form button in the chat?
The line is not official (for example, WhatsApp via QR) or the 24-hour window is closed. Outside the window, send a template with a form button.
The customer received the form but cannot open it
Check the form status on the Forms tab. If it is Blocked, WhatsApp has stopped it from opening: build a new form and publish it.
