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

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

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

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

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

1. Open **Agents**, click your agent, open the **Settings** tab, then **Hand-off & alerts**.
2. Turn on **Via email**.
3. Type an address and press Enter or the comma key. You can add up to 5 addresses.
4. 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

1. Open **Agents**, click your agent, open the **Settings** tab, then **Hand-off & alerts**.
2. Turn on **On WhatsApp**.
3. 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

1. Open **Agents**, click your agent, open the **Settings** tab, then **Hand-off & alerts**.
2. Turn on **Via webhook (advanced)**.
3. Paste a URL that starts with `http://` or `https://` and press Enter. You can add up to 3 URLs.
4. 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](/developers/webhooks/).

## 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](/dashboard/labels/).

1. Open **Agents**, click your agent, open the **Settings** tab, then **Hand-off & alerts**.
2. Under **And when the agent puts the label**, click each label you want to hear about. A tick marks the chosen ones.
3. 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](/developers/webhooks/#contactlabel_added).

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

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_test` set to `true`;
- 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?

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](/dashboard/bookings/).

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

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.

1. Under **Email recipients**, type an address and click **Add**. Repeat for each person.
2. Under **Notification language**, choose Français, Español, English or Deutsch.
3. Click **Save alerts**.
4. 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

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](/dashboard/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

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](/dashboard/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

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.

## Related

- [Agents](/dashboard/agents/)
- [Meetings](/dashboard/bookings/)
- [WhatsApp numbers](/dashboard/numbers/)
- [Webhooks](/developers/webhooks/)
