# Scenaro Documentation

> Build, deploy, and embed voice AI experiences with Scenaro and @scenaro/sdk.

Scenaro is the conversational AI platform for brands — voice and scenario experiences embedded on your own site. This site documents the platform, the voice agent, and the @scenaro/sdk npm package.

## Pages

- [Introduction](https://docs.scenaro.io/introduction/overview/): Scenaro is a platform for building, publishing, and embedding voice AI experiences with @scenaro/sdk.
- [Implement an experience](https://docs.scenaro.io/introduction/implement-an-experience/): End-to-end guide for developers embedding a Scenaro voice experience — from install to production.
- [Quickstart](https://docs.scenaro.io/introduction/quickstart/): Embed a Scenaro voice experience on your website in 15 minutes using @scenaro/sdk.
- [Key concepts](https://docs.scenaro.io/introduction/concepts/): Core Scenaro concepts — scenarios, publications, identify/session auth, data-channel protocol, and feature registries.
- [Transport](https://docs.scenaro.io/introduction/transport/): The abstraction between ScenaroSession and the realtime engine that carries it — LiveKit today, other engines later.
- [Coding agent support](https://docs.scenaro.io/introduction/coding-agent-support/): Connect Scenaro documentation to Cursor, Claude Code, ChatGPT, and other AI assistants via llms.txt, Markdown export, and MCP.
- [Changelog](https://docs.scenaro.io/changelog/): Release history for @scenaro/sdk and Scenaro documentation.
- [Cockpit](https://docs.scenaro.io/build/cockpit/): Create, configure, and publish Scenaro scenarios from the Cockpit authoring interface.
- [React integration](https://docs.scenaro.io/build/react-integration/): Integrate @scenaro/sdk/react into your application with ScenaroProvider and useScenaroSession.
- [Authentication](https://docs.scenaro.io/build/authentication/): Scenaro two-hop authentication — identifyUser for JWT identity, then startSession for Transport credentials.
- [Session storage](https://docs.scenaro.io/build/session-storage/): How @scenaro/sdk persists identity in localStorage — keys, migration, and custom StorageAdapter.
- [Tools and features](https://docs.scenaro.io/build/tools-and-features/): Choose between session tools and FeatureProvider — the two frontend tool patterns in @scenaro/sdk.
- [Feature registry](https://docs.scenaro.io/build/feature-registry/): Inject business features into @scenaro/sdk via FeatureProvider and a ToolRegistryEntry map.
- [Events and listeners](https://docs.scenaro.io/build/events-and-listener/): Session events via useScenaroSession, the ScenaroEventBus, and frontend tool RPC forwarding.
- [Voice agent architecture](https://docs.scenaro.io/voice-agent/architecture/): How the Scenaro Python voice agent works — Transport session, config handshake, tools, and frontend RPC.
- [Prompting guide](https://docs.scenaro.io/voice-agent/prompting/): Best practices for writing Scenaro voice agent prompts that work well with frontend features and tools.
- [Data channel topics](https://docs.scenaro.io/voice-agent/protocol/topics/): Transport data-channel topic reference for the Scenaro agent ↔ frontend protocol.
- [Message types](https://docs.scenaro.io/voice-agent/protocol/messages/): TypeScript message payload definitions for the Scenaro agent ↔ frontend data-channel protocol.
- [RPC contracts](https://docs.scenaro.io/voice-agent/protocol/rpc/): Transport RPC method names, timeouts, and request/response shapes for Scenaro frontend tools.
- [Embed voice on your website](https://docs.scenaro.io/guides/recipes/embed-voice-website/): Production recipe for embedding a Scenaro voice experience on any React website.
- [Custom feature](https://docs.scenaro.io/guides/recipes/custom-feature/): Recipe for adding a custom frontend feature with tool handlers and a React component to the Scenaro feature registry.
- [Product search feature](https://docs.scenaro.io/guides/recipes/product-search/): Recipe for implementing collection:items:search — the catalog search feature used across Scenaro e-commerce experiences.
- [E-commerce embed](https://docs.scenaro.io/guides/recipes/ecommerce-embed/): End-to-end recipe for embedding Scenaro voice shopping on an e-commerce site with search, display, comparison, and cart features.
- [Multi-language sessions](https://docs.scenaro.io/guides/recipes/multi-language/): Configure multilingual Scenaro voice sessions with language tags, localized prompts, and frontend i18n.
- [Advanced: Transport extensions](https://docs.scenaro.io/guides/advanced-transport-integration/): Access the underlying realtime engine directly for custom audio visualizers, avatars, and multi-participant UI.
- [Production checklist](https://docs.scenaro.io/guides/production-checklist/): Environment variables, security, performance, and deployment checklist for Scenaro production integrations.
- [Migration from vendored SDK](https://docs.scenaro.io/guides/migration-from-vendored-sdk/): Migrate from a copied scenaro-sdk folder or pre-0.3 APIs to @scenaro/sdk 0.3 and useScenaroSession.
- [@scenaro/sdk/react](https://docs.scenaro.io/sdk-reference/react/): API reference for ScenaroProvider, useScenaroSession, and the feature runtime.
- [ScenaroSession](https://docs.scenaro.io/sdk-reference/session/): Headless, framework-agnostic session class — the core contract behind useScenaroSession.
- [@scenaro/sdk/client](https://docs.scenaro.io/sdk-reference/client/): API reference for ScenaroClient — HTTP client, authentication, session storage, and JWT utilities.
- [@scenaro/sdk/protocol](https://docs.scenaro.io/sdk-reference/protocol/): API reference for the Scenaro agent ↔ frontend protocol — topics, message types, and RPC contracts.
- [API Reference](https://docs.scenaro.io/api-reference/)

## Related

- Website: https://scenaro.io/
- Website llms.txt: https://scenaro.io/llms.txt
- npm: https://www.npmjs.com/package/@scenaro/sdk
- GitHub: https://github.com/scenaro

## Discoverability

- Sitemap: https://docs.scenaro.io/sitemap.xml
- Robots: https://docs.scenaro.io/robots.txt
- Full docs in one file: https://docs.scenaro.io/llms-full.txt