Developer portalSign in
Vozon 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 platform or API.

01

Build

Configure behavior, voice, language, and tools.

02

Deploy

Connect a number or start calls through the API.

03

Improve

Use transcripts, outcomes, and cost data to iterate.

Your application
Vozon API
Voice agent
Customer
Call events

Start here

Quickstart

A production-ready first call has four parts.

1

Create an agent

Open Agents, select New agent, choose a starting template, and give the agent a clear name.
2

Configure the conversation

Select the caller’s language and voice. Add a first message and instructions describing goals, boundaries, escalation, and completion criteria.
3

Test before deployment

Use the browser test call. Verify pronunciation, interruptions, tool behavior, and the final outcome with realistic conversations.
4

Connect a phone number

Import or purchase a number, assign the agent, choose the permitted direction, and place a controlled live call.
Start with one narrow outcome. A focused appointment-booking or qualification agent is easier to test and improve than a single agent responsible for every business process.

Build

Configure an agent

Agent configuration controls what the agent says, how it sounds, which information it can use, and which 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
1. Select language and voice2. Write precise instructions3. Save before testing

First message

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

Instructions

Write goals in priority order. Include explicit rules for confirmation, transfer, and ending.

Language and voice

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

Tools

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

Knowledge bases

Attach approved text, files, or public pages to an agent. Keep each source current, specific, and free of credentials or unnecessary personal information.

  1. 1. Add a source. Choose text, URL, or file upload.
  2. 2. Wait for indexing. The source must show Ready before calls use it.
  3. 3. Test retrieval. Search for representative customer questions and verify the returned passages.

Phone numbers

A number must be Ready, assigned to an agent, and enabled for the intended direction before it can accept or place calls.

DirectionAccepts inboundPlaces outbound
InboundYesNo
OutboundNoYes
BothYesYes

Campaigns

Campaigns coordinate outbound calls across a lead list. Validate consent, calling hours, number formatting, and suppression rules before launch.

1 →Create campaign
2 →Upload leads
3 →Review & launch
4 →Monitor outcomes
Pause stops new calls from starting. It does not interrupt a call already in progress. Cancel only when the campaign should not resume.

Call logs

Use call logs as the operational record for status, duration, transcript, recording, structured output, latency, usage, and customer charges.

Conversation

Transcript, recording, direction, participants

Performance

End-to-end latency, duration, completion state

Business result

Extracted data, disposition, campaign and metadata

Billing

Completed-call charges are deducted from the organization wallet. The customer total combines metered call usage with the Vozon platform fee. Billing displays the wallet balance, monthly charges, payments, and downloadable invoices.

Metered call usage+Vozon platform fee=Customer total

API reference

Authentication

Create an API key in Dashboard → Developers. Send it as a Bearer token on every API request.

Shell
Authorization: Bearer avp_your_api_key
API keys are secrets. Show a key only once, store it in a secrets manager, restrict its scopes, and revoke it immediately if exposed. Never put a key in browser code or public documentation.

Calls API

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

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

Create an outbound 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"
    }
  }
}

Webhooks

Register an HTTPS endpoint in the Developer portal and subscribe to call.started, call.ended, call.failed, or 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

Validate the request signature using the endpoint secret.

Acknowledge

Return a 2xx response quickly before doing slow work.

Deduplicate

Store the event id and safely ignore repeated deliveries.

Errors

400Invalid requestCorrect fields or formatting; do not retry unchanged.
401Authentication requiredCheck the API key and Authorization header.
403Insufficient permissionUse a key with the required scope and organization role.
404Resource not foundConfirm the id belongs to the active organization.
409Resource conflictRefresh state, resolve the conflict, then retry.
429Rate limitedRetry with exponential backoff and jitter.
5xxTemporary service errorRetry idempotent operations with bounded backoff.

Operations

Production security checklist

✓Keep credentials in a secrets manager and rotate them on a defined schedule.
✓Use least-privilege API scopes and separate keys by environment.
✓Restrict dashboard roles and remove members who no longer need access.
✓Collect only the customer data required for the stated call purpose.
✓Define retention and access rules for transcripts, recordings, and exports.
✓Verify webhook signatures and reject stale or replayed deliveries.
✓Test consent, disclosure, calling hours, suppression, and escalation requirements for every market.

Documentation library

Explore every guide

Detailed workflows, field references, code samples, and production checklists.

Download OpenAPI →
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

Campaigns

Create controlled outbound campaigns from lead lists.

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.

API

Calls API

Start outbound calls and retrieve normalized call records.

API

Call object

Reference for normalized call records returned by the API and webhooks.

API

Webhooks

Receive signed call lifecycle events with safe retry handling.

Deploy

Web voice widget

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

API

Errors and retries

Handle validation, authorization, conflicts, limits, and temporary failures.

Operations

Troubleshooting

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

Operations

Security and privacy

Operate Vozon with least privilege and responsible data handling.