Media
Upload and configure visual media that Spara chat agents show to leads during conversations.
Chat agents read your media library during every conversation and proactively surface the most relevant file at the right moment — without you scripting every interaction. When a lead asks for a product demo, a case study, or a pricing overview, the agent pulls up the right asset and presents it naturally, the same way a rep would reach for the right slide deck.
Media is currently supported by Chat agents only (Spara Navigator, Smartbar, and Fullscreen).
How media appears in chat
When an agent shows a file, a media panel slides out to the left of the conversation. The lead can view the media while continuing to chat — videos, PDFs, and images all render inline in this panel, so leads never have to leave the page.
Setting up your media library
Navigate to Media and click Upload File. Each asset has three fields the agent uses to decide when and whether to show it:
Name — The label displayed to the lead when the file is shown. Use something clear and human-readable, like "Product Overview" or "Q3 Case Study — Enterprise."
Description — A detailed explanation of what the asset contains. The agent reads this to understand the file's content. The more specific, the better the agent's decision-making — describe the topics covered, the audience it's best for, and any key proof points.
When to Show — A plain-language description of the situations in which this file is relevant. The agent reads this to know when to surface the asset (see Writing effective "When to Show" descriptions).
Visibility — Set to Visible to make the file active. Set to Hidden to remove it from the agent's options without deleting it.
Writing effective "When to Show" descriptions
The "When to Show" field is what tells the agent the right moment to surface a file. Write it as a bulleted list of intent signals — what would a lead say or ask that makes this asset relevant?
Good example for a product demo video:
Lead asks to see a product demo or walkthrough
Lead expresses interest in understanding how the platform works
Lead asks "what does it look like" or "can you show me"
Good example for a pricing overview PDF:
Lead asks about pricing, cost, or plans
Lead asks to compare tiers or packages
Lead is ready to move forward and wants to understand the investment
Tips:
Use plain language, not exact-match phrases. The agent understands intent, not just keywords.
One file per specific use case. Focused conditions perform better than a single catch-all file.
Revisit conditions after reviewing conversations. If a file is appearing at the wrong moment, tighten the description.
Keeping your library current
Because the agent reads asset details directly from the Media library, you can update what it shows without touching your agent's prompt:
Add a new asset with a clear description and "When to Show" — the agent picks it up automatically
Update an existing asset's description to shift when and how the agent uses it
Set an asset to Hidden to remove it from the agent's options immediately
Guiding media from the agent prompt
You can give your chat agent explicit instructions in its prompt about how to handle media — which assets to prioritize, when to proactively offer them, how to introduce them, and when to hold back. For details and examples, see the Using Media in Chat Agents.
Supported file formats
Video (mp4, mov)
Product demos, explainers, customer testimonials
Image (png, jpg, gif)
Feature screenshots, comparison charts, one-pagers
Pricing sheets, case studies, whitepapers
FAQ
How many media files can I have?
There is no hard cap. Use Hidden to archive files you no longer need rather than deleting them, so you can reactivate them later.
Can the same file be shown by multiple agents?
Yes. Media files are shared across all chat agents in your account. Any Visible file can be shown by any active chat agent when its "When to Show" conditions are met.
How do I know if a media file is working?
Test it in the Testing interface: start a conversation and steer it toward a trigger condition you defined. If the media panel opens, the condition matched. If it doesn't appear, try expanding or rephrasing the "When to Show" description.
Can I control which agent shows which file?
Not directly by agent — Visible files are available to all chat agents. If you need a file to be agent-specific, set it to Hidden and coordinate with your prompt instructions to guide which agent uses it and when.
For a step-by-step walkthrough of setting up media from scratch, see Using Media in Chat Agents.
Last updated