# Akapulu

> Akapulu builds conversational avatars for natural, real-time voice and video interactions.

## Docs

- [Connect Conversation](https://docs.akapulu.com/api-reference/conversations/connect.md): Create a conversation session and return room credentials for joining.
- [Get Conversation Detail](https://docs.akapulu.com/api-reference/conversations/detail.md): Fetch conversation metadata, recording status, avatar info, and transcript rows for a conversation session.
- [Get Conversation Recording](https://docs.akapulu.com/api-reference/conversations/recording.md): Redirect to a signed recording download URL when the recording is ready.
- [Poll Conversation Updates](https://docs.akapulu.com/api-reference/conversations/updates.md): Fetch current conversation readiness and progress for a conversation session.
- [Introduction](https://docs.akapulu.com/api-reference/introduction.md): Overview of Akapulu API authentication and base usage.
- [Akapulu blog](https://docs.akapulu.com/blog/index.md): Product updates, integration notes, and stories from the Akapulu team.
- [What Is Akapulu?](https://docs.akapulu.com/blog/what-is-akapulu/what-is-akapulu.md): A quick tour of scenarios, tools, testing, avatars, and live conversations—with links into the docs.
- [Custom UI](https://docs.akapulu.com/examples/basic/custom-ui.md): A Next.js example using Akapulu's headless React hooks for a fully custom UI.
- [Pre-built UI](https://docs.akapulu.com/examples/basic/prebuilt-ui.md): A Next.js example using Akapulu's prebuilt conversation UI.
- [Examples](https://docs.akapulu.com/examples/index.md): Reference implementations you can clone and adapt.
- [Healthcare Intake & Scheduling](https://docs.akapulu.com/examples/scenarios/healthcare-intake-scheduling.md): This example scenario demonstrates how to run a full patient screening conversation that collects intake details, schedules an appointment, answers clinic questions, and then closes the session cleanly.
- [Sales Roleplay Training](https://docs.akapulu.com/examples/scenarios/sales-roleplay-training.md): This example scenario demonstrates how to run an AI-powered sales roleplay where the avatar plays a specific named prospect across a discovery call — intro, discovery, pitch, objection handling, and close — so the sales rep can practice the full flow end-to-end.
- [Using Public Avatars](https://docs.akapulu.com/guides/avatars/avatar-catalog.md): Browse the public catalog and use catalog avatars in your conversations.
- [Create Your Own Avatar](https://docs.akapulu.com/guides/avatars/create-avatar.md): Create your own avatar in Akapulu.
- [Customize Conversation UI](https://docs.akapulu.com/guides/conversations/customize-conversation-ui.md): Build and tailor your own conversation interface.
- [Conversation Lifecycle](https://docs.akapulu.com/guides/conversations/lifecycle.md): How a conversation session starts, runs, and completes.
- [Endpoints](https://docs.akapulu.com/guides/endpoints/create-endpoint.md): Create, configure, and attach endpoints for scenario tools.
- [Templates and Variables](https://docs.akapulu.com/guides/endpoints/templates-and-variables.md): Use runtime, LLM, and secret variables in endpoint templates.
- [How Akapulu Works](https://docs.akapulu.com/guides/getting-started/how-akapulu-works.md): High-level overview of how Akapulu powers real-time conversational experiences.
- [Knowledge Base](https://docs.akapulu.com/guides/knowledge-bases/overview.md): What knowledge bases are, how to create them, and how to attach them to scenarios.
- [Testing Mode](https://docs.akapulu.com/guides/scenarios/llm-test-mode.md): Run your scenario as an LLM-only, text-based simulation in the visual scenario editor.
- [Node Basics](https://docs.akapulu.com/guides/scenarios/node-basics.md): Node structure, transitions, tools, and variables.
- [Scenarios Overview](https://docs.akapulu.com/guides/scenarios/overview.md): Learn how to design conversation flows using stages, tools, and node transitions.
- [Role and task instructions](https://docs.akapulu.com/guides/scenarios/role-and-task-instructions.md): Use the global role instruction and per-node task instructions to shape persona, stage behavior, and what the model sees in each conversation.
- [Using JSON](https://docs.akapulu.com/guides/scenarios/using-json.md): Define nodes, instructions, and tools using Akapulu scenario JSON.
- [Transition Tools](https://docs.akapulu.com/guides/tools/transition-tools.md): Use transition tools to move from one node to another after a tool call.
- [Vision](https://docs.akapulu.com/guides/vision/vision-tool-overview.md): Understand what the vision tool does and when to use it in a scenario.
- [Quickstart](https://docs.akapulu.com/quickstart.md): Build your first conversational avatar experience in minutes.
- [Callbacks and events](https://docs.akapulu.com/web-sdk/callbacks-and-events.md): Reference for the Akapulu React event stream and event payloads.
- [Introduction](https://docs.akapulu.com/web-sdk/overview.md): Architecture and package structure for the Akapulu Web SDK.
- [React](https://docs.akapulu.com/web-sdk/react-sdk.md): React provider, hooks, and media helpers for Akapulu conversations.
- [React UI](https://docs.akapulu.com/web-sdk/react-ui.md): Prebuilt React conversation UI components for Akapulu.
- [Server](https://docs.akapulu.com/web-sdk/server-sdk.md): Server-side client for calling Akapulu APIs from your backend.

## OpenAPI Specs

- [akapulu](https://docs.akapulu.com/openapi/akapulu.json)
- [openapi](https://docs.akapulu.com/api-reference/openapi.json)