Contact us
Docs & Guides
Open API SandboxDashboard →
Vozon Developer Documentation

Build voice agents that move work forward.

Create multilingual agents, connect business knowledge and phone numbers, launch calls, and observe every outcome from one unified developer platform and API.

INTERACTIVE

Vozon API Reference & Live Sandbox

Live browser request runner, multi-language code snippets (cURL, Node.js, Python, Go, PHP), parameter trees, and instant HMAC webhook signature testing.

Open Interactive API Explorer →
01

Build

Configure behavior, voice, language, and custom business tools.

02

Deploy

Connect a phone number or trigger calls dynamically via external API.

03

Improve

Analyze transcripts, outcomes, latency, and cost telemetry.

Your application
Vozon API
Voice agent
Customer
Call events
Start here

Quickstart

A production-ready voice agent deployment has four straightforward parts.

1

Create an agent

Open Agents, select New agent, choose a starting template, and give your agent a descriptive name.
2

Configure the conversation

Select the caller’s language and natural voice. Add a first greeting message and system prompt instructions describing goals, boundaries, and escalation.
3

Test before deployment

Use the browser test call playground. Verify pronunciation, natural interruptions, tool calling, and structured data outputs.
4

Connect a phone number

Import or purchase a dedicated phone number, assign the agent, choose inbound/outbound permissions, and place a live test call.
✓
Start with one narrow outcome. A focused appointment-booking or lead qualification agent is easier to test and optimize than an agent trying to handle every business workflow at once.
Build

Configure an agent

Agent configuration controls what the agent says, how it sounds, which knowledge it retrieves, and which custom API actions it can take.

Annotated agent configuration interfaceCustomer support agentLANGUAGEHindi + EnglishVOICENatural · WarmAGENT INSTRUCTIONSGreet the caller, identify their request,use approved knowledge, and confirm thenext action before ending the call.Save123
1Select language and voice2Write precise instructions3Save before testing

First message

Set context immediately. Identify the business and explain clearly why the agent is calling.

Instructions

Write goals in priority order. Include explicit rules for confirmation, transfer, and graceful call wrap-up.

Language and voice

Match the voice model to the selected language. Test names, numbers, dates, and mixed-language phrases.

Tools

Give each action a clear description, required schema inputs, success response, and failure fallback.

Build

Knowledge bases

Attach approved text, PDF/DOCX files, or public website URLs to an agent. Keep each source current, specific, and free of unnecessary sensitive credentials.

1. Add a source

Choose raw text, public website URL crawling, or file upload.

2. Indexing & Vectorization

The source automatically parses and indexes until status shows Ready.

3. Grounded Retrieval

Agents retrieve approved snippets during conversations. Test responses and define a fallback for missing or outdated information.

Deploy

Phone numbers

A number must be Ready, assigned to an agent, and configured for the intended direction before placing or receiving live telephony calls.

DirectionAccepts inboundPlaces outbound
InboundYesNo
OutboundNoYes
BothYesYes
Deploy

Campaigns

Campaigns coordinate outbound calling across approved contact lists with controlled pacing, retry rules, suppression handling, automatic callbacks, and evidence based results.

1. Select route
2. Upload contacts
3. Set pacing
4. Set safeguards
5. Launch & monitor
⚠️
Pausing stops new outbound calls from being dispatched. It does not interrupt phone calls currently in progress.
Open the complete campaign operations guide →
Observe

Call logs & analytics

Review complete operational records for status, duration, full transcripts, audio recordings, structured schema outputs, turn latency, and credit billing.

Conversation

Full turns, stereo recordings, speech-to-text accuracy, sentiment.

Performance

Turn-by-turn latency (ms), speech recognition delay, completion state.

Business Results

Custom schema extraction, sentiment, appointment booked, CRM sync status.

Observe

Billing & wallet credits

Completed call costs are deducted seamlessly from your organization wallet. Real-time billing calculates exact audio duration and AI tokens used.

Metered Telephony & AI+Platform Fee=Transparent Total
API Reference

Authentication

Generate an API key in Dashboard → Developers. Provide it as a Bearer token in the Authorization header on every request.

Shell
Authorization: Bearer avp_your_production_api_key
⚠️
API keys are sensitive credentials. Store them in environment variables or a secrets manager. Never commit them to client-side code.
API Reference

Calls API

Base URL: https://api.vozon.ai/api/v1

Open Interactive Playground →
GET/agentsList agents available to the organization
POST/calls/outboundStart an outbound call
GET/callsList call records with filters and pagination
GET/calls/{callId}Retrieve one normalized call record
GET/calls/{callId}/recordingDownload an authorized recording
GET/calls/export.csvExport matching call records

Dispatch an outbound AI phone call

Shell
curl -X POST "https://api.vozon.ai/api/v1/calls/outbound" \
  -H "Authorization: Bearer avp_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "agentId": "agent_id",
    "phoneNumber": "+919876543210",
    "metadata": {
      "customerId": "customer_123",
      "source": "crm"
    }
  }'

Normalized call response

JSON
{
  "call": {
    "id": "call_id",
    "call_status": "completed",
    "direction": "outbound",
    "duration": 92,
    "transcription_text": "Customer: Hello...",
    "usage": {
      "llmTokens": 1240,
      "sttSeconds": 92,
      "ttsCharacters": 680
    },
    "billing": {
      "chargedCredits": 0.0842
    },
    "metadata": {
      "customerId": "customer_123"
    }
  }
}
Integration

Webhooks

Register an HTTPS webhook in the Developer portal to receive real-time events for call.started, call.ended, and transcript.ready.

JSON
{
  "id": "call.ended:call_id",
  "event": "call.ended",
  "createdAt": "2026-07-30T12:00:00.000Z",
  "data": {
    "id": "call_id",
    "call_status": "completed",
    "direction": "outbound",
    "duration": 92,
    "transcription_text": "Customer: Hello...",
    "billing": { "chargedCredits": 0.0842 }
  }
}

Verify HMAC

Compute HMAC SHA-256 using your endpoint secret and compare with the signature header.

Fast 200 Acknowledge

Return an HTTP 200 response immediately before performing asynchronous database work.

Idempotency

Store the event ID and safely ignore repeated deliveries.

Reference

Status codes & errors

400Invalid requestCorrect missing payload fields or formatting; do not retry unchanged.
401Authentication requiredCheck the API key in the Bearer Authorization header.
403Insufficient permissionKey lacks the required scope (e.g. calls:write) or role.
404Resource not foundConfirm the ID belongs to your active organization.
409Resource conflictRefresh state and resolve the conflict before retrying.
429Rate limitedToo many requests. Retry with exponential backoff and jitter.
5xxTemporary service errorRetry idempotent operations with bounded backoff.
Operations

Production security checklist

✓Keep API credentials in a secure secrets manager and rotate them periodically.
✓Use least-privilege API scopes and separate keys by development and production environments.
✓Enforce 2FA and role-based access control across team members in your organization.
✓Collect only caller data strictly necessary for the designated agent task.
✓Verify incoming webhook HMAC SHA-256 signatures to prevent unauthorized event spoofing.
✓Respect local telecommunications regulations, calling hour restrictions, and suppression lists.
Documentation library

Explore every guide

Detailed workflows, field schemas, code samples, and best practices.

Download OpenAPI spec →
Start here

Quickstart

Create, test, and deploy your first Vozon voice agent.

Build

Agents

Configure voice, language, conversation behavior, tools, and deployment state.

Build

Prompting guide

Write reliable instructions for natural, controlled calls.

Build

Languages and voices

Select and validate speech behavior for multilingual deployments.

Build

Knowledge bases

Ground agent answers in approved text, documents, and web sources.

Build

Tools and integrations

Connect approved business actions and data sources to an agent.

Deploy

Phone numbers

Import, purchase, assign, and operate inbound and outbound numbers.

Deploy

Campaign operations guide

Prepare, launch, monitor, and evaluate outbound campaigns from the dashboard, including automatic callbacks and evidence based results.

Observe

Call logs

Inspect conversation records, outcomes, performance, and charges.

Observe

Billing and invoices

Understand the wallet, call charges, payments, and invoice downloads.

API

API authentication

Create scoped API keys and authenticate server-side requests with zero ambiguity.

API

Calls API

Trigger outbound calls, stream real-time events, download recordings, and export call records.

API

Call object reference

Normalized call record structure returned by REST endpoints and webhooks.

API

Webhooks

Receive signed call lifecycle events with automatic retry and HMAC SHA-256 validation.

Deploy

Web voice widget

Add an agent-powered voice experience to an approved website.

API

Errors and troubleshooting matrix

Resolve all HTTP status codes and operational error messages without contacting support.

Operations

Troubleshooting

Resolve common authentication, calling, speech, latency, and billing issues.

Operations

Security and privacy

Operate Vozon with least privilege and responsible data handling.