# Forms

> Paste your agent's address in your form tool: when someone leaves a phone number, the agent writes to them first on WhatsApp.

Source: https://docs.whatsetter.com/dashboard/forms/

Someone leaves a phone number in one of your forms, and your agent writes to
them first on WhatsApp. The **Forms** page gives each agent's address: you
paste it once in your form tool.

## What the Forms page is for

Open **Forms** in the menu, under **Reach out**. Someone fills in a form of
yours, on your website, a sales page or an advert, and leaves a phone number.
After a short delay, 3 minutes by default, your agent writes to that person
first on WhatsApp. The person has nothing to click.

It works with an address. Every agent has one. You paste it once in your form
tool, and each new answer the tool receives is passed on to the agent. This
address used to be called the webhook URL.

Nothing is created on this page: it lists your agents, says which ones are
ready, and lets you copy their address.

It is one of three ways a contact reaches an agent, with
[links](/dashboard/tracked-links/), where the person clicks and writes first,
and [lists](/dashboard/lists/), where you import the contacts.

## Find and copy the address of an agent

Open **Forms**. Under **Each agent’s address**, each agent is one line with a
**Copy the address** button.

Click a line to open it. The full address appears under
**Address to paste in your form tool**, with a **Copy** button, the
**First message delay** and a link to **See the first message**.

The address is on your dashboard's domain and ends with `/f/` followed by a
code of its own, for example `https://app.whatsetter.com/f/k3x9…`. That code
is what keeps it private: only paste it in your form tool.

There is one address per agent: whatever reaches this address is for that
agent. An agent has its address from the day it is created. Agents that are
not active yet sit under **Drafts**: they already have their address, but
write to nobody until they are active. Agents that follow groups are not
listed.

If the page says "Create an agent first", see
[Create your AI agent](/getting-started/agent/).

## Paste the address in your form tool

In your form tool, look for the word "webhook": that is where the address
goes. The tool must send each answer to the address with the POST method.
The **Forms** page lists where to paste it, under
**Where to paste the address**:

| Tool | Where the address goes |
|---|---|
| Typeform | Connect, then Webhooks, then "Add a webhook". |
| Tally | Integrations, then Webhooks. |
| Systeme.io | Form, Settings, then "Webhook URL". |
| HubSpot | Form, Integrations, then "Add a webhook". |
| Zapier or Make | Add a "Webhook" action that sends a POST to the address. Use it for the lead forms of your social media adverts. |

Paste the address of the agent that should write to these people. One form
sends to one agent. An answer over 1 MB is refused, and an address that
receives more than 60 answers in one minute refuses the next ones for a short
while.

## Get the contacts from your Facebook and Instagram ads

Facebook and Instagram ad forms (Lead Ads) have no webhook field: they go through Zapier or Make. Your agent then writes first to everyone who leaves their number.

1. Open **Forms** and copy the address of the agent that should write to these people.
2. In Zapier or Make, create a scenario that starts with each new contact from your ad form.
3. Add a "Webhook" action that sends a POST to your agent's address, with the phone number and the first name.

## Change an agent's address shared by mistake

If an agent's address went somewhere it should not, change it: the new one
replaces the old one.

1. Open **Forms** and click the agent's line.
2. Next to **Address shared by mistake?**, click **Change address**.
3. Confirm with **New address**. **Cancel** changes nothing.
4. Copy the new address and paste it in your form tool, in place of the old one.

The old address stops working at once: forms that still use it no longer
arrive. You need the **Connect tools (calendar, links, Instagram)** right.

## Which fields your form must send

No format is imposed: your fields keep their names. WhatSetter reads the
answers and finds what it needs. The **Forms** page sums it up under
**What your form sends**:

| Field | Needed? | What it is for |
|---|---|---|
| The phone number | Required | The number the agent writes to. |
| The first name | Recommended | The agent greets the person by first name. |
| All the other answers | Optional | Email, need, budget: the agent reads them and uses them in its first message. |

Example of what a tool sends:

```json
{
  "first name": "Camille",
  "phone": "+44 7700 900123",
  "need": "Redo my kitchen"
}
```

Without a phone number the agent cannot write, and nothing is created.

## Which phone format to send

Send the phone number with its country code: `+44 7700 900123` or
`0044 7700 900123`. A number that starts with `+` or `00` is used as written.
This is the safest format. Spaces, dots, dashes and brackets do not matter.

A number sent without a country code is guessed from its shape, and the guess
can be wrong:

- 10 digits starting with 0 are read as a French number;
- 11 digits starting with 0 are read as a British number;
- 10 digits not starting with 0 are read as a number from the United States or Canada.

Other local formats may be read in the wrong country, and the message then
goes nowhere. When your form is used in one country, make the phone field ask
for the country code, or add it in your tool before sending.

## Which agent receives the contact

The agent whose address received the form. There is no list to choose and
nothing to assign: one address belongs to one agent, and that agent writes
from its own WhatsApp number, with its own first message.

- To send two forms to two different agents, paste a different address in each form.
- To send several forms to the same agent, paste the same address in all of them.
- A contact that arrives through a form does not appear in **Lists**. Once the agent has written, the person is in [Conversations](/dashboard/conversations/) and in [Leads](/dashboard/leads/), like any other lead.

A form is answered one person at a time, after the delay set on the agent. To
choose the pace, the days and the hours yourself, import the contacts as a
[list](/dashboard/lists/) instead.

## When the agent writes after a form, and what it writes

Open **Forms** and click the line of an agent. **First message delay** is the
time between the form and the first message of the agent. It is 3 minutes at
least. Click **Edit** to change it: you land in the **Settings** tab of the
agent, section **Sending**, where the choices are 3, 10 or 30 minutes, or 1,
2, 4, 8 or 24 hours.

**What the agent writes** is its first message, written for each person from
the prompt of the agent and from the answers of the form. Click
**See the first message** to read or change it in the **Prompt** tab of the
agent, under **First message**.

The message can leave a little later than the delay when the number wrote to
someone else a moment before: first messages are spaced out to protect the
number. See [How we protect your number](/dashboard/anti-ban/).

## What each status on the Forms page means

Open **Forms**. The top line counts the agents ready to receive your forms,
and each agent has a status:

| Status | Meaning |
|---|---|
| **Ready** | The agent is active and its number works. Its line says after how long it writes. |
| **To check** | The agent is active, but its number is disconnected, waiting to be reconnected, or missing. Open the line and click **Reconnect** or **Connect a number**: the **WhatsApp numbers** page opens, with this agent's connection window for **Reconnect**. |
| **Paused** | A form received triggers no message. Click **Open the agent** to resume it. |
| **Draft** | The agent is not active yet: a form received triggers no message. |

Forms received while an agent is paused or a draft are not kept: nobody is
written to later. A form received while the number of an active agent is
disconnected waits, and the first message leaves after you reconnect.

## Test a form

1. Open **Forms** and check that the agent reads **Ready**.
2. Fill in your own form, as a visitor would, with a WhatsApp number that this agent has never written to. Write the number with its country code.
3. Wait for the **First message delay**, 3 minutes at least.
4. Look at WhatsApp on that phone: the first message of the agent arrives. In the app, the person appears in [Conversations](/dashboard/conversations/).

Use a new number for each test. The **Forms** page states the rule: "A person
this agent already contacted does not get a second first message." A second
test with the same number is therefore not a valid test.

To read what the agent would write without sending anything, use the **Test**
tab of the agent: see [Test your agent](/dashboard/playground/).

## Why a form submission sends no message

Open **Forms** and check these causes in order:

1. The agent is **Paused** or a **Draft**: forms are ignored until it is active.
2. The form sent no phone number, or one that cannot be read. Send it with the country code.
3. The number is not on WhatsApp: nothing is sent.
4. This agent already wrote to that person. The page states the rule: "A person this agent already contacted does not get a second first message." It is the usual cause when you test twice with the same number.
5. The message is on its way: it leaves after the **First message delay**, 3 minutes at least.
6. The number of the agent is disconnected (status **To check**): the contact waits, and the message leaves after you reconnect.
7. Your plan's messages for the month are used up, or the account is suspended after a failed payment: see [Subscription](/dashboard/billing/).
8. The address in your form tool is not the one shown on the **Forms** page, for example because it was changed with **Change address**, or the tool does not send with the POST method.

## Send your leads to another tool, the opposite direction

The **Forms** page receives contacts. To do the opposite and send your
qualified leads to your CRM or another tool, use the link
**Open API and MCP** at the bottom of the page: it opens that part of
**Settings**.

For developers, two pages go further.
[Signed webhooks](/developers/webhooks/) describes what WhatSetter sends to
your tools when something happens to a lead.
[API: campaigns](/developers/guides/campaigns/) shows how to hand a contact to
an agent from your own code, instead of a form tool.

## Who can open the Forms page

The **Forms** entry of the menu and its page show only for people who have
the right **Connect tools (calendar, links, Instagram)**. **Owner** and
**Admin** have it. The other roles do not, unless you give them that right in
a **Custom** role.

Copying an address needs nothing more. Changing the delay or the first
message happens in the agent, and needs the right to edit agents.

Roles and rights are set in [Team](/dashboard/team/).

## Related

- [Tracked links](/dashboard/tracked-links/)
- [Lists & import](/dashboard/lists/)
- [Your agent's prompt](/dashboard/prompt/)
- [API: campaigns](/developers/guides/campaigns/)
