# Vocenya Docs

> Developer documentation for the Vocenya API: guides, the full REST reference, signed webhooks, the live chat widget and MCP servers for AI assistants.

Base URL: https://vocenya.com/api/public/v1. Authenticate with an organization API key: `Authorization: Bearer $VOCENYA_API_KEY`. OpenAPI: https://vocenya.com/docs/api.json. Docs MCP server: https://vocenya.com/mcp/docs (public, read-only).

## Guides

- [Quickstart](https://vocenya.com/docs/quickstart.md): Create an API key and make your first request to the Vocenya API in a few minutes.
- [Authentication and scopes](https://vocenya.com/docs/authentication.md): Authenticate every request with an organization API key sent as a Bearer token, and give each key only the scopes it needs.
- [Test mode](https://vocenya.com/docs/test-mode.md): Build and test against a separate set of test data with vk_test_ keys. Test calls never ring anyone.
- [Pagination](https://vocenya.com/docs/pagination.md): Every list endpoint is newest first and cursor paginated. Pass meta.next_cursor back as cursor to walk through the pages.
- [Errors](https://vocenya.com/docs/errors.md): The Vocenya API uses standard HTTP status codes and one JSON error shape, with a machine-readable code for every refusal you can act on.
- [Rate limits](https://vocenya.com/docs/rate-limits.md): Each API key can make a set number of requests a minute, shared between the REST API and the platform MCP server. Past it, wait for Retry-After.
- [Outbound calls and compliance](https://vocenya.com/docs/outbound-calls.md): Queue AI calls through the API. Every call is checked against consent, Do Not Call lists, calling hours and daily limits before it can ring.
- [Changelog](https://vocenya.com/docs/changelog.md): Every change to the Vocenya API, webhooks and MCP servers, newest first, with the date it shipped.

## API reference

- [Overview](https://vocenya.com/docs/reference.md): Every endpoint of the Vocenya REST API, grouped by resource.
- [Account](https://vocenya.com/docs/reference/account.md): The account and key behind the request.
- [Calls](https://vocenya.com/docs/reference/calls.md): Phone calls your AI receptionist, GH Live agents and team handled.
- [Leads](https://vocenya.com/docs/reference/leads.md): People who called, chatted or filled in a form.
- [Bookings](https://vocenya.com/docs/reference/bookings.md): Appointments the AI booked into your calendar or field-service software.
- [Outbound calls](https://vocenya.com/docs/reference/outbound-calls.md): Have the AI call someone who agreed to AI calls.
- [Do Not Call](https://vocenya.com/docs/reference/do-not-call.md): Numbers your AI never calls.
- [Blocked callers](https://vocenya.com/docs/reference/blocked-callers.md): Numbers and prefixes whose inbound calls are turned away before your receptionist answers (spam, robocallers).
- [Chats](https://vocenya.com/docs/reference/chats.md): Chats on your website widget (channel: web) and on WhatsApp (channel: whatsapp, with the customer's number in contact_address).
- [Webhooks](https://vocenya.com/docs/reference/webhooks.md): Get events pushed to your HTTPS endpoint instead of polling.

## Webhooks

- [Webhooks](https://vocenya.com/docs/webhooks.md): Get leads, calls, bookings, outbound calls and live chats pushed to your HTTPS endpoint as they happen, signed so you can trust them.
- [Webhook events](https://vocenya.com/docs/webhook-events.md): Every webhook event Vocenya sends, the scope each one needs and an example payload for each.

## Live chat

- [Live chat widget](https://vocenya.com/docs/live-chat.md): Add the Vocenya website live chat with one script tag, control it with the JavaScript API, and answer chats from your own systems.

## MCP

- [MCP servers](https://vocenya.com/docs/mcp.md): Connect Claude, ChatGPT, Cursor and other AI assistants to your Vocenya account and to these docs with the Model Context Protocol.

## Optional

- [All docs in one file](https://vocenya.com/docs/llms-full.txt)
- [OpenAPI document](https://vocenya.com/docs/api.json)