# Leads

The [Leads page](https://app.spara.co/leads) is where you manage every lead that has interacted with your Spara agents. Each row represents a single lead with their current stage, latest action, and next workflow step.

<figure><img src="/files/AiXE6NtDC1JyXQbZwgMj" alt=""><figcaption><p>The Leads page showing lead stage, latest actions, and next workflow steps.</p></figcaption></figure>

Each lead row shows:

* **Lead** — Name, email, and status indicators. A green checkmark means the lead self-identified; a yellow warning icon means they were identified through deanonymization or enrichment.
* **Stage** — Where the lead is in your funnel: Browsing, Engaged, Email Captured, Webform Submitted, Calendar Shown, or Call Scheduled.
* **Latest Lead Action** — The most recent action the lead took (e.g., Sent Chat Message, Answered Phone Call, Visited Webpage).
* **Next Step** — The upcoming workflow touchpoint, or "No upcoming steps" if the lead isn't in an active workflow.

### Filtering and Search

Use filters to narrow your leads list:

| Filter          | Options                                                            |
| --------------- | ------------------------------------------------------------------ |
| **Timeframe**   | Last 7 days, Last 30 days, Last 90 days, All time, or custom range |
| **Agent**       | Filter by a specific Chat, Email, Voice, or Copilot agent          |
| **Channel**     | Chat, Email, Voice, Text                                           |
| **Engagement**  | High (5+ messages), Medium (<5 messages), Browsing (no messages)   |
| **Stage**       | Any lead stage                                                     |
| **Lead Source** | Spara, Salesforce, HubSpot, Marketo, Leads API                     |
| **Country**     | Searchable country list based on IP location                       |
| **Known**       | Verified vs. enriched leads                                        |

Use the search bar to find leads by name, email, or company. Click **Export as CSV** to download the filtered list.

## Lead Details

Click any lead to open their detail view, which has two tabs:

### Timeline

The Timeline shows the full conversation history between the lead and your agents across all channels — chat messages, voice calls, and emails in a single chronological view.

<figure><img src="/files/EDNtY0b7PhS4Lt7Dxk0R" alt=""><figcaption><p>The Timeline tab showing a chat conversation between a lead and a Spara agent.</p></figcaption></figure>

This is where you can:

* **Take over a conversation** — Click "Take over chat" at the bottom to enter manual mode. Spara agents will stop sending automatic messages. Click "Return to Automated" when you're done.
* **View next steps** — The right sidebar shows upcoming workflow touchpoints and past actions.

When a team member takes over via **Take over chat**, the timeline shows a **"\[Name] has taken over the chat"** marker at that point in the history. When they click **Return to Automated**, a **"Returned to automated"** marker appears. These markers make it easy to see at a glance exactly when human and AI control switched during a conversation.

{% hint style="info" %}
Spara can send Slack, Webex, or Microsoft Teams notifications when specific events happen, so your team knows when to take over. Configure these in [Notifications](/platform/settings/notifications.md).
{% endhint %}

### Lead Details

The Lead Details tab shows everything Spara knows about a lead — personal information, a conversation summary, and company data pulled from enrichment and CRM syncs.

<figure><img src="/files/M5HmJDKhJ3dk9cTz9MJR" alt=""><figcaption><p>The Lead Details tab showing personal information, conversation summary, and company data.</p></figcaption></figure>

Information is organized into sections:

* **Personal Information** — Name, email (with validation status), phone, job title, seniority, department, LinkedIn profile, location, skills, and interests.
* **Conversation Summary** — AI-generated summary including questions asked, sales stage, pain points, and interests identified.
* **Company Details** — Company name, website, industry, revenue, headcount, business model, and products.
* **Company Insights** — Corporate objectives, competitors, recent news, and small talk opportunities.

All fields come from Spara's [Data Model](/platform/data-model.md) — a combination of data gathered by agents, CRM syncs, and lead enrichment.

## FAQ

### How do I improve a response the agent gave?

Lead conversations are connected to Ask AI. If you see a response you want to improve, use the feedback tools in the conversation to suggest better behavior. This helps refine your agent's prompt over time.

### Can I export lead data?

Yes. Apply any filters on the Leads page and click **Export as CSV** to download the filtered results.

### How does deanonymization work?

When a visitor hasn't self-identified, Spara can match them to known contacts using IP and behavioral signals. Deanonymized leads are marked with a yellow warning icon to indicate the data came from external sources rather than direct identification. See [Deanonymization](/agents/chat-agents/deanonymization.md) for details.

### What happens when a lead is blocked?

Spara automatically blocks leads who send harmful or malicious content. Blocked leads can no longer receive responses from Spara. See [Blocking](/platform/leads/blocking.md) for details on how moderation works and how to manually block or unblock leads.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.spara.com/platform/leads.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.