Documentation
Everything you need to build, deploy, and analyze with Stetos.co insight infrastructure.
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 listening 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 listening experience 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 insight signals after completion.
Voice Architecture
Voice sessions run in the browser with a managed live conversation layer. After completion, Stetos prepares transcripts, metrics, summaries, and insight outputs for your workspace.
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 transcript context with structured extraction so teams can track themes, trends, and evidence across listening sessions.
Rewards & Actions
Rewards incentivize participation, while actions frame next steps such as booking links, review drafts, coupons, or follow-up CTAs after a session.
Rewards & Actions
Rewards and Actions are configured outcomes that can appear after a participant completes a session. They help teams thank participants, route qualified users, or trigger a clear next step.
Rewards
Use rewards for incentives, perks, coupons, thank-you offers, or other participant benefits that should feel celebratory.
Actions
Use actions for next steps such as booking a call, opening a destination link, or generating a copyable review or comment draft.
- Configure Rewards & Actions after creating an agent from the advanced builder.
- Set natural-language criteria that determine when an outcome should appear.
- Supported outcome types include links, static codes, unique code pools, coupon images, and dynamic output drafts.
- Eligibility is evaluated after the session so participants see qualifying outcomes on the end screen.
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.
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.
Rewards & Actions
Rewards and Actions are configured from the agent builder after creation. Outcomes are evaluated after the conversation and appear on the session end screen when the participant qualifies.
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