AI Voice Assistant
Try Free
Developer Resources

AI Voice Assistant API

Build powerful voice AI applications with our REST API. Initiate calls, manage agents, receive webhooks, and access analytics programmatically.

View on GitHub

API Capabilities

Enterprise-grade API infrastructure

API Key Authentication

Secure Bearer token authentication with scoped permissions.

Low Latency

Sub-100ms API response times for real-time operations.

Global Edge

API endpoints served from edge locations worldwide.

99.9% Uptime

Enterprise-grade reliability with SLA guarantees.

Real-time Webhooks

Instant notifications for call events and updates.

JSON Responses

Clean, consistent JSON format across all endpoints.

Quick Start

Make your first API call in minutes

1

Get API Key

Sign up and generate your API key from the dashboard

2

Configure Agent

Create an AI agent with your custom prompt and voice

3

Make Calls

Use the API to initiate outbound calls or handle inbound

Example: Initiate Outbound Call

cURL

curl -X POST https://voice-agent.edesy.in/api/v1/calls/outbound \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "+919876543210",
    "agent_id": "agent_abc123",
    "context": {
      "customer_name": "Raj",
      "order_id": "ORD-12345"
    }
  }'

Python

import requests

response = requests.post(
    "https://voice-agent.edesy.in/api/v1/calls/outbound",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "phone_number": "+919876543210",
        "agent_id": "agent_abc123",
        "context": {
            "customer_name": "Raj",
            "order_id": "ORD-12345"
        }
    }
)

call = response.json()
print(f"Call ID: {call['id']}")

Node.js

const response = await fetch(
  'https://voice-agent.edesy.in/api/v1/calls/outbound',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      phone_number: '+919876543210',
      agent_id: 'agent_abc123',
      context: {
        customer_name: 'Raj',
        order_id: 'ORD-12345',
      },
    }),
  }
);

const call = await response.json();
console.log('Call ID:', call.id);

API Endpoints

Core endpoints for voice AI operations

Method
Endpoint
Description
POST
/v1/calls/outbound

Initiate an outbound AI voice call

GET
/v1/calls/{call_id}

Get call details and transcript

POST
/v1/agents

Create a new AI voice agent

GET
/v1/agents

List all configured agents

POST
/v1/webhooks

Register webhook endpoint

GET
/v1/analytics

Get call analytics and metrics

Webhook Events

Real-time notifications for call lifecycle events

call.started

Triggered when a call begins

call.completed

Triggered when a call ends

call.transferred

Triggered when call transfers to human

transcript.ready

Triggered when transcript is available

agent.updated

Triggered when agent config changes

error.occurred

Triggered on call errors

Webhook Payload Example

{
  "event": "call.completed",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "call_id": "call_xyz789",
    "agent_id": "agent_abc123",
    "phone_number": "+919876543210",
    "duration_seconds": 180,
    "status": "completed",
    "transcript_url": "https://voice-agent.edesy.in/api/v1/calls/call_xyz789/transcript"
  }
}

Authentication

All API requests require authentication using Bearer tokens. Include your API key in the Authorization header.

API keys are scoped to your organization

Create multiple keys for different environments

Keys can be rotated without downtime

Webhook secrets for payload verification

Authorization Header

Authorization: Bearer sk_live_xxxxxxxxxxxxx

Replace sk_live_xxxxxxxxxxxxx with your actual API key from the dashboard.

Official SDKs

Get started faster with our official libraries

Python

pip install edesy-voice

Node.js

npm install @edesy/voice

PHP

composer require edesy/voice

Related Resources

Explore more about AI Voice Assistant

API FAQ

Common questions about API integration

How do I get API access?

API access is included with all paid plans. Sign up for a free trial to get your API key. Enterprise customers get dedicated API keys with higher rate limits.

What are the rate limits?

Standard plans include 100 requests/minute. Enterprise plans have custom rate limits up to 10,000 requests/minute. Rate limit headers are included in all responses.

Is there a sandbox environment?

Yes, we provide a sandbox environment for testing. Sandbox calls use test phone numbers and don't incur charges. Perfect for development and integration testing.

How do webhooks work?

Register your webhook URL via the API or dashboard. We'll send POST requests with event payloads signed with your webhook secret. Retry logic handles temporary failures.

Can I use the API with my own telephony?

Yes, our API supports BYOT (Bring Your Own Telephony). Connect your Twilio, Exotel, or other SIP-compatible telephony provider.

What SDKs are available?

We provide official SDKs for Python, Node.js, and PHP. Community SDKs are available for Go, Ruby, and Java. All SDKs are open source on GitHub.

Ready to Build with Our API?

Get your API key and start building in minutes

View Pricing

Hear AI Voice Assistant in Action

Real demo calls showcasing low latency and natural conversations in multiple Indian languages

Hindi + English
Lead Qualification

B2B Lead Qualification - Flipkart Gift

AI voice agent qualifying B2B leads for corporate gifting. Ultra-low latency with 1-2 second response time. Bilingual conversation in Hindi and English.

1-2 second response latencyBilingual Hindi + English

Audio player powered by Google Drive

Open in Drive
Malayalam
Education

Institute Admission - Malayalam

AI voice agent handling admission inquiries and appointment booking for educational institutes in Malayalam language.

Malayalam language supportEducation sector use case

Audio player powered by Google Drive

Open in Drive
Tamil
Education

Institute Admission - Tamil

AI voice agent handling admission inquiries and appointment booking for educational institutes in Tamil language.

Tamil language supportEducation sector use case

Audio player powered by Google Drive

Open in Drive
Assamese
Lead Qualification

Solar Company Lead Qualification - Assamese

AI voice agent qualifying leads for solar installation company in Assamese language. Natural conversation flow with product inquiry handling.

Assamese language supportSolar/renewable energy sector

Audio player powered by Google Drive

Open in Drive
Bengali
Appointment Booking

Hospital Appointment Booking - Bengali

AI voice bot helping patients book hospital appointments in Bengali. Natural conversation with availability checking and confirmation.

Bengali language supportHospital appointment booking

Audio player powered by Google Drive

Open in Drive
Hindi
Appointment Booking

Hospital Appointment Booking - Hindi

AI voice bot helping patients book hospital appointments in Hindi. Handles doctor selection, time slot booking, and confirmation.

Hindi language supportHospital appointment booking

Audio player powered by Google Drive

Open in Drive
Telugu
Appointment Booking

Hospital Appointment Booking - Telugu

AI voice bot helping patients book hospital appointments in Telugu. Natural conversation flow for healthcare scheduling.

Telugu language supportHospital appointment booking

Audio player powered by Google Drive

Open in Drive

Simple, Transparent Pricing

Best AI voice agent pricing worldwide - from ₹4/min ($0.04) | 40% more affordable than US alternatives

Pay As You Go
₹6/ minute + telephony$0.07/min
Start immediately, pay per minute
  • No monthly commitment
  • Standard AI providers included
  • Twilio/Exotel integration
  • Call analytics dashboard
  • 8+ Indian languages
  • 24/7 availability
Get Started
Most Popular
Pro
₹1,499/ month$18/month
For growing businesses
  • ₹5/min ($0.06) platform rate
  • 300 minutes included
  • Everything in Pay As You Go
  • Priority support
  • Advanced analytics
  • Custom phone numbers
  • Webhook integrations
Start Free Trial
Max
₹4,999/ month$60/month
For high-volume operations
  • ₹4.50/min ($0.05) platform rate
  • 1,100 minutes included
  • Everything in Pro
  • 20% off premium add-ons
  • Custom AI training
  • Dedicated support
  • Multiple phone numbers
Ultra
₹14,999/ month$180/month
Maximum value for enterprises
  • ₹4/min ($0.04) platform rate - lowest
  • 3,500 minutes included
  • Everything in Max
  • 30% off premium add-ons
  • Dedicated infrastructure
  • 99.9% uptime SLA
  • White-label option
  • Dedicated account manager