> For the complete documentation index, see [llms.txt](https://docs.spara.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.spara.com/agents/capabilities/chat.md).

# Chat

The **Chat capability** is Spara's website AI. It engages visitors in real-time conversations, qualifies leads, surfaces relevant content, and books meetings. Unlike rule-based chatbots, Spara's Chat capability is powered by an LLM and responds naturally to whatever a visitor says.

Chat offers three interfaces:

* [Spara Navigator](/agents/capabilities/chat/spara-navigator.md): the standard bottom-right chat widget
* [Spara Smartbar](/agents/capabilities/chat/spara-smartbar.md): a ChatGPT-style experience embedded in your marketing pages
* [Spara Fullscreen](/agents/capabilities/chat/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

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

### Show Calendar

The capability 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 capabilities by default. The capability decides when to show the calendar based on your [AI Instructions](/agents/capabilities/configuring/ai-instructions.md) and the lead's intent. You don't need to explicitly call it out; instruct it 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 capability. 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 capability 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 and upload assets on the [Media](/platform/media.md) page. Each asset has a **Name**, **Description**, and **When to Show** field that the capability reads when deciding what to surface.

**Setting it up:** See [Using Media in Chat Agents](/guides/platform-guides/using-media-in-chat-agents.md) 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 capability 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:** It composes and sends an email using your connected email provider. You configure which email addresses are allowed recipients in the capability's settings. The lead's email address and any whitelisted addresses can be included.

**Requirements:** An active email connection (Gmail or Outlook) must be set up under [Email](/agents/capabilities/email.md). The send\_email ability is not enabled by default; configure it by adding `send_email` to the capability'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 [iFrame & Cookies](/developers/spara-api/iframe-and-cookies.md).

***

## FAQ

### Can I give one Chat capability 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 it show media and a calendar in the same conversation?

Yes. The capability can show both in a single conversation, for example, playing a product video early 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 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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