# Agents

> Find every agent in one list, read its status, switch it on, pause, duplicate or delete it, and open its page with its six tabs.

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

An agent is the AI that talks with your contacts on WhatsApp. Campaigns are
now called Agents: what used to be split between Campaigns, Prompts and the
Playground now lives on the agent's own page.

## What an agent is

Open **Agents** in the menu. Each line of the page is one agent, and an agent
owns everything it needs to work:

- what it says: its instructions, its first message and its follow-ups;
- what it knows: the knowledge it reads before answering;
- the WhatsApp number it writes from;
- its tests, its activity and its results.

An agent answers either in private messages or in your WhatsApp groups. This
page covers the agents that answer private messages. Group agents have their
own list: when you have some, **See group agents** opens it from the bottom of
the page. See [WhatsApp groups](/dashboard/groups/).

## Where Campaigns, Prompts and the Playground are now

The menu has no Campaigns, Prompts or Playground page any more. What they did
is now on the page of each agent, in **Agents**.

| Before | Now |
|---|---|
| Campaigns | **Agents**: each campaign is now an agent. |
| Prompts | The **Prompt** tab of an agent. |
| Playground | The **Test** tab of an agent. |

Old links still work: a bookmark to Campaigns, Prompts or the Playground opens
the **Agents** list, or the agent itself on the matching tab. In the search
window (Ctrl+K), typing "campaigns", "prompts" or "playground" finds them too.

## Create an agent

1. Open **Agents**.
2. Click **New agent**. If you have no agent yet, the button reads **Create an agent**.
3. Answer the questions of the creation window. They are described in [Create your AI agent](/getting-started/agent/).

A new agent starts as a draft: it sends nothing and does not count in your
plan.

Creating an agent requires the **Create an agent** permission. Without it, the
window **Permission required** tells you to ask the team owner.

You can keep agents in preparation, but not without limit. The total number of
agents, whatever their status, cannot exceed the active agents of your plan
plus 5 on the free plan, 30 on Starter, 60 on Business and 200 on Scale. Past
that, **New agent** opens the window **A lot of agents in preparation**, which
asks you to delete the ones you no longer need. If all the active agents of
your plan are taken as well, the window reads
**All your agents are already working**.

## Instagram and Messenger agents

After **New agent**, the first question is **Where does your agent work?**:
**WhatsApp**, **Instagram**, **Messenger**, one or several. An agent answers
either on WhatsApp, or on Instagram and Messenger: with both ticked, the same
answers make two agents, one on each tab of **Agents**.
With Instagram or Messenger, the recap adds **Its missions**, each with its
switch: an automation that answers a keyword under your next posts (created
switched off, for you to read first), **Answer every private message**, and
**Messenger** once your Facebook Page is linked. Under **Works on**, pick a
connected account or **An account to connect**: the agent then shows
**Waiting for its account**, and the next Instagram account you connect takes
it with its missions.

These agents are listed in **Agents**, on the **Instagram** tab, one per
connected account, with no number to link. Their **Prompt**, **Test** and
**Settings** tabs work as for a WhatsApp agent, and **Settings** has an
**Instagram** section. To switch one on, give it a first name, click
**Activate** and choose who answers on the account. The same agent answers in
Messenger on the Facebook Page linked to the account. See
[Instagram and Messenger](/dashboard/instagram/).

## Read the Agents list

Open **Agents**. The line at the top counts your agents and how many are
active against what your plan allows, for example "5 agents · 2 active out of
3". Below, the agents are grouped by what they need from you:

| Section | Which agents it holds |
|---|---|
| **To check** | Active agents that something keeps from answering normally: a number to connect or reconnect, or a limit set by WhatsApp. |
| **In service** | Active agents that work. |
| **Paused** | Agents you paused. They do not answer or send anything until you resume them. |
| **Drafts** | Agents that are not switched on yet. They do not count in your plan. |

**Drafts** is folded while other agents exist: click **Show drafts** to open
it. Agents are sorted by name, drafts by most recent change.

With more than one agent, a search field appears. It finds an agent by its
name in your list, its first name or its number.

## What a row of the list shows

Open **Agents**. Each row shows, from left to right:

- the picture of the agent's WhatsApp number, or its initials until a number is linked;
- its name in your list, and its first name when the two differ;
- one sentence that says what the agent does or what stops it, for example "Answers on WhatsApp" followed by its number;
- one status badge;
- at most one button: the next thing to do.

| Button | What it does |
|---|---|
| **Connect** | Opens the agent with the window that links a WhatsApp number. |
| **Reconnect** | Opens the same window, for a number that dropped. |
| **Activate** | Switches a draft on. |
| **Resume** | Switches a paused agent back on. |
| **See the limits** | Opens the **Activity** tab, which shows the limits WhatsApp puts on the number. |

Click anywhere else on the row to open the agent. An active agent that works
has no button: pausing is done from the agent's own page.

## What each status badge means

Each row of the **Agents** list carries one badge.

| Badge | Meaning |
|---|---|
| **Active** | The agent is switched on and its number is connected: it answers and sends. |
| **Connecting** | The agent is switched on and its number is connecting to WhatsApp. Nothing to do. |
| **Disconnected** | The agent is switched on but its number dropped. Nothing is sent until you reconnect it. |
| **To connect** | The agent is switched on but has no number, or its number waits for a new QR code scan. |
| **Sending limited** | WhatsApp blocks new contacts on this number for a while. The agent still answers people who write to it. |
| **Cap reached** | The number used all the messages WhatsApp allows it for the current cycle. |
| **Paused** | You paused the agent. |
| **Draft** | The agent is not switched on yet. The sentence beside the badge says what is missing. |

On the agent's own page, the top shows two badges instead of one: the state of
the number (**Connected**, **Connecting**, **QR code to scan**,
**Disconnected** or **No number**) and the state of the agent (**Active**,
**Paused** or **Draft**).

## Open an agent: its page and its tabs

Open **Agents** and click an agent. The top of its page stays the same on
every tab: the agent's name, **Private messages** or **Groups**, its number
and its two badges. On the right: **Test**, the action that matters now
(**Connect a number**, **Reconnect**, **Activate**, **Resume** or **Pause**)
and **More actions**.

| Tab | What it is for |
|---|---|
| **Summary** | What is left before the agent works, where its leads stand, its latest conversations. |
| **Prompt** | What the agent says: first message, conversation, follow-ups. See [Your agent's prompt](/dashboard/prompt/). |
| **Settings** | Its name, knowledge, style, number, sending, meetings, alerts, labels and integrations. |
| **Test** | Play the lead in a simulated conversation. See [Test your agent](/dashboard/playground/). |
| **Activity** | Conversations to pick up, today's sending, first contacts day by day, the state of its number. |
| **Results** | New contacts, newly qualified leads and first meetings over a period. |

## Check what an agent still needs to work

Open **Agents**, click your agent and stay on **Summary**. The first block
reads **Ready: this agent is working**, or counts what is missing, for example
**2 things left before it works**. It lists:

| Line | What it checks |
|---|---|
| **A WhatsApp number** | A number is connected. If not, the button on the line connects or reconnects one. |
| **What it knows** | The agent has knowledge to answer from. Without it, it answers from its instructions only. **Add** opens its knowledge. |
| **Its link** | Shown only when the agent has to send a link and has none. Until you add it, the agent says someone from the team will come back to the person. |
| **Switched on** | The agent is active. |

Below, **Its leads** gives four numbers: **Leads** (since it started),
**Not contacted yet** (their first message never left), **Qualified** (no
meeting yet) and **Meetings** (on the calendar). Click a number to open those
leads. **Latest conversations** lists the last five.

## Switch an agent on

A WhatsApp agent needs a connected WhatsApp number before it can be switched
on. An Instagram or Messenger agent has no number: it needs a first name, then
**Activate** on its page asks who answers on its Instagram account.

1. Open **Agents** and click your agent.
2. If the button at the top reads **Connect a number**, click it and link the number in the window that opens. See [Connect your WhatsApp](/getting-started/connect-whatsapp/).
3. Click **Activate**. The window that links the number also offers to activate the agent once the number is connected.

From the list, a draft whose number is connected reads "Number connected. You
can activate this agent.": click **Activate** on its row.

Once active, the agent answers the people who write to it, sends its first
message to the contacts of its lists and follows up. It then counts in the
active agents of your plan. Right after a number is connected, the window says
so: first messages to new contacts go out 30 minutes later, replies go out
right away.

Switching an agent on, pausing it or resuming it requires the
**Edit agents and their prompts** permission.

## Pause and resume an agent

1. Open **Agents** and click the agent.
2. Click **Pause** at the top of its page. The agent moves to the **Paused** section of the list.
3. To switch it back on, click **Resume**, on its page or on its row in the list.

A paused agent does not answer and sends nothing until you resume it. Its
number stays connected, so there is no QR code to scan again, and the place it
held in your plan is free for another agent.

The messages people send while it is paused are kept: they appear in
**Conversations**, so you can answer by hand. Once you resume the agent, it
answers a person the next time they write, with what they said during the
pause in mind. It never writes first to the people who wrote during the pause,
and sends them no follow-up while their last message has no answer.

**Pause** is the button at the top only while the agent works normally. When
its number needs you, the button reads **Reconnect** or **Connect a number**
instead.

When a list is shared between several agents, the contacts of a paused agent
go to the agents that can write. See [Lists & import](/dashboard/lists/). You
can also pause and resume an agent
[through the API](/developers/guides/campaigns/).

## How many agents can be active at the same time

Your plan sets how many agents can be active at once. Agents that answer
private messages and group agents share the same count.

| Plan | Active agents |
|---|---|
| Starter | 1 |
| Business | 3 |
| Scale | 10 |

Drafts and paused agents do not count. The count is shown at the top of the
**Agents** list, for example "2 active out of 3", and next to **Agents** in
the menu, in the form 2/3.

The free plan shows 1 as well. On the free plan you build your agent and test
it as far as your credits go. A paid plan connects it to your number, and an
agent needs a number to be switched on.

On Scale, write to us to add agents to your plan. See
[Plan & billing](/dashboard/billing/).

## Why you cannot activate or resume an agent

Open **Agents** and read the row of the agent: it names the reason.

- The row says that your plan is full, for example "Your plan is full: pause an agent to resume this one." All the active agents of your plan are taken, and the **Activate** or **Resume** button of the row is greyed out. Pause another agent, or change plan from **Subscription**.
- The button reads **Connect**: the agent has no WhatsApp number yet. Connect one first.
- The button reads **Reconnect**: its number dropped. Reconnect it first.
- The click is refused: your role does not have the **Edit agents and their prompts** permission. Ask an admin of your team.

If you click **Activate** on the agent's own page while your plan is full, the
activation is refused and a message says that the limit of active agents is
reached.

## Why an agent does not answer

Open **Agents** and read the badge on the agent's row. Each state has its own
reason and its own fix.

| Badge | Why the agent stays silent | What to do |
|---|---|---|
| **Draft** | It is not switched on yet. | Connect a number if it has none, then click **Activate**. |
| **Paused** | You paused it. | Click **Resume**. |
| **Disconnected** | Its number dropped. | Click **Reconnect**. |
| **To connect** | It has no number, or its number waits for a new scan. | Click the button on its row. |
| **Active** | With one lead: the agent ended the conversation, because it handed the lead to you or judged it not qualified. With everyone: the messages of your plan are used up for the month. | Open the lead in [Conversations](/dashboard/conversations/), or see [Plan & billing](/dashboard/billing/). |

**Sending limited** does not stop replies: it blocks first messages to new
contacts only.

## Why an agent shows Disconnected

**Disconnected** means a WhatsApp number is linked to the agent but its
connection to WhatsApp dropped. Until you reconnect it, the agent does not
answer and sends nothing.

The agent stays **Active**: it moves to the **To check** section of the list
and works again as soon as the number is back. Nothing has to be activated
again.

1. Open **Agents**. The agent is under **To check**, with the sentence "Its WhatsApp number is disconnected."
2. Click **Reconnect** on its row, or at the top of its page.
3. Follow the window that opens. See [WhatsApp numbers](/dashboard/numbers/).

Reconnecting requires the **Reconnect a number (QR code)** permission. To be
warned by e-mail when a number drops, open the agent's **Settings**, then
**Hand-off & alerts**.

## What No number, To connect and QR code to scan mean

These states describe the agent's WhatsApp number. They are shown at the top
of the agent's page and in the **Agents** list.

| What you read | Meaning | What to do |
|---|---|---|
| **No number** | No number is linked to the agent: none was ever connected, the connection window was closed before the scan, or its number was given to another agent. | Click **Connect a number**. |
| **QR code to scan** | WhatsApp logged the number out. | Click **Reconnect** and scan the new code. |
| **Connecting** | The number is connecting. | Wait. |
| **To connect** | In the list, an active agent in one of the first two cases. | Click the button on its row. |

A draft without a number is not a breakdown: its row says "Add a WhatsApp
number to start." One number serves one private-message agent. Linking a
number that another agent uses takes it away from that agent. The steps are in
[WhatsApp numbers](/dashboard/numbers/).

## What Sending limited and Cap reached mean

These two badges come from WhatsApp, not from your plan. The agent stays
active and moves to the **To check** section.

- **Sending limited**: WhatsApp blocks first messages to new contacts on this number, often until a date shown on the row. The agent still answers the people who write to it.
- **Cap reached**: the number used all the messages WhatsApp gives it for the current cycle. The row says how many were used out of the total.

Click **See the limits** on the row to open the **Activity** tab. Its
**WhatsApp number** block shows **Messages this cycle**, when the next cycle
starts and when the state was last checked. It is updated every 15 minutes.

How a number stays healthy is explained in
[How we protect your number](/dashboard/anti-ban/).

## Change an agent's name and settings

Open **Agents**, click the agent, then the **Settings** tab. Its menu has one
entry per subject:

| Entry | What you set there |
|---|---|
| **Name** | **Agent’s first name**, the one it uses with your leads, and **Name in your list**, which only your team sees. Click **Save**. |
| **Knowledge** | What it reads before answering. See [Knowledge bases](/dashboard/knowledge-base/). |
| **Style** | How it writes. See [My Styles](/dashboard/styles/). |
| **Number** | The WhatsApp number it writes from: **Connect a number**, **Reconnect** or **Change number**. |
| **Sending** | **Split long replies** (and, when it is on, **Messages per reply**: up to 3 or up to 2), **First message delay**, **Follow-up time zone** and **Follow-ups on Sundays**. Each change applies right away. |
| **Meetings** | The calendar it books in and its **Booking link**. See [Meetings](/dashboard/bookings/). |
| **Hand-off & alerts** | Who is told when a lead is qualified, when the agent puts a label you chose, and when the number disconnects. See [Notifications & alerts](/dashboard/notifications/). |
| **Labels** | The labels the agent puts on its leads, on top of their stage. See [Agent labels](/dashboard/labels/). |
| **Integrations** | The links and forms that bring it leads, and the tools it sends its leads to. |

A group agent has **Name**, **Knowledge** and **Number** only. The tab
requires the **Edit agents and their prompts** permission.

## Follow what an agent is doing

Open **Agents**, click the agent, then the **Activity** tab.

- **To pick up**: how many of its leads have not been contacted yet (their first message never left), and how many are to handle: a lead wrote and nobody answered, or an action is overdue. Click a number to open those leads.
- **Sending today**: one line per list the agent sends, with today's count against the quota of the day, the days and hours of sending, and the total sent. See [Lists & import](/dashboard/lists/).
- **First contacts**: the leads whose first contact happened each day, over 14, 30 or 90 days.
- **Recent conversations**: the last five.
- **WhatsApp number**: the number, its state and the limits WhatsApp reports on it.

If the number is disconnected, a notice at the top says so and offers
**Reconnect the number**.

## Read an agent's results

Open **Agents**, click the agent, then the **Results** tab, and choose a
period. The tab shows the three counts of the **Overview** page, for this
agent only:

- **New contacts**: leads whose first contact happened in the period, whoever wrote first.
- **Newly qualified**: leads the AI qualified during the period, even if they were contacted earlier.
- **First meetings**: each lead counts once, on the day its first meeting was booked. Only meetings booked through a connected calendar are counted.

Below, a block shows what became of the new contacts of the period. When an
A/B test runs on the agent, a line points to it with **See the test**. With
several agents, **Compare with your other agents** opens
[Analytics](/dashboard/analytics/).

## Duplicate an agent

1. Open **Agents** and click the agent to copy.
2. Click **More actions**, the button with three dots at the top right.
3. Click **Duplicate agent**. The copy opens.

The copy is a draft without a WhatsApp number, and its counters start at zero.
It keeps the agent's texts and what is saved on the agent itself: its names,
its language, its knowledge and its follow-ups. Its name ends with "(copie)":
rename it in **Settings**.

The copy does not take the number, the calendar that books meetings, the alert
sent when a lead is qualified or the version history of the texts. Set the
calendar and the alert again on the copy.

Duplicating requires the **Create an agent** permission. It is refused when
you already keep the maximum number of agents.

## Delete an agent

1. Open **Agents** and click the agent.
2. Click **More actions**, then **Delete agent**.
3. Confirm in the window that asks, for example, **Delete Julia?**

Deleting an agent also disconnects its WhatsApp session. Its conversations
stay in your leads. The agent itself cannot be brought back.

> **Pause it if you only want it to stop**
A paused agent sends nothing and keeps its texts, its number and its history.

Deleting requires the **Delete an agent** permission, which the **Owner** and
**Admin** roles have by default.

## Who can do what on agents

Each action checks a permission of the member, on the server.

| Permission | What it allows |
|---|---|
| **See the agents** | Open the list and an agent's page, and test the agent. |
| **Create an agent** | **New agent** and **Duplicate agent**. |
| **Edit agents and their prompts** | The **Prompt** and **Settings** tabs, **Activate**, **Pause** and **Resume**. |
| **Delete an agent** | **Delete agent**. |
| **Reconnect a number (QR code)** | **Connect a number** and **Reconnect**. |

The figures of the **Results** tab also need **See analytics**.

By default, **Owner** and **Admin** have all of them. **Editor** has all but
**Delete an agent**. **Viewer** has **See the agents** and **See analytics**.
**Responder** has none of them. See [Team & roles](/dashboard/team/).

## Agents in the public API

In the public API, an agent is still called a campaign. The `campaign_id` of a
lead or of a conversation is the identifier of its agent.

- `GET /campaigns` lists your agents, with their status and whether their number is connected.
- `POST /campaigns/{id}/pause` and `POST /campaigns/{id}/resume` pause and resume an agent. Resuming checks the active agents of your plan, as the dashboard does.
- `POST /campaigns/{id}/leads` hands a contact to an agent, which writes to it first.

See [API: campaigns](/developers/guides/campaigns/).

## Related

- [Create your AI agent](/getting-started/agent/)
- [Your agent's prompt](/dashboard/prompt/)
- [Test your agent](/dashboard/playground/)
- [WhatsApp numbers](/dashboard/numbers/)
