Reach out
Forms
Paste your agent's address in your form tool: when someone leaves a phone number, the agent writes to them first on WhatsApp.
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
Section titled “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, where the person clicks and writes first, and lists, where you import the contacts.
Find and copy the address of an agent
Section titled “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.
Paste the address in your form tool
Section titled “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
Section titled “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.
- Open Forms and copy the address of the agent that should write to these people.
- In Zapier or Make, create a scenario that starts with each new contact from your ad form.
- 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
Section titled “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.
- Open Forms and click the agent’s line.
- Next to Address shared by mistake?, click Change address.
- Confirm with New address. Cancel changes nothing.
- 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
Section titled “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:
{ "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
Section titled “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
Section titled “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 and in 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 instead.
When the agent writes after a form, and what it writes
Section titled “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.
What each status on the Forms page means
Section titled “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
Section titled “Test a form”- Open Forms and check that the agent reads Ready.
- 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.
- Wait for the First message delay, 3 minutes at least.
- Look at WhatsApp on that phone: the first message of the agent arrives. In the app, the person appears in 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.
Why a form submission sends no message
Section titled “Why a form submission sends no message”Open Forms and check these causes in order:
- The agent is Paused or a Draft: forms are ignored until it is active.
- The form sent no phone number, or one that cannot be read. Send it with the country code.
- The number is not on WhatsApp: nothing is sent.
- 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.
- The message is on its way: it leaves after the First message delay, 3 minutes at least.
- The number of the agent is disconnected (status To check): the contact waits, and the message leaves after you reconnect.
- Your plan’s messages for the month are used up, or the account is suspended after a failed payment: see Subscription.
- 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
Section titled “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 describes what WhatSetter sends to your tools when something happens to a lead. API: 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
Section titled “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.