# Yotel Developer Docs

## Docs

- [Agents](https://docs.yotel.in/api-reference/agents.md): List agents and retrieve real-time agent statistics.
- [AI sessions](https://docs.yotel.in/api-reference/ai-sessions.md): Control active AI voice sessions and manage callback tokens.
- [Calls](https://docs.yotel.in/api-reference/calls.md): Retrieve call details and paginated call lists.
- [Campaigns CRUD](https://docs.yotel.in/api-reference/campaigns/crud.md): Create, list, read, update, and delete campaigns.
- [Campaign lifecycle](https://docs.yotel.in/api-reference/campaigns/lifecycle.md): Start, pause, and stop campaigns to control dialing.
- [Error reference](https://docs.yotel.in/api-reference/error-reference.md): Comprehensive catalog of HTTP status codes and error types across all API endpoints.
- [API Reference](https://docs.yotel.in/api-reference/introduction.md): Auto-generated reference from the live OpenAPI spec.
- [API keys](https://docs.yotel.in/api-reference/keys.md): Issue, list, rotate, and revoke API keys programmatically.
- [Leads](https://docs.yotel.in/api-reference/leads.md): Push single or bulk leads into a campaign for dialing.
- [Recordings](https://docs.yotel.in/api-reference/recordings.md): Access call recordings via signed URLs or direct audio streaming.
- [Voice agents CRUD](https://docs.yotel.in/api-reference/voice-agents/crud.md): Create and manage voice agent routing aliases for AI-powered call handling.
- [Voice agent defaults](https://docs.yotel.in/api-reference/voice-agents/defaults.md): Get and set the tenant-level default voice agent.
- [Webhook management](https://docs.yotel.in/api-reference/webhooks/management.md): Create, list, test, and rotate webhook subscriptions programmatically.
- [Authentication](https://docs.yotel.in/authentication.md): API-key auth, rate limits, scopes, and rotation for the Yotel public API.
- [OAuth 2.0](https://docs.yotel.in/authentication/oauth.md): Interactive OAuth 2.1 + PKCE and server-to-server JWT Bearer flows for partner apps.
- [Scope reference](https://docs.yotel.in/authentication/scopes.md): Full catalog of OAuth 2.0 scopes — which routes each scope unlocks and how they compose.
- [Dial modes](https://docs.yotel.in/concepts/dial-modes.md): How Yotel's three outbound dial modes — preview, progressive, and predictive — differ, when to pick each, and how voice broadcast fits on top.
- [Environments](https://docs.yotel.in/concepts/environments.md): Live vs test keys, and what changes when you switch.
- [Errors](https://docs.yotel.in/concepts/errors.md): Error shape, status codes, and what each means.
- [Idempotency](https://docs.yotel.in/concepts/idempotency.md): Safe retries for POST requests using Idempotency-Key.
- [Rate limits](https://docs.yotel.in/concepts/rate-limits.md): Per-key limits, burst behavior, and how to handle 429s.
- [Salesforce](https://docs.yotel.in/integrations/salesforce.md): Install the Yotel for Salesforce managed package and push Contacts/Leads into Yotel campaigns from inside the CRM.
- [Introduction](https://docs.yotel.in/introduction.md): Yotel is an AI-native, browser-based call-centre dialer for Indian BPOs. The Yotel API lets you push leads, manage campaigns, receive call events, and build custom workflows from your own backend.
- [Quickstart](https://docs.yotel.in/quickstart.md): Push your first lead in 5 minutes.
- [Python SDK](https://docs.yotel.in/sdks/python.md): Thin client library for the Yotel public API. pip install yotel.
- [TypeScript SDK](https://docs.yotel.in/sdks/typescript.md): Zero-dep TypeScript client for the Yotel public API.
- [Control API](https://docs.yotel.in/voice-agents/control-api.md): All 25 mid-call verbs your voice AI can invoke against Yotel — transfer, hangup, hold, conference, request_supervisor, schedule_callback, and more.
- [Voice agents quickstart](https://docs.yotel.in/voice-agents/quickstart.md): Wire up an AI voice agent to your Yotel tenant — create the routing alias, attach it to a campaign or flow, and place your first AI call.
- [AI session events](https://docs.yotel.in/webhooks/ai-session-events.md): Five new ai_session.* events plus the stereo flag on call.recording_ready — for tenants running voice AI through Yotel.
- [Event catalog](https://docs.yotel.in/webhooks/event-catalog.md): Every event type Yotel can publish, with payload shape.
- [Webhooks overview](https://docs.yotel.in/webhooks/overview.md): Subscribe to real-time events from your campaigns, calls, and agents.
- [Retries and dead-lettering](https://docs.yotel.in/webhooks/retries.md): How Yotel backs off on failed deliveries, and when it gives up.
- [Signature verification](https://docs.yotel.in/webhooks/signature-verification.md): Verify HMAC-SHA256 signatures on incoming webhook deliveries.
- [Troubleshooting webhooks](https://docs.yotel.in/webhooks/troubleshooting.md): Common delivery failures and how to diagnose them.

## OpenAPI Specs

- [openapi](https://docs.yotel.in/api-reference/openapi.json)

## Optional

- [OpenAPI spec](https://api.yotel.in/openapi.json)
- [GitHub SDKs](https://github.com/kamal-zetta/dialer/tree/main/sdks)