> ## Documentation Index
> Fetch the complete documentation index at: https://agent-docs.magicwebs.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Leads pipeline

> See every conversation filed at the stage it has reached, move leads by hand, and set up the stages and tags the follow-up desk uses.

Every conversation becomes a lead. About an hour after a conversation goes quiet, the **follow-up desk** reads it, files it at the stage that fits, applies tags, and sends at most two polite nudges while the stage is still open.

Open the pipeline from **Leads → Stages**.

![The leads board with leads filed at New enquiry, Qualified, Site visit booked and more](https://mintcdn.com/magicwebs/lXS3DuVdQz1WpiFT/images/console/leads.png?fit=max\&auto=format\&n=lXS3DuVdQz1WpiFT\&q=85\&s=c55ae4d08fa151618b5b0bd08e0acb82)

## Read the board

* **Stage chips** across the top show how many leads are at each stage. **Not yet reviewed** holds conversations the desk hasn't read yet.
* Switch between **Kanban**, **Cards** and **List** views.
* Filter by search, channel, status, time and tag.

Each lead card shows the contact, the last message, the desk's reason for the stage, a message count and who handled it. A pin icon means the lead was **filed by hand**, so the desk won't move it.

![A lead card for Suresh Kumar, filed at Won](https://mintcdn.com/magicwebs/lXS3DuVdQz1WpiFT/images/console/lead-card.png?fit=max\&auto=format\&n=lXS3DuVdQz1WpiFT\&q=85\&s=7ad44ef5e68ae695171cf589ee8b4ba7)

## Move a lead

* Drag a card to another column in Kanban, or
* change the stage from the stage selector on the card.

Filing a lead by hand **pins** it: the follow-up desk's reviews leave it there. Choose **Unfile** to hand the decision back to the desk.

Follow-up status on each card:

| Status | Meaning |
| - | - |
| Can still be nudged | The desk may send a follow-up |
| Nudge limit used | Two nudges have gone out |
| Stage is closed | Won or lost; no more follow-ups |
| Not reviewed yet | The desk hasn't read it |

## Set up stages

Choose **Manage stages**.

![The Lead stages sheet with each stage and its description](https://mintcdn.com/magicwebs/lXS3DuVdQz1WpiFT/images/console/leads-manage-stages.png?fit=max\&auto=format\&n=lXS3DuVdQz1WpiFT\&q=85\&s=85e2b43d95d64ed8b4142895d168dd49)

Each stage has:

* **Name**, for example *Site visit booked*.
* **What belongs here**: the test the follow-up desk applies to a conversation. Describe the situation, not the label: *"A site visit has been agreed for a specific date, or a Site Visit record has been filed in the conversation."*
* **Outcome**: **Open** (still in play), **Won** or **Lost**. Won and lost stop the follow-ups.

> [!WARNING]
>
> The descriptions **are** your pipeline: the desk files conversations by matching them against these lines. Keep a won and a lost stage, or customers who have already bought keep being chased. Deleting a stage returns its leads to unfiled.

## Tags

Choose **Manage tags** to create labels such as a type of enquiry, a priority or a source.

![The Lead tags sheet with Commercial, Home loan, Hot lead, Investor and NRI](https://mintcdn.com/magicwebs/lXS3DuVdQz1WpiFT/images/console/leads-manage-tags.png?fit=max\&auto=format\&n=lXS3DuVdQz1WpiFT\&q=85\&s=941c9faf9c8f0ec3920529bdbd22b75c)

* A tag **with a description** is applied by the follow-up desk on its own, for example *Hot lead: "They want to buy within the next 30 days, have a budget ready, or ask about booking a specific unit."*
* A tag **without** a description is only applied by hand.

Once someone changes a lead's tags by hand, the desk leaves them alone.

> [!NOTE]
>
> If the page says **No follow-up desk yet**, choose **Create the follow-up desk**. Nothing is filed or followed up until the workspace has one.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.