Skip to content
Dashboard

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.

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.

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.

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.

  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

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.

  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.

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.

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.

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.

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.

  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.

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.

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

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.

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.