Documentation

Everything you need to build, deploy, and analyze with Stetos.co.

Quick Start

Launch your first listening agent in minutes.

Platform Concepts

Understand agents, sessions, and Knowledge Library V3.

Deployment Best Practices

Increase completion rate and interview quality.

Advanced Configuration

Embed options, metadata, and limits behavior.

Troubleshooting

Fix common integration and launch issues quickly.

Quick Start

Follow these steps to deploy your first listening agent and start gathering insights.

1. Create a Project and Agent

Create a project, then configure your first agent with a clear interview goal and target audience.

2. Add Knowledge Library Sources

Upload or link relevant product material in the Knowledge Library, then assign selected sources to your agent before publishing.

3. Embed the Widget

Place this script before </body> on your website for a bubble launcher:

<script
  src="https://www.stetos.co/widget/stetos-widget.js"
  data-agent-id="YOUR_AGENT_ID"
  data-mode="bubble"
  defer
></script>

Platform Concepts

Agents

An agent is a configurable interviewer with its own tone, objectives, voice, and knowledge assignment.

Sessions

A session is one user conversation through voice or chat. Sessions are analyzed into summaries, metrics, and insights after completion.

Knowledge Library V3

Sources are stored at the user level, then assigned per agent. Agent assignment, inclusion, and ordering are controlled in the agent experience.

Analysis

Stetos combines qualitative transcript context with structured extraction so teams can track themes and trends across interviews.

Deployment Best Practices

To improve interview quality and completion rate, use these patterns during rollout.

Set intent before launch: use clear entry copy such as Help us improve this feature.
Define consent moments: ensure respondents understand recording and analysis before they start.
Start broad then narrow: begin with open prompts and then move to specific product areas.
Review early sessions: calibrate prompt style and strictness after the first interviews.

Advanced Configuration

You can customize behavior with script attributes for bubble and inline modes.

Inline Embed Example

<div id="stetos-embed" style="width:100%;height:600px;"></div>
<script
  src="https://www.stetos.co/widget/stetos-widget.js"
  data-agent-id="YOUR_AGENT_ID"
  data-mode="inline"
  data-target="#stetos-embed"
  data-default-mode="chat"
  defer
></script>

Metadata

Pass custom identifiers for analytics joins and downstream enrichment.

data-metadata='{"user_id":"123","plan":"pro"}'

Always URL encode metadata JSON in production to avoid query parsing issues.

Limits and Retention

Plan limits apply to active agents, monthly sessions, and voice minutes.
Add ons can extend limits, including expiring add on inventory.
Retention behavior can vary by plan and product configuration.

Troubleshooting

Widget not loading: verify `data-agent-id` and confirm script URL is `stetos-widget.js`.
Inline mode not rendering: ensure `data-target` selector exists before the script executes.
No session creation: verify the agent is active and plan limits are not exceeded.
Voice start issues on mobile: confirm browser microphone permissions and HTTPS origin.
Metadata missing: URL encode JSON and validate key names in your integration.

Help and Support

Need help? Reach us directly.

For setup questions, integration issues, or product feedback, contact our team and we will help you move quickly.

Message @Miguel_FeM