Your agents
Notifications & alerts
Choose who is told when an agent qualifies a lead, puts a label or loses its number: by email, on WhatsApp or through a webhook, agent by agent.
WhatSetter tells your team about three things: a lead your agent qualified, a label your agent put on a lead, and an agent whose WhatsApp number disconnected. All three are set agent by agent, so each agent can alert different people.
Where notifications are set now
Section titled “Where notifications are set now”Open Agents, click your agent, open the Settings tab, then Hand-off & alerts. The section holds two blocks:
| Block | What it sends |
|---|---|
| When a lead is qualified | An email, a WhatsApp message or a webhook when the agent qualifies a lead, rules one out, or puts a label you chose. |
| If its number disconnects | An email when the agent’s WhatsApp number is down. |
In the old dashboard these settings were in the campaign panel, under Notifications, and on the WhatsApp page. Campaigns are now called agents: the settings follow each agent.
A group agent has no Hand-off & alerts section. No notification is sent when a meeting is booked: your calendar tool sends its own.
Choose which leads trigger a notification
Section titled “Choose which leads trigger a notification”Open Agents, click your agent, open the Settings tab, then Hand-off & alerts. Under Notify me when a lead is:, pick one of four choices:
| Choice | A notification leaves when |
|---|---|
| Qualified | Your agent qualifies the lead in the conversation. This is the default. |
| Not interested | Your agent rules the lead out. |
| Both | Either of the two. |
| Neither | Never for the qualification: only for the labels you chose, below. |
The choice applies to the email and the webhook. The WhatsApp message only exists for qualified leads: with Not interested selected, no WhatsApp message leaves.
A lead triggers each notification once. If the same lead is qualified a second time later, you are not told again.
Every change saves on its own: Saved shows at the top of the block.
Get an email when a lead is qualified
Section titled “Get an email when a lead is qualified”- Open Agents, click your agent, open the Settings tab, then Hand-off & alerts.
- Turn on Via email.
- Type an address and press Enter or the comma key. You can add up to 5 addresses.
- Under Notification language, choose Français, English, Español or Deutsch.
Each address receives one email per lead. It gives the lead’s name and phone number, the name of the agent, how the AI classified the lead and why, and a button that opens the conversation.
The language is the one of your dashboard on the day you turn the first channel on, until you choose another one. It applies to this agent only: to the email, the WhatsApp summary and the label messages.
Get a WhatsApp summary of each qualified lead
Section titled “Get a WhatsApp summary of each qualified lead”- Open Agents, click your agent, open the Settings tab, then Hand-off & alerts.
- Turn on On WhatsApp.
- Type the number that should receive the summaries, in international format: 8 to 15 digits, for example 447911123456. The field keeps the digits only.
For each qualified lead, that number receives one WhatsApp message written by the AI from the conversation: the lead’s name and number, its main interest, a summary in two or three sentences, up to four key answers and a suggested next step.
- The message leaves from the agent’s own number, so that number must be connected.
- It is written in the Notification language of the agent, or in French when none was chosen.
- It is sent once per lead, and for qualified leads only.
Send qualified leads to your tools with a webhook
Section titled “Send qualified leads to your tools with a webhook”- Open Agents, click your agent, open the Settings tab, then Hand-off & alerts.
- Turn on Via webhook (advanced).
- Paste a URL that starts with
http://orhttps://and press Enter. You can add up to 3 URLs. - To sign the calls, open Advanced (HMAC signature) and type a Signing secret, or click Generate.
Each lead that matches your choice triggers one POST request to every URL.
The JSON body carries event_type (contact.qualified or
contact.not_qualified), event_id, occurred_at, the agent under
campaign, and the lead under contact: name, phone, classification, the
AI’s reasoning and a link to the conversation.
With a secret, each call carries an X-Whatsetter-Signature header: sha256=
followed by the HMAC SHA-256 of the body. A call is tried once: if your
endpoint is down, that notification is lost.
To receive events for the whole workspace from your own code, see Webhooks.
Get a notification when the agent puts a label
Section titled “Get a notification when the agent puts a label”When the agent’s labels are on, you can be told each time the agent puts one of them on a lead. See Agent labels.
- Open Agents, click your agent, open the Settings tab, then Hand-off & alerts.
- Under And when the agent puts the label, click each label you want to hear about. A tick marks the chosen ones.
- Turn on at least one channel and give it a recipient: Via email, On WhatsApp or Via webhook (advanced).
Each label the agent puts leaves on every channel that is on:
- the email has the subject “Label” followed by the label’s name, with the lead, why the agent put it and a button that opens the conversation;
- the WhatsApp message leaves from the agent’s own number;
- each webhook URL receives
contact.label_added, signed like the other events. See Signed webhooks.
A message leaves only for a lead active in the last 24 hours: when you switch the labels on, the older conversations the agent reads once send nothing. While the agent’s labels are off, nothing leaves. A label put by a person sends nothing either.
Send a test notification
Section titled “Send a test notification”Open Agents, click your agent, open the Settings tab, then Hand-off & alerts, and click Send a test. The button works once a channel is on and has a recipient.
The test sends a qualified-lead notification for a made-up lead, Jean Dupont (test), +33612345678:
- the email arrives with a subject that starts with
[TEST]and a banner saying no real lead was qualified; - each webhook URL receives the usual body with
is_testset totrue; - the WhatsApp number receives a short confirmation, sent from the agent’s number.
Three limits to know:
- The test stands for a qualified lead. With Not interested selected, the email and the webhook receive nothing.
- The test does not send a label message.
- If the agent’s number is not connected, the WhatsApp part does not leave.
Is there a notification when a meeting is booked?
Section titled “Is there a notification when a meeting is booked?”No. When your agent books a meeting in the conversation, WhatSetter sends no email, no WhatsApp message and no webhook. The notifications of your calendar tool (Calendly, Cal.com or GoHighLevel) apply: that is where you receive the invitation.
In WhatSetter, the meeting shows on the lead. Open Leads and the view Meetings booked, or open the agent’s Summary tab and click Meetings. See Meetings.
If you want to be told about a lead as soon as your agent has qualified it, use the qualified-lead notification: it leaves whether a meeting is booked or not.
Get an email when the agent’s number disconnects
Section titled “Get an email when the agent’s number disconnects”Open Agents, click your agent, open the Settings tab, then Hand-off & alerts, and go to If its number disconnects. A green line confirms that alerts are on.
There is nothing to turn on. As long as no address is saved, the alert goes to the email of the account that owns the workspace.
- Under Email recipients, type an address and click Add. Repeat for each person.
- Under Notification language, choose Français, Español, English or Deutsch.
- Click Save alerts.
- Click Send me a test alert to receive a sample email at the saved addresses.
If you save with no address, your own email is saved as the recipient. The alert is an email only: no WhatsApp message is sent for a disconnection.
When a disconnect alert is sent, and how many
Section titled “When a disconnect alert is sent, and how many”An alert leaves when all of this is true:
- the agent is Active. A paused agent or a draft sends no alert;
- its number has been connected at least once and has been down for 30 minutes or more;
- you did not disconnect the number yourself from the dashboard;
- the number is still down when it is checked one last time, right before the email leaves.
You receive at most 3 emails per disconnection: after 30 minutes, then after 24 hours and after 48 hours. Then the alerts stop by themselves, until the number is connected again and drops another time.
One email lists all the disconnected agents a recipient is responsible for. It gives the time of the disconnection and, when it is known, the likely cause.
In the app, the agent shows Disconnected and the button Reconnect at the top of its page. See WhatsApp numbers.
The reconnect link of the email opens, once you are signed in, the WhatsApp numbers page with the window that reconnects that agent. If the agent is in another workspace than the one open, the window asks you to choose the agent.
Who can change notifications
Section titled “Who can change notifications”Changing the two blocks of Hand-off & alerts needs the Edit agents and their prompts permission. By default the Owner, Admin and Editor profiles have it. See Team.
Any member who can open the agent can click Send a test and Send me a test alert.
The lead notifications save on their own, field by field. The disconnect alerts are saved only when you click Save alerts: an address you typed without saving is not alerted.
Settings are per agent. When you create or duplicate an agent, open its Hand-off & alerts section and check both blocks.
Why a qualified-lead notification did not arrive
Section titled “Why a qualified-lead notification did not arrive”Open Agents, click your agent, open the Settings tab, then Hand-off & alerts, and check these points:
- The channel is off, or it has no recipient. An email needs at least one address, a webhook at least one URL.
- Notify me when a lead is: is set on the other case.
- The lead was already notified once: a lead triggers each notification one time only.
- For WhatsApp: the agent’s number was disconnected, or the lead was not qualified.
- For a webhook: your endpoint did not answer. The call is not tried again.
- The lead was qualified by a person, not by the agent: the notification follows the agent’s own decision in the conversation.
Click Send a test to check the channel itself, and look in your spam folder for the email.