# Chat Agents

Chat agents are Spara's website AI — they engage visitors in real-time conversations, qualify leads, surface relevant content, and book meetings. Unlike rule-based chatbots, Spara's chat agents are powered by LLMs and respond naturally to whatever a visitor says.

Spara offers three chat interfaces:

* [Spara Navigator](/agents/chat-agents/spara-navigator.md) — the standard bottom-right chat widget
* [Spara Smartbar](/agents/chat-agents/spara-smartbar.md) — a ChatGPT-style experience embedded in your marketing pages
* [Spara Fullscreen](/agents/chat-agents/spara-fullscreen.md) — a fullscreen chat experience designed to load immediately after form submissions

Most Spara customers deploy all three interfaces. Leads who engage with more than one interface share a single conversational thread.

***

## Abilities

Chat agents can invoke the following abilities during a live conversation. For a cross-agent overview, see [Abilities](/agents/agent-overview/abilities.md).

### Show Calendar

The agent can present a scheduling link to the lead — a calendar widget slides out alongside the conversation, letting the lead pick a time without leaving the page.

**How it works:** Calendar booking is enabled on all chat agents by default. The agent decides when to show the calendar based on your [AI Instructions](/agents/agent-overview/ai-instructions.md) and the lead's intent. You don't need to explicitly call it out — instruct the agent on what buying signals or requests should trigger the calendar, and it handles the rest.

**Setting it up:** Connect a calendar via [Calendar Integrations](/integrations/calendar-integrations.md). Calendars are uploaded as media assets and made available to the agent. Add instructions for when to show the calendar — for example:

> When a lead is ready to book a meeting or asks about scheduling, show the calendar. Don't show it before you've confirmed interest.

**Multiple calendars:** If you have more than one calendar (e.g., different reps or meeting types), specify in instructions which calendar to use in which context.

### Show Media

The agent can surface a video, image, or PDF alongside the conversation. The media panel opens to the left of the chat so the lead can view it without losing the conversation thread.

**How it works:** Media display is opt-in. Enable it for specific agents and upload assets on the [Media](/platform/media.md) page. Each asset has a **Name**, **Description**, and **When to Show** field that the agent reads when deciding what to surface.

**Setting it up:** See [https://docs.spara.com/guides/using-media-in-chat-agents](https://docs.spara.com/guides/using-media-in-chat-agents "mention") for a step-by-step walkthrough.

<figure><img src="/files/tFQH1lqizc6EukjOhDEd" alt=""><figcaption><p>Spara Navigator showing a video alongside the conversation.</p></figcaption></figure>

### Send Email

The agent can send an email on behalf of your organization — for example, to follow up with a summary, send a PDF, or copy in a rep after a conversation.

**How it works:** The agent composes and sends an email using your connected email provider. You configure which email addresses are allowed recipients in the agent's settings. The lead's email address and any whitelisted org addresses can be included.

**Requirements:** An active email connection (Gmail or Outlook) must be set up under [Email Agents](/agents/email-agents.md). The send\_email ability is not enabled by default — configure it by adding `send_email` to the agent's tool list and adding instructions for when and how to use it.

***

## Technical details

For technical information about how the Spara chat widget loads on your website (iframe architecture, browser storage, and cookie consent), see [https://docs.spara.com/developers/iframe-and-cookies](https://docs.spara.com/developers/iframe-and-cookies "mention").

***

## FAQ

### Can I give one chat agent multiple calendars?

Yes. Upload each calendar as a separate asset, give them distinct names, and write instructions that specify which calendar to use for which scenario (e.g., "use the Sales calendar for prospects, the Support calendar for existing customers").

### Can the agent show media and a calendar in the same conversation?

Yes. The agent can show both in a single conversation — for example, playing a product video early in the conversation and offering the calendar once interest is confirmed.

### Does sending an email create a lead record?

No. The send\_email ability sends to addresses you've configured (the lead's email, whitelisted org addresses). It does not create new leads or alter the lead record.

### Do leads who chat on multiple widgets share the same conversation?

Yes. Leads that engage with more than one Spara interface — Navigator, Smartbar, or Fullscreen — experience a single continuous conversational thread. Context carries across widgets.


---

# 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/agents/chat-agents.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.
