# WhatsApp forms

> Send your Collect Leads and Collect Data forms inside WhatsApp chats from the inbox, automations and templates, and save every answer. For Indonesia.

A **WhatsApp form** puts your [Collect Leads](/ai-agent/collect-leads) form or a [Collect Data](/ai-agent/collect-data) action inside WhatsApp, built on Meta's WhatsApp Flows: the customer taps a button in the chat, fills in the fields and sends them without leaving the app, and Asks saves the answers like any other submission. Your AI agent sends a published form when the customer's request calls for it, your team sends forms from the [Inbox](/inbox), [automations](/automations) send them as a step, and a template with a **Form** button sends one outside the 24-hour window.

<Callout type="info">

**Availability** — WhatsApp forms are for workspaces in Indonesia, the same market rule as [Automations](/automations) and [Commerce](/commerce): a workspace created from Indonesia, or whose business-hours time zone is WIB, WITA or WIT. Asks switches the feature on; where it's on, Collect Leads and Collect Data show a **WhatsApp form** card. It has no plan requirement of its own, but the automation step needs Automations (paid plans). You need a connected [WhatsApp](/channels/whatsapp) number, and Meta lets only a verified business whose number has high message quality publish and send forms.

</Callout>

## Turn on a form

<Steps>

<Step title="Switch on the WhatsApp form">

Open [AI Agent → Collect Leads](https://app.asks.app/ai-agent/collect-leads), or a Collect Data action under [AI Agent → Collect Data](https://app.asks.app/ai-agent/collect-data), and switch on the **WhatsApp form** card. Collect Leads or the action must be switched on, and its **Channels** must include WhatsApp (or every channel). The lead form asks for name and email only, never the phone number: WhatsApp already shares it, so turn on **Name** or **Email**. It works in either collection mode.

<Frame src="/images/channels/whatsapp-forms-collect-leads.png" alt="Collect Leads page in the Aurelia workspace, scrolled to the WhatsApp form card with its switch on: Send these fields as a form inside WhatsApp chats; notes that your AI agent sends it in WhatsApp chats when the request calls for it instead of asking in text, that your team can send it from the inbox and automations as a step, that the form doesn't ask for a phone number because WhatsApp already shares it, and that saving publishes it to each connected WhatsApp number within a few seconds; under WhatsApp numbers with Publish now, +62 811-2345-6789 Aurelia WhatsApp marked Published, Version 1, Published Nov 18, 2026, with Preview" caption="The lead form, published on the workspace's WhatsApp number." />

</Step>

<Step title="Check how the fields will look">

Text, Email and Number fields become text inputs, **Yes / No** fields show as two options, and **Date** fields open a date picker. WhatsApp limits label length (20 characters for text inputs, 30 for Yes / No, 40 for dates): a longer label shows in full above its input. The card's **How the fields look in WhatsApp** lists what applies to yours. Up to five fields fit on one screen, with **Next** between screens; required fields are required in WhatsApp too, and a field's description shows under its input.

<Frame src="/images/channels/whatsapp-forms-collect-data.png" alt="Collect Data action editor in the Aurelia workspace, scrolled past Destinations and Channels (off: the action runs on every channel) to the WhatsApp form card with its switch on: Send this action's fields as a form inside WhatsApp chats; a note that your AI agent sends it in WhatsApp chats when the request calls for it, and your team and automations can send it too; How the fields look in WhatsApp lists Yes / No fields show as two options, Date fields open a date picker, and Long labels show in full above the input: “What would you like to improve?”; under WhatsApp numbers, +62 811-2345-6789 Aurelia WhatsApp marked Published, Version 1, Published Nov 18, 2026, with Preview and Publish now" caption="A Collect Data action's field notes and its status per number." />

</Step>

<Step title="Save to publish">

Save the page. Asks publishes the form to every connected WhatsApp number within a few seconds, and **WhatsApp numbers** shows each one's status. **Preview** opens Meta's preview of the form; **Publish now** (owners and admins) publishes it again. When you change the fields and save, Asks publishes a new version; forms already sent keep opening the version they were sent with, and their answers are still saved.

</Step>

</Steps>

The form's own words — its intro, **Next**, **Send**, **Yes** and **No** — are in Bahasa Indonesia in Indonesian workspaces (English otherwise). Your field labels and the action's name are used as you typed them; the lead form is titled "Data Anda" ("Your details" in English).

| Status | Meaning |
| --- | --- |
| **Published** | Customers can get the form from this number. **Version** counts the versions Asks has published. |
| **Publishing** | Asks is publishing it, which takes a few seconds. |
| **Not published** | Not on this number yet. |
| **Error** | Meta didn't accept it; the reason shows under the number. |
| **Retired** | The Collect Data action was deleted. |

## Send a form from the inbox

<Steps>

<Step title="Open the form picker">

In a WhatsApp conversation, click the form button (**Send a WhatsApp form**) in the composer, next to the template button. WhatsApp allows forms only within 24 hours of the customer's last message, so the button is disabled once that window closes; use a [template with a Form button](#outside-the-24-hour-window) instead.

</Step>

<Step title="Pick the form and send">

Choose **Lead form** or a Collect Data form; each shows how many fields it has. Add a **Message (optional)** or leave it empty to send the default message in the customer's language, then click **Send form**. A form that isn't published on this number yet is published as you send, which can take a few seconds. Any teammate can send forms.

<Frame src="/images/channels/whatsapp-forms-send-dialog.png" alt="Send a WhatsApp form dialog over a WhatsApp conversation in the inbox: The customer fills it in without leaving WhatsApp. Answers are saved to Leads or Collected data; Lead form with 2 fields and Skin consultation with 4 fields, Skin consultation selected; an empty Message (optional) field with the placeholder Tap the button below to fill in a short form and the hint Leave it empty to send the default message in the customer's language; Cancel and Send form" caption="Pick the form, and add a message if you want one." />

</Step>

<Step title="Follow it in the conversation">

The message shows the form's name with **Sent**, then **Submitted** once the customer sends it, and the button the customer taps (**Fill in form** by default). The answers arrive as a **Form submitted** card with your field labels.

<Frame src="/images/channels/whatsapp-forms-inbox.png" alt="Inbox conversation with Dewi Lestari on WhatsApp · Aurelia Skincare: the customer asks for a skincare routine for dry skin, an automation reply, then Sam's message Happy to help! Tell us a bit about your skin and we'll put a routine together, carrying the Skin consultation WhatsApp form with a Submitted chip and the button Fill in form; below it the customer's Form submitted · Skin consultation card with Skin type Dry, What would you like to improve? Flaky patches around my nose, Sensitive to fragrance? no, and Preferred consultation date 2026-11-25" caption="The form message turns Submitted, and the answers arrive with your labels." />

</Step>

</Steps>

## Send a form from an automation

In an [automation](/automations), add **Send WhatsApp form** and choose the form. **Message** (up to 1,024 characters, with variables) and **Button label** (up to 20 characters) fall back to defaults in the customer's language when empty. **Save the answers as** names the answers, so later steps can use each one as `{{vars.name.field}}` in messages, conditions and HTTP requests; the panel lists the variable of every field. **Wait for the form up to** sets how long the step waits.

The step has two paths, **Submitted** and **Not submitted in** the wait time. It sends on WhatsApp only, within 24 hours of the customer's last message; otherwise, or when the form isn't published on that number, the step is skipped and the run continues down **Not submitted**. Your AI agent keeps answering while the form is open, and the submitted form goes to the automation, so add a thank-you message on the **Submitted** path. In **Test**, any **Form answer** counts as submitted; leave it empty to test **Not submitted**.

<Frame src="/images/channels/whatsapp-forms-automation-step.png" alt="Automation editor for Skin consultation form, a Draft that is Ready to publish: the Conversation started trigger on all channels, then Send WhatsApp form with the paths Submitted (Tag conversation: consultation, then Add internal note with the skin type and main concern answers) and Not submitted in 1 day; the Send WhatsApp form panel shows the Skin consultation form, 4 fields, Ready, asking for Skin type, What would you like to improve?, Sensitive to fragrance? and Preferred consultation date, a Message with a first-name variable, and the Button label Start consultation (18/20)" caption="Branch on whether the customer submits the form." />

## Outside the 24-hour window

Send a template with a **Form** button. On the number's **Templates** tab under [Channels → WhatsApp](https://app.asks.app/channels/whatsapp), click **New template**, add a button of type **Form**, give it a label and choose the form it opens. Only forms published on that number's WhatsApp account are listed, a template has one Form button at most, and Authentication templates can't have one. Once Meta approves the template, send it from the inbox, with an automation's **Send WhatsApp template** step, or as a [WhatsApp campaign](/outbound). Each recipient gets their own form, so their answers are saved to them.

<Frame src="/images/channels/whatsapp-forms-template-button.png" alt="Template editor scrolled to its buttons: the sample value Dewi for {{1}}, a Form button labeled Start consultation that opens the Skin consultation form, with the hint that only forms published on this number's WhatsApp account are listed; the Preview shows Aurelia's WhatsApp message Hi Dewi, book your free skin consultation in under a minute with a Start consultation button; Let Meta change the category if their classifier disagrees is ticked, with Cancel and Submit for review" caption="A Form button opens one of your forms, even outside the 24-hour window." />

## How your AI agent uses it

Once a form is published on a number, your AI agent sends it in that number's chats instead of asking for those details in text:

- **Lead form** — when your Collect Leads **When to collect** condition is met and the customer's name or email is still missing, whichever collection mode you picked.
- **Collect Data form** — when the action's **When to use** condition is met.

The form arrives as its own message right after the agent's reply, which invites the customer to fill it in. The agent sends each form at most once per conversation, and never one your team or an automation already sent there. When the customer submits a form the agent sent, Asks posts your Collect Leads success message (or a standard thank-you line) instead of another AI reply. If the customer types the details in the chat instead, the agent saves them as usual.

## Where the answers go

A submitted WhatsApp form is saved like any Collect Leads or Collect Data submission:

- **Lead form** — [Customers → Leads](https://app.asks.app/customers/leads) with source **Form** and channel WhatsApp. The name and email update the customer [as other leads do](/ai-agent/collect-leads#where-leads-go); the phone comes from WhatsApp.
- **Collect Data form** — [Customers → Collected data](https://app.asks.app/customers/collected-data) and the customer's profile.
- Your **Destinations** emails, the `lead.captured` and `data.collected` [webhooks](/api/webhooks) (`source` `form`, `channel` `whatsapp`), and automations that start on **Lead captured**.

Yes / No answers are saved as `yes` or `no`, and dates as `YYYY-MM-DD`. If the customer submits the same form message twice, the second card says **Submitted again** and nothing is saved twice. Meta bills form messages like other WhatsApp messages: a service message inside the window, a template outside it ([pricing](/channels/whatsapp#how-messaging-works)).

## Troubleshooting

### A number shows Error

Read the reason under the number. Meta publishes forms only for a verified business whose number has high message quality: check your business verification in Meta Business Suite and the number's rating on its **Quality & Health** tab, then click **Publish now**.

### A template's answers aren't saved

Answers to a WhatsApp Flow made outside Asks, such as in WhatsApp Manager, show in the conversation but aren't saved to Leads or Collected data. Use a **Form** button bound to one of your Asks forms.

## Related

- [Collect Leads](/ai-agent/collect-leads) and [Collect Data](/ai-agent/collect-data) — the forms you send.
- [WhatsApp](/channels/whatsapp) — connect a number and create templates.
- [Automations](/automations) — every step and trigger.
- [WhatsApp campaigns](/outbound) — send a template to many customers.
