Skip to content
Dashboard

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.

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.

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.

Where Campaigns, Prompts and the Playground are now

Section titled “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.

  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.

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.

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.

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.

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.

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 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.
Settings Its name, knowledge, style, number, sending, meetings, alerts, labels and integrations.
Test Play the lead in a simulated conversation. See Test your agent.
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.

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.

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

  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. You can also pause and resume an agent through the API.

How many agents can be active at the same time

Section titled “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.

Why you cannot activate or resume an agent

Section titled “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.

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, or see Plan & billing.

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

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.

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

Section titled “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.

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.

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.
Style How it writes. See My 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.
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.
Labels The labels the agent puts on its leads, on top of their stage. See Agent 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.

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

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.

  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.

  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.

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

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.

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.