> For the complete documentation index, see [llms.txt](https://help.3sigmacrm.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.3sigmacrm.com/features/ai-agents.md).

# AI Agents

Build AI agents that score leads, email leads, coach your team and turn chats into tasks

AI Agents do repeat work for you, day and night. An agent can score your leads, write a personal email for each lead, remind every teammate about missed follow-ups, or read new chats and create tasks from them.

Open it from the sidebar: **Marketing > AI Agents**.

{% hint style="info" %}
**Rolling out to select accounts.** If you don't see **AI Agents** in your sidebar, it is not turned on for your account yet. Contact our support team to ask about access.
{% endhint %}

{% hint style="info" %}
AI Agents are set up and managed on the web app only. They are not available in the mobile app.
{% endhint %}

***

## 📋 The AI agents page

The page has two tabs: **Agents** and **AI skills**.

At the top you see quick totals: **Agents on**, **Messages sent**, **Calls** and **Failed**.

Use the toolbar to find an agent:

* **Search agents** by name.
* Filter by type: **All**, **Calls**, **Email / WhatsApp**, **WhatsApp bot**, **Website chat**, **Lead scoring**, **Chats & emails**, **Assistants**.
* Filter by status: **All statuses**, **On**, **Draft**, **Archived**.

Each agent card shows:

* Its status: **On**, **Draft** or **Archived**.
* When it last ran (for example "Ran 2 hours ago", "Never run" or "Always on").
* Numbers for **Runs** (or **Calls**), **Sent** (or **Completed**), **Failed** and **Credits** used.
* Buttons to **Turn on** / **Pause**, **Edit**, **Make a copy** and **Delete**.
* **Run now** (or **Preview drafts** for email-draft agents) and **History**.

{% hint style="info" %}
**Pause** stops the agent's schedule and any automations that use it. Turn it on again any time.
{% endhint %}

***

## ➕ Creating an agent

Click **New agent**. You can pick one of three ways to start:

1. **Build with AI** – Describe the agent in chat. Review it, then turn it on.
2. **Start from blank** – Fill in each step yourself.
3. **Ready-made** – Start from a template (see below).

### Ready-made agents

| Template                           | What it does                                                                                                                                         |
| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Score my leads**                 | Ranks every lead Hot / Warm / Low from activity, your rules and optional web checks.                                                                 |
| **Win back quiet sign-ups**        | Emails people who signed up but never set anything up.                                                                                               |
| **Personal email to a lead**       | Writes a one-off email from an automation. You give the direction.                                                                                   |
| **Email my leads**                 | Pick leads (Facebook, a list, a status). It writes a personal email for each. Preview first.                                                         |
| **Sales Coach**                    | Each morning, tells every teammate the follow-ups they missed and the leads that need a fix.                                                         |
| **Turn chats & emails into tasks** | Reads new WhatsApp chats and emails. Makes call-back, quote and demo tasks with the right time, and suggests status changes for your team to accept. |

### Where it runs

In the first step, choose **Where it runs**. You can pick more than one. Each choice adds its own step to the form:

* **Phone calls**
* **WhatsApp**
* **Website chat**
* **Email / WhatsApp sends**
* **Lead scoring**
* **Help assistant**
* **Setup guide**
* **Read chats & emails**

Depending on your choices, the steps include **Who it is**, **Business questions**, **How it talks**, **How it ends**, **What it knows** (questions and answers, plus files it can read) and one step per channel.

{% hint style="info" %}
Use **Change with AI** on any step to describe a change in plain words. AI updates the agent for you to review.
{% endhint %}

***

## 📧 Email my leads

**Email my leads** writes a personal email for each lead you pick.

1. **Who should get it?** Pick at least one:
   * **From this list**
   * **From these sources** (for example Facebook)
   * **With this status**
   * **With this label** (for example HOT)
   * **Only leads added in the last (days)** – leave blank for any time
2. **What should the email say?** – for example, "Thank them for their interest and offer a free demo call this week."
3. Click **Write drafts**.

You read the drafts first. Nothing is sent. To send, add this agent to an automation.

***

## ✉️ Sending settings (Sends step)

Agents that send email or WhatsApp have a **Sends** step.

**What to write**

* **What is this message about?** – when it goes out and what the reader already knows.
* **Rules for the writer** – one rule per line (who it's from, what to offer, what to never say).
* **Sign off as** – a real first name, so every message is signed the same way.
* **Subject line** – leave blank and it is written for you.

**Send email from**

* **3sigma (shared)** – readers see a @3sigmacrm.com sender.
* **Gmail**, **Brevo** or **ZeptoMail** – readers see your own address. Connect the account in **Integrations** first, then pick the **Account** and **Sender**.
* **Replies go to** – the address that gets replies.

**Limits**

* **Most leads per run**
* **Don't email again for (days)**
* **Stop after (emails per lead)** – leave blank for no limit.

**Send slowly through the day (recommended)**

Scheduled emails go out one by one, a few minutes apart, so they don't look like spam. Set **Start sending at**, **Stop sending at** and **At least (minutes) apart**.

**When to send**

Turn on **Send on a schedule** and pick the time of day and time zone. When it is off, the agent only runs when you click **Run now**, or from an automation.

**Replies, testing & safety** (optional, for emails sent to a list of leads)

* **Reply alerts** – reads every reply, tags it (yes, question, not interested…), alerts the rep and creates a task for a yes or a question.
* **Send a second email when they say yes** – written only from the facts, price line, call to action and booking link you give.
* **Pause automatically on bounces or spam complaints** – if sending is paused, a banner shows in the Sends step with a **Resume sending** button.
* **A/B test two versions of the email** – each lead always gets the same version.
* **Let it search the web for facts** – opens the email with one real fact about the company. Costs a little extra per email.

***

## 🧑‍🏫 Sales Coach

The **Sales Coach** sends each teammate one message: the follow-ups they missed, and leads that need a fix. Each rep sees only their own.

* **Most items per person** – how long each message can be.
* **Items with no owner go to** – **Account owner** or **Nobody (skip them)**.

**Lead checks**

Every morning, the AI reads leads your team called or noted in the last 2 days and flags the ones that match a check.

* **Start from** – load your business's checks, or another industry's.
* **Edit these checks** – turn checks on or off, change the **Name** and **What to look for**, or **Add check**.
* **Test on last 2 days** – see what the checks would flag (save the agent first).

Lead checks use AI credits.

***

## 🔥 Lead scoring

A **Score my leads** agent ranks every lead **Hot**, **Warm** or **Low**. It never talks to anyone, so it only needs a name.

* **My rules** – give points for things that matter to your business.
* **Read what the lead said** – AI reads the lead's WhatsApp replies, call text, notes and form details to see if they want to buy. Leads with nothing written are skipped for free.
* **Company check (web search)** – the agent looks the lead's business up online. Off by default, as it costs one search per lead.

***

## 💬 Turn chats & emails into tasks

This agent reads new chats and creates tasks when your team promises something (for example, "I'll call you tomorrow, sir"). Pick **Which inboxes** it reads. Each chat it reads uses 2 AI credits.

***

## 📊 History and results

Click **History** (or **Calls**) on an agent card to see every run.

* Each run shows its result and what happened, including how many emails are still **waiting to send** and when the next one goes out.
* Email agents show a report: **Leads emailed**, **Opened**, **Clicked**, **Bounced** and **Not opened**, plus a per-lead table.
* Reply results show **Sent**, **Opened**, **Replied**, **Said yes**, **Asked a question**, **Not interested**, **Asked to stop** and more. Turn on **Reply alerts** in the agent settings so replies are tagged.
* Lead scoring runs show **Hot**, **Warm** and **Low** counts. Click a number to open those leads.
* Pick **7 days**, **30 days** or **90 days** to change the period.

***

## 🧩 AI skills

The **AI skills** tab lists the AI actions you can use on a lead, and the ones that **Run by itself**. Admins can click **New skill** to add their own, and add **Suggested** skills for their business.

***

## 💳 AI credits

AI agents use AI credits. Each agent card shows the **Credits** it has used, and the run history shows **Credits used** and **Credits left (all agents)**.
