Call Intelligence API

Call Intelligence Quickstart

Get up and running with the Vozzo Call Intelligence API in minutes. This guide will walk you through uploading your first call recording and extracting AI-powered insights.

Prerequisites

Before you begin, ensure you have:

A Vozzo account with API access
Your API key (format: Bearer YOUR_JWT_TOKEN)
Organization UUID from your Vozzo account settings
Call recording file in supported format (WAV, MP3, OGG, WebM, max 100MB)

Step 1: Create an Analysis Use Case

First, create a use case to define how your call recordings should be analyzed. Use cases help organize recordings by scenario (sales, support, compliance, etc.).

Code
 
curl --request POST \
  --url https://backend.vozzo.ai/v1alpha/callintel/usecase \
  --header 'Authorization: Bearer YOUR_JWT_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
    "usecase_name": "Lead Generation Analysis",
    "usecase_desc": "Analyze sales calls for lead qualification",
    "tags": ["sales", "lead-gen", "quality"],
    "buckets": ["hot-leads", "warm-leads", "cold-leads"],
    "analysis_config": {
      "enable_sentiment": true,
      "enable_transcript": true,
      "enable_summary": true,
      "enable_compliance": false,
      "analysis_questions": [
        "Is the lead interested in the product? (Yes/No)",
        "What is the lead'\''s budget range?",
        "When does the lead want to start?"
      ],
      "analysis_buckets": [
        {
          "objective_bucket_name": "Hot Lead",
          "description": "Lead shows strong interest and has budget"
        },
        {
          "objective_bucket_name": "Warm Lead",
          "description": "Lead shows moderate interest, needs follow-up"
        },
        {
          "objective_bucket_name": "Cold Lead",
          "description": "Lead shows little or no interest"
        }
      ]
    }
  }'

Understanding Use Case Parameters

Parameter	Description	Example
org_uuid	Your organization identifier	33bbb237-...
usecase_name	Human-readable name for the use case	"Lead Generation"
tags	Labels for organizing use cases	["sales", "quality"]
analysis_questions	Custom questions to answer from calls	["Is lead interested?"]
analysis_buckets	Categories for automatic classification	Hot/Warm/Cold Leads

Expected Response:


Code
 
{
  "usecase_uuid": "815545c1-61c1-4ec7-aa14-365a07909937",
  "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
  "usecase_name": "Lead Generation Analysis",
  "usecase_desc": "Analyze sales calls for lead qualification",
  "tags": ["sales", "lead-gen", "quality"],
  "buckets": ["hot-leads", "warm-leads", "cold-leads"],
  "is_active": true,
  "created_at": "2025-12-04T09:21:58.743598Z",
  "updated_at": "2025-12-04T09:21:58.743598Z"
}

Success! Save the usecase_uuid for uploading recordings.

Step 2: Generate Upload Link

Request a secure presigned URL for uploading your call recording. This is the recommended two-step upload process.

Code
 
curl --request POST \
  --url https://backend.vozzo.ai/v1alpha/callintel/acme-corp/default/create-upload-link \
  --header 'Authorization: Bearer YOUR_JWT_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "file_name": "sales-call-2024-01-15.webm",
    "file_size": 357741,
    "content_type": "audio/webm",
    "metadata": {
      "usecase_uuid": "815545c1-61c1-4ec7-aa14-365a07909937",
      "call_date": "2024-01-15",
      "agent_id": "agent_001",
      "customer_id": "cust_12345",
      "call_type": "sales"
    }
  }'

Understanding Upload Parameters

Path parameters:

client_name: Your organization identifier (e.g., "acme-corp")
client_profile: Profile name for organizing uploads (e.g., "default", "sales-team")

Request body fields:

file_name: Original file name with extension
file_size: File size in bytes (max 104857600 = 100MB)
content_type: MIME type (audio/wav, audio/mp3, audio/webm, etc.)
metadata.usecase_uuid: Link recording to your analysis use case

Expected Response


Code
 
{
  "upload_url": "https://storage.vozzo.ai/upload/acme-corp/default/550e8400-e29b-41d4-a716-446655440000?signature=abc123",
  "file_key": "acme-corp/default/550e8400-e29b-41d4-a716-446655440000",
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "expires_at": "2025-12-04T11:30:00Z",
  "upload_instructions": {
    "method": "PUT",
    "headers": {
      "Content-Type": "application/octet-stream"
    },
    "timeout_seconds": 300
  }
}

Step 3: Upload the Recording

Use the presigned URL from Step 2 to upload your audio file. The URL is valid for 15 minutes.

Code
 
curl --request PUT \
  --url "UPLOAD_URL_FROM_STEP_2" \
  --header 'Content-Type: application/octet-stream' \
  --data-binary '@/path/to/your/recording.webm'

Upload Complete! The recording will now be automatically transcribed and analyzed. This typically takes 2-5 minutes depending on file length.

Step 4: Check Processing Status

List Recordings in Use Case

Code
 
curl --request POST \
  --url https://backend.vozzo.ai/v1alpha/callintel/org-usecases/recordings \
  --header 'Authorization: Bearer YOUR_JWT_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "usecase_uuid": "815545c1-61c1-4ec7-aa14-365a07909937",
    "page": 1,
    "limit": 10
  }'

Check Specific Recording Status

Code
 
curl --request POST \
  --url https://backend.vozzo.ai/v1alpha/callintel/org-usecases/get-recording-details \
  --header 'Authorization: Bearer YOUR_JWT_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
    "usecase_uuid": "815545c1-61c1-4ec7-aa14-365a07909937",
    "recording_uuid": "4cb66f57-f16b-461d-a670-6585b2fe9456"
  }'

Processing States

Initiated

Upload received, queued for processing

Transcription Completed

Audio transcribed, analysis in progress

Analysis Completed

Full analysis ready

Failed

Processing error occurred

Step 5: Retrieve Analysis Results

Once processing is complete, retrieve the transcript and AI-powered analytics for your call recording.

Get Transcript and Analytics

Code
 
curl --request POST \
  --url https://backend.vozzo.ai/v1alpha/callintel/org-usecases/recording/transcript-analytics \
  --header 'Authorization: Bearer YOUR_JWT_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
    "usecase_uuid": "815545c1-61c1-4ec7-aa14-365a07909937",
    "recording_uuid": "4cb66f57-f16b-461d-a670-6585b2fe9456"
  }'

Get Analytics Summary

Code
 
curl --request POST \
  --url https://backend.vozzo.ai/v1alpha/callintel/org-usecases/analytics/summary-counts \
  --header 'Authorization: Bearer YOUR_JWT_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
    "usecase_uuid": "815545c1-61c1-4ec7-aa14-365a07909937"
  }'

Get Detailed Analytics Breakdown

Code
 
curl --request POST \
  --url https://backend.vozzo.ai/v1alpha/callintel/org-usecases/analytics/summary-details \
  --header 'Authorization: Bearer YOUR_JWT_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
    "usecase_uuid": "815545c1-61c1-4ec7-aa14-365a07909937"
  }'

Alternative: Direct Upload (Experimental)

For simpler workflows, you can upload files directly in a single request. This is experimental and may have size limitations.

Code
 
curl --request POST \
  --url https://backend.vozzo.ai/v1alpha/callintel/acme-corp/default/direct-upload \
  --header 'Authorization: Bearer YOUR_JWT_TOKEN' \
  --form 'file=@/path/to/recording.webm' \
  --form 'usecase_uuid=815545c1-61c1-4ec7-aa14-365a07909937'

How To Integrate API's

Dev

Base URLhttps://backend.vozzo.ai

Prod

Base URLhttps://backend.vozzo.ai

Create Analysis Use Case

Endpoint

POST {{baseUrl}}/v1alpha/callintel/usecase

Create a new analysis use case with specific parameters, tags, and storage buckets. Use cases help organize and configure how call recordings are analyzed for different scenarios.

Request Body

org_uuidstring · uuidrequired

Unique identifier of the organization

usecase_namestringrequired

Name of the use case

usecase_descstringrequired

Description of the use case

tagsstring[]

List of tags associated with the use case

bucketsstring[]

Buckets used to categorize or group data

analysis_configobject

Configuration for analysis parameters

curl --request POST \
  --url https://backend.vozzo.ai/v1alpha/callintel/usecase \
  --header 'Authorization: <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
    "usecase_name": "Lead generation",
    "usecase_desc": "Analyze sales calls for quality",
    "tags": ["sales", "quality"],
    "buckets": ["bucket1", "bucket2"],
    "analysis_config": {
      "analysis_questions": [
        "If the lead is interested in the loan offer. (Yes/No)"
      ],
      "analysis_buckets": [
        {
          "objective_bucket_name": "Hot Lead",
          "description": "If user is interested in the loan offer."
        },
        {
          "objective_bucket_name": "Warm Lead",
          "description": "if user shows no interest."
        },
        {
          "objective_bucket_name": "Not Clear",
          "description": "if it is not clear that user is not interested in loan offer."
        }
      ]
    }
  }'

Example Request Body


Code
 
{
  "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
  "usecase_name": "Lead generation",
  "usecase_desc": "Analyze sales calls for quality",
  "tags": ["sales", "quality"],
  "buckets": ["bucket1", "bucket2"],
  "analysis_config": {
    "enable_sentiment": true,
    "enable_transcript": true,
    "enable_summary": true,
    "analysis_questions": [
      "If the lead is interested in the loan offer. (Yes/No)"
    ],
    "analysis_buckets": [
      {
        "objective_bucket_name": "Hot Lead",
        "description": "If user is interested in the loan offer."
      },
      {
        "objective_bucket_name": "Warm Lead", 
        "description": "if user shows no interest."
      }
    ]
  }
}

Get Use Case Details

Endpoint

GET {{baseUrl}}/v1alpha/callintel/usecase/{usecase_uuid}

Retrieve detailed information about a specific analysis use case, including configuration, tags, buckets, and metadata.

Path Parameters

usecase_uuidstring · uuidrequired

Unique identifier of the use case

curl --request GET \
  --url https://backend.vozzo.ai/v1alpha/callintel/usecase/:usecase_uuid \
  --header 'Authorization: <YOUR_API_KEY>'

Example Response


Code
 
{
  "usecase_uuid": "815545c1-61c1-4ec7-aa14-365a07909937",
  "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
  "usecase_name": "Lead generation",
  "usecase_desc": "Analyze sales calls for quality",
  "tags": ["sales", "quality"],
  "buckets": ["bucket1", "bucket2"],
  "analysis_config": {
    "analysis_questions": [
      "If the lead is interested in the loan offer. (Yes/No)"
    ],
    "analysis_buckets": [
      {
        "objective_bucket_name": "Hot Lead",
        "description": "If user is interested in the loan offer."
      }
    ]
  },
  "is_active": true,
  "created_at": "2025-12-04T09:21:58.743598Z",
  "updated_at": "2025-12-04T09:21:58.743598Z"
}

Update Use Case

Endpoint

PUT {{baseUrl}}/v1alpha/callintel/usecase/{usecase_uuid}

Update an existing analysis use case with new metadata, tags, buckets, or configuration.

Request Body

org_uuid

string · uuid

usecase_name

string

usecase_desc

string

Path Parameters

usecase_uuidstring · uuidrequired

Unique identifier of the use case to delete

curl --request DELETE \
  --url https://backend.vozzo.ai/v1alpha/callintel/usecase/:usecase_uuid \
  --header 'Authorization: <YOUR_API_KEY>'

Example Response


Code
 
{
  "message": "Use case deleted successfully",
  "usecase_uuid": "dab80fa1-8bd1-4411-9333-c46970d27a1a"
}

Get Organization Use Cases

Endpoint

GET {{baseUrl}}/v1alpha/callintel/org-usecases/{org_uuid}

Retrieve a paginated list of all use cases for an organization with usage statistics.

Path Parameters

org_uuidstring · uuidrequired

Unique identifier of the organization

Query Parameters

pageintegerdefault: 1

Page number for pagination

limitintegerdefault: 10

Number of use cases per page

tagstringoptional

Filter use cases by tag

curl --request GET \
  --url https://backend.vozzo.ai/v1alpha/callintel/org-usecases/:org_uuid \
  --header 'Authorization: <YOUR_API_KEY>'

Example Response


Code
 
{
  "data": [
    {
      "usecase_uuid": "dab80fa1-8bd1-4411-9333-c46970d27a1a",
      "usecase_name": "Sales Quality Check",
      "created_at": "2025-12-03T11:08:54.665989+00:00",
      "updated_at": "2025-12-03T05:51:18.114878+00:00",
      "total_recordings": 17
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 10,
  "total_pages": 1
}

Create Secure Upload Link

Endpoint

POST {{baseUrl}}/v1alpha/callintel/{client_name}/{client_profile}/create-upload-link

Generate a pre-signed URL for securely uploading call recordings. This is the recommended two-step upload process: first get the upload link, then upload the file.

Path Parameters

client_namestringrequired

Client organization identifier

client_profilestringrequired

Profile name for organizing analysis requests

Request Body

file_namestringrequired

Original file name with extension

file_sizeintegermax: 100MB

File size in bytes

content_typestringrequired

MIME type of the file

metadataobjectoptional

Optional metadata about the call for enhanced analysis

curl --request POST \
  --url https://backend.vozzo.ai/v1alpha/callintel/:client_name/:client_profile/create-upload-link \
  --header 'Authorization: <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "file_name": "test.webm",
    "file_size": 357741,
    "content_type": "audio/webm",
    "metadata": {
      "usecase_uuid": "dab80fa1-8bd1-4411-9333-c46970d27a1a",
      "call_date": "2025-12-04",
      "call_type": "sales"
    }
  }'

Example Request


Code
 
{
  "file_name": "test.webm",
  "file_size": 357741,
  "content_type": "audio/webm",
  "metadata": {
    "usecase_uuid": "dab80fa1-8bd1-4411-9333-c46970d27a1a",
    "call_date": "2025-12-04",
    "call_type": "sales"
  }
}

Example Response


Code
 
{
  "upload_url": "https://storage.vozzo.ai/upload/acme-corp/default/550e8400-e29b-41d4-a716-446655440000?signature=abc123",
  "file_key": "acme-corp/default/550e8400-e29b-41d4-a716-446655440000",
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "expires_at": "2025-12-04T11:30:00Z",
  "upload_instructions": {
    "method": "PUT",
    "headers": {
      "Content-Type": "application/octet-stream"
    },
    "timeout_seconds": 300
  }
}

Direct Upload

Endpoint

POST {{baseUrl}}/v1alpha/callintel/{client_name}/{client_profile}/direct-upload

Directly upload a call recording in a single request. This experimental endpoint handles both file upload and analysis request creation in one step.

Path Parameters

client_namestringrequired

Client organization identifier

client_profilestringrequired

Profile name for organizing analysis requests

Request Body

filefile (binary)required

Audio file to upload

usecase_uuidstring · uuidoptional

Optional use case UUID for analysis configuration

curl --request POST \
  --url https://backend.vozzo.ai/v1alpha/callintel/:client_name/:client_profile/direct-upload \
  --header 'Authorization: <YOUR_API_KEY>' \
  --header 'Content-Type: multipart/form-data' \
  --form file=@file.webm \
  --form usecase_uuid=00000000-0000-0000-0000-000000000000

Example Response


Code
 
{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "file_name": "test.webm",
  "file_size": 357741,
  "status": "pending",
  "created_at": "2025-12-04T09:30:00Z"
}

Get Use Case Recordings

Endpoint

POST {{baseUrl}}/v1alpha/callintel/org-usecases/recordings

Retrieve a paginated list of all recordings associated with a specific use case, including processing status and metadata.

Request Body

usecase_uuidstring · uuidrequired

Unique identifier of the use case

pageintegeroptional

Page number for pagination (default: 1)

limitintegeroptional

Number of recordings per page (default: 10)

statusstringoptional

Filter by processing state: INITIATED, TRANSCRIPTION_COMPLETED, ANALYSIS_COMPLETED, FAILED

from_datestring · date-timeoptional

Start date filter

to_datestring · date-timeoptional

End date filter

curl --request POST \
  --url https://backend.vozzo.ai/v1alpha/callintel/org-usecases/recordings \
  --header 'Authorization: <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "usecase_uuid": "dab80fa1-8bd1-4411-9333-c46970d27a1a",
    "page": 1,
    "limit": 10
  }'

Example Request


Code
 
{
  "usecase_uuid": "dab80fa1-8bd1-4411-9333-c46970d27a1a",
  "page": 1,
  "limit": 10
}

Example Response


Code
 
{
  "data": [
    {
      "recording_uuid": "1c43a668-1c11-4993-9059-6366250686d7",
      "file_name": "d586a7a6-39d4-49c0-94ad-891fd9c7d43c.webm",
      "transcription_ref": "s3://vozzo-call-intel-dev/vozzodev-org/default/transcription/d586a7a6-39d4-49c0-94ad-891fd9c7d43c.json",
      "processing_state": "TRANSCRIPTION_COMPLETED",
      "is_active": true,
      "updated_at": "2025-12-04T03:31:49.152074+00:00",
      "file_metadata": {
        "bucket": "vozzo-call-intel-dev",
        "client_org": "vozzodev-org",
        "request_id": "d586a7a6-39d4-49c0-94ad-891fd9c7d43c",
        "client_profile": "default",
        "analysis_config": {
          "analysis_buckets": [
            {
              "description": "If user is interested in the loan offer.",
              "objective_bucket_name": "Hot Lead"
            }
          ],
          "analysis_questions": [
            "If the lead is interested in the loan offer. (Yes/No)"
          ]
        }
      },
      "usecase_uuid": "dab80fa1-8bd1-4411-9333-c46970d27a1a",
      "analysis_ref": "s3://vozzo-call-intel-dev/vozzodev-org/default/analysis/d586a7a6-39d4-49c0-94ad-891fd9c7d43c.json",
      "processing_history": [
        {
          "state": "INITIATED",
          "timestamp": "2025-11-19T23:50:51.309810"
        }
      ],
      "created_at": "2025-12-04T03:31:49.152074+00:00"
    }
  ],
  "total": 17,
  "page": 1,
  "limit": 10,
  "total_pages": 2
}

Get Recording Details

Endpoint

POST {{baseUrl}}/v1alpha/callintel/org-usecases/get-recording-details

Retrieve detailed information about a specific recording including metadata, processing history, and file information.

Request Body Parameters

org_uuidstring · uuidrequired

Unique identifier of the organization

usecase_uuidstring · uuidrequired

Unique identifier of the use case

recording_uuidstring · uuidrequired

Unique identifier of the recording

curl --request POST \
  --url https://backend.vozzo.ai/v1alpha/callintel/org-usecases/get-recording-details \
  --header 'Authorization: <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
    "usecase_uuid": "dab80fa1-8bd1-4411-9333-c46970d27a1a",
    "recording_uuid": "4cb66f57-f16b-461d-a670-6585b2fe9456"
  }'

Example Request


Code
 
{
  "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
  "usecase_uuid": "dab80fa1-8bd1-4411-9333-c46970d27a1a",
  "recording_uuid": "4cb66f57-f16b-461d-a670-6585b2fe9456"
}

Example Response


Code
 
 {
   "file_metadata": {
     "bucket": "vozzo-call-intel-dev",
     "client_org": "vozzodev-org",
     "request_id": "4d2d68a1-5d25-4154-9dc4-b862196903ca",
     "client_profile": "default",
     "analysis_config": {
       "analysis_buckets": [
         { "objective_bucket_name": "Hot Lead", "description": "If user is interested in the loan offer." }
       ],
       "analysis_questions": ["If the lead is interested in the loan offer. (Yes/No)"]
     },
     "analysis_object_key": "vozzodev-org/default/analysis/4d2d68a1-5d25-4154-9dc4-b862196903ca.json",
     "recording_file_name": "4d2d68a1-5d25-4154-9dc4-b862196903ca.webm",
     "recording_file_size": 357741,
     "recording_object_key": "vozzodev-org/default/recordings/4d2d68a1-5d25-4154-9dc4-b862196903ca.webm",
     "recording_file_extension": ".webm",
     "transcription_object_key": "vozzodev-org/default/transcription/4d2d68a1-5d25-4154-9dc4-b862196903ca.json"
   },
   "usecase_uuid": "dab80fa1-8bd1-4411-9333-c46970d27a1a",
   "analysis_ref": "s3://vozzo-call-intel-dev/vozzodev-org/default/analysis/4d2d68a1-5d25-4154-9dc4-b862196903ca.json",
   "processing_history": [{"state": "INITIATED","timestamp": "2025-11-19T23:59:39.665614"}],
   "created_at": "2025-12-04T03:31:49.152074+00:00",
   "file_name": "4d2d68a1-5d25-4154-9dc4-b862196903ca.webm",
   "recording_uuid": "4cb66f57-f16b-461d-a670-6585b2fe9456",
   "transcription_ref": "s3://vozzo-call-intel-dev/vozzodev-org/default/transcription/4d2d68a1-5d25-4154-9dc4-b862196903ca.json",
   "processing_state": "INITIATED",
   "is_active": true,
   "updated_at": "2025-12-04T03:31:49.152074+00:00"
 }

Get Recording Transcript and Analytics

Endpoint

POST {{baseUrl}}/v1alpha/callintel/org-usecases/recording/transcript-analytics

Retrieve complete transcript and analytics for a specific recording including speaker analysis, timestamps, and confidence scores.

Request Body Parameters

org_uuidstring · uuidrequired

Unique identifier of the organization

usecase_uuidstring · uuidrequired

Unique identifier of the use case

recording_uuidstring · uuidrequired

Unique identifier of the recording

curl --request POST \
  --url https://backend.vozzo.ai/v1alpha/callintel/org-usecases/recording/transcript-analytics \
  --header 'Authorization: <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
    "usecase_uuid": "dab80fa1-8bd1-4411-9333-c46970d27a1a",
    "recording_uuid": "4cb66f57-f16b-461d-a670-6585b2fe9456"
  }'

Example Request


Code
 
{
  "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
  "usecase_uuid": "dab80fa1-8bd1-4411-9333-c46970d27a1a",
  "recording_uuid": "4cb66f57-f16b-461d-a670-6585b2fe9456"
}

Example Response


Code
 
{
  "transcript": {
    "jobName": "default__recordings__4d2d68a1-5d25-4154-9dc4-b862196903ca.webm__948b7ca3-20df-4ee6-87db-bba99a05ce34",
    "accountId": "626635402027",
    "status": "COMPLETED",
    "results": {
      "language_code": "hi-IN",
      "transcripts": [
        {
          "transcript": "नमस्ते अपर्णा जी मैं नेहा श्रीराम फाइनेंस से बोल रही हूँ । कैसे हैं आप आईएम हैविंग टब हंग । मैं ठीक है । बहुत अच्छा अपर्णा जी धन्यवाद । ..."
        }
      ]
    }
  },
  "analytics": {}
}

Get Analytics Summary Counts

Endpoint

POST {{baseUrl}}/v1alpha/callintel/org-usecases/analytics/summary-counts

Retrieve high-level summary counts for a specific use case including total calls, completed analytics, and completion percentages.

Request Body Parameters

org_uuidstring · uuidrequired

Unique identifier of the organization

usecase_uuidstring · uuidrequired

Unique identifier of the use case

curl --request POST \
  --url https://backend.vozzo.ai/v1alpha/callintel/org-usecases/analytics/summary-counts \
  --header 'Authorization: <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
    "usecase_uuid": "dab80fa1-8bd1-4411-9333-c46970d27a1a"
  }'

Example Request


Code
 
{
  "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
  "usecase_uuid": "dab80fa1-8bd1-4411-9333-c46970d27a1a"
}

Example Response


Code
 
{
  "total_calls": 18,
  "total_analytics_completed": 0,
  "percentage_analytics_completed": 0.0
}

Get Detailed Analytics Summary

Endpoint

POST {{baseUrl}}/v1alpha/callintel/org-usecases/analytics/summary-details

Retrieve detailed analytics summary for a use case including categorization and tagging breakdowns. This endpoint provides insights into how recordings are categorized and tagged within the use case.

Request Body Parameters

org_uuidstring · uuidrequired

Unique identifier of the organization

usecase_uuidstring · uuidrequired

Unique identifier of the use case

curl --request POST \
  --url https://backend.vozzo.ai/v1alpha/callintel/org-usecases/analytics/summary-details \
  --header 'Authorization: <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
    "usecase_uuid": "815545c1-61c1-4ec7-aa14-365a07909937"
  }'

Example Request


Code
 
{
  "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
  "usecase_uuid": "815545c1-61c1-4ec7-aa14-365a07909937"
}

Example Response


Code
 
  {
    "categories": {
      "Others": 4
    },
    "tags": {
      "null": 4
    }
  }

Get Audio Presigned URL

Endpoint

POST {{baseUrl}}/v1alpha/callintel/org-usecases/recording/get-audio-presigned-url

Generate a presigned URL for securely accessing and streaming an audio recording. The URL is time-limited and provides direct access to the stored audio file.

Request Body Parameters

s3_keystringrequired

S3 object key for the audio recording

curl --request POST \
  --url https://backend.vozzo.ai/v1alpha/callintel/org-usecases/recording/get-audio-presigned-url \
  --header 'Authorization: <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "s3_key": "vozzodev-org/default/recordings/4d2d68a1-5d25-4154-9dc4-b862196903ca.webm"
  }'

Example Request


Code
 
  {
    "s3_key": "vozzodev-org/default/recordings/4d2d68a1-5d25-4154-9dc4-b862196903ca.webm"
  }

Example Response


Code
 
  {
    "presigned_url": "https://vozzo-call-intel-dev.s3.amazonaws.com/vozzodev-org/default/recordings/4d2d68a1-5d25-4154-9dc4-b862196903ca.webm?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIAZDZTBNMVXR4CTDQD%2F20251219%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251219T124531Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEOX...&X-Amz-Signature=8a69d01e8e6c3cc96b7a6e4954d65a1a5c192bed2818d6ac85aa59a98d375a5c"
  }

Common Pitfalls & Solutions

Problem: "Invalid or expired authentication token"

Solution: Ensure your API key is formatted correctly as Token YOUR_SECRET_API_KEY (with "Token" prefix)

Problem: "Agent not found"

Solution: Verify your agent UUID exists in the Vozzo platform and you have access to it

Problem: "Invalid phone number format"

Solution: Use E.164 format with country code: +[country_code][number] (e.g., +911234567890)

Problem: "Invalid date format"

Solution: Use YYYY-MM-DD format for dates (e.g., 2026-01-04)

Problem: "Metadata must be a valid JSON string"

Solution: Ensure metadata is a JSON string, not an object: "{"key":"value"}", not {"key":"value"}

Best Practices

Start Small

Begin with 2-5 test recipients before scaling to hundreds or thousands

Use Descriptive Names

Name campaigns clearly: "Q1_2026_Product_Launch" instead of "Campaign_1"

Set Realistic Time Windows

Consider recipient timezones and avoid early morning or late evening calls

Implement Error Handling

Always check response status codes and handle errors gracefully

Monitor Performance

Regularly check analytics to optimize retry settings and calling windows

Respect Privacy

Only call numbers with proper consent and follow local regulations

Next Steps

Explore API Reference

Dive deep into all available endpoints and parameters

View API Reference →

Support

Need help? We're here for you:

Email:support@vozzo.ai
Community Forum:Join discussions with other developers
Documentation:Comprehensive guides and examples
Issue Tracker:Report bugs and request features

Last modified on February 23, 2026

Introduction Make a Call

Call Intelligence API

Call Intelligence Quickstart

Get up and running with the Vozzo Call Intelligence API in minutes. This guide will walk you through uploading your first call recording and extracting AI-powered insights.

Prerequisites

Before you begin, ensure you have:

A Vozzo account with API access
Your API key (format: Bearer YOUR_JWT_TOKEN)
Organization UUID from your Vozzo account settings
Call recording file in supported format (WAV, MP3, OGG, WebM, max 100MB)

Step 1: Create an Analysis Use Case

First, create a use case to define how your call recordings should be analyzed. Use cases help organize recordings by scenario (sales, support, compliance, etc.).

Code
 
curl --request POST \
  --url https://backend.vozzo.ai/v1alpha/callintel/usecase \
  --header 'Authorization: Bearer YOUR_JWT_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
    "usecase_name": "Lead Generation Analysis",
    "usecase_desc": "Analyze sales calls for lead qualification",
    "tags": ["sales", "lead-gen", "quality"],
    "buckets": ["hot-leads", "warm-leads", "cold-leads"],
    "analysis_config": {
      "enable_sentiment": true,
      "enable_transcript": true,
      "enable_summary": true,
      "enable_compliance": false,
      "analysis_questions": [
        "Is the lead interested in the product? (Yes/No)",
        "What is the lead'\''s budget range?",
        "When does the lead want to start?"
      ],
      "analysis_buckets": [
        {
          "objective_bucket_name": "Hot Lead",
          "description": "Lead shows strong interest and has budget"
        },
        {
          "objective_bucket_name": "Warm Lead",
          "description": "Lead shows moderate interest, needs follow-up"
        },
        {
          "objective_bucket_name": "Cold Lead",
          "description": "Lead shows little or no interest"
        }
      ]
    }
  }'

Understanding Use Case Parameters

Parameter	Description	Example
org_uuid	Your organization identifier	33bbb237-...
usecase_name	Human-readable name for the use case	"Lead Generation"
tags	Labels for organizing use cases	["sales", "quality"]
analysis_questions	Custom questions to answer from calls	["Is lead interested?"]
analysis_buckets	Categories for automatic classification	Hot/Warm/Cold Leads

Expected Response:


Code
 
{
  "usecase_uuid": "815545c1-61c1-4ec7-aa14-365a07909937",
  "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
  "usecase_name": "Lead Generation Analysis",
  "usecase_desc": "Analyze sales calls for lead qualification",
  "tags": ["sales", "lead-gen", "quality"],
  "buckets": ["hot-leads", "warm-leads", "cold-leads"],
  "is_active": true,
  "created_at": "2025-12-04T09:21:58.743598Z",
  "updated_at": "2025-12-04T09:21:58.743598Z"
}

Success! Save the usecase_uuid for uploading recordings.

Step 2: Generate Upload Link

Request a secure presigned URL for uploading your call recording. This is the recommended two-step upload process.

Code
 
curl --request POST \
  --url https://backend.vozzo.ai/v1alpha/callintel/acme-corp/default/create-upload-link \
  --header 'Authorization: Bearer YOUR_JWT_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "file_name": "sales-call-2024-01-15.webm",
    "file_size": 357741,
    "content_type": "audio/webm",
    "metadata": {
      "usecase_uuid": "815545c1-61c1-4ec7-aa14-365a07909937",
      "call_date": "2024-01-15",
      "agent_id": "agent_001",
      "customer_id": "cust_12345",
      "call_type": "sales"
    }
  }'

Understanding Upload Parameters

Path parameters:

client_name: Your organization identifier (e.g., "acme-corp")
client_profile: Profile name for organizing uploads (e.g., "default", "sales-team")

Request body fields:

file_name: Original file name with extension
file_size: File size in bytes (max 104857600 = 100MB)
content_type: MIME type (audio/wav, audio/mp3, audio/webm, etc.)
metadata.usecase_uuid: Link recording to your analysis use case

Expected Response


Code
 
{
  "upload_url": "https://storage.vozzo.ai/upload/acme-corp/default/550e8400-e29b-41d4-a716-446655440000?signature=abc123",
  "file_key": "acme-corp/default/550e8400-e29b-41d4-a716-446655440000",
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "expires_at": "2025-12-04T11:30:00Z",
  "upload_instructions": {
    "method": "PUT",
    "headers": {
      "Content-Type": "application/octet-stream"
    },
    "timeout_seconds": 300
  }
}

Step 3: Upload the Recording

Use the presigned URL from Step 2 to upload your audio file. The URL is valid for 15 minutes.

Code
 
curl --request PUT \
  --url "UPLOAD_URL_FROM_STEP_2" \
  --header 'Content-Type: application/octet-stream' \
  --data-binary '@/path/to/your/recording.webm'

Upload Complete! The recording will now be automatically transcribed and analyzed. This typically takes 2-5 minutes depending on file length.

Step 4: Check Processing Status

List Recordings in Use Case

Code
 
curl --request POST \
  --url https://backend.vozzo.ai/v1alpha/callintel/org-usecases/recordings \
  --header 'Authorization: Bearer YOUR_JWT_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "usecase_uuid": "815545c1-61c1-4ec7-aa14-365a07909937",
    "page": 1,
    "limit": 10
  }'

Check Specific Recording Status

Code
 
curl --request POST \
  --url https://backend.vozzo.ai/v1alpha/callintel/org-usecases/get-recording-details \
  --header 'Authorization: Bearer YOUR_JWT_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
    "usecase_uuid": "815545c1-61c1-4ec7-aa14-365a07909937",
    "recording_uuid": "4cb66f57-f16b-461d-a670-6585b2fe9456"
  }'

Processing States

Initiated

Upload received, queued for processing

Transcription Completed

Audio transcribed, analysis in progress

Analysis Completed

Full analysis ready

Failed

Processing error occurred

Step 5: Retrieve Analysis Results

Once processing is complete, retrieve the transcript and AI-powered analytics for your call recording.

Get Transcript and Analytics

Code
 
curl --request POST \
  --url https://backend.vozzo.ai/v1alpha/callintel/org-usecases/recording/transcript-analytics \
  --header 'Authorization: Bearer YOUR_JWT_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
    "usecase_uuid": "815545c1-61c1-4ec7-aa14-365a07909937",
    "recording_uuid": "4cb66f57-f16b-461d-a670-6585b2fe9456"
  }'

Get Analytics Summary

Code
 
curl --request POST \
  --url https://backend.vozzo.ai/v1alpha/callintel/org-usecases/analytics/summary-counts \
  --header 'Authorization: Bearer YOUR_JWT_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
    "usecase_uuid": "815545c1-61c1-4ec7-aa14-365a07909937"
  }'

Get Detailed Analytics Breakdown

Code
 
curl --request POST \
  --url https://backend.vozzo.ai/v1alpha/callintel/org-usecases/analytics/summary-details \
  --header 'Authorization: Bearer YOUR_JWT_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
    "usecase_uuid": "815545c1-61c1-4ec7-aa14-365a07909937"
  }'

Alternative: Direct Upload (Experimental)

For simpler workflows, you can upload files directly in a single request. This is experimental and may have size limitations.

Code
 
curl --request POST \
  --url https://backend.vozzo.ai/v1alpha/callintel/acme-corp/default/direct-upload \
  --header 'Authorization: Bearer YOUR_JWT_TOKEN' \
  --form 'file=@/path/to/recording.webm' \
  --form 'usecase_uuid=815545c1-61c1-4ec7-aa14-365a07909937'

How To Integrate API's

Dev

Base URLhttps://backend.vozzo.ai

Prod

Base URLhttps://backend.vozzo.ai

Create Analysis Use Case

Endpoint

POST {{baseUrl}}/v1alpha/callintel/usecase

Create a new analysis use case with specific parameters, tags, and storage buckets. Use cases help organize and configure how call recordings are analyzed for different scenarios.

Request Body

org_uuidstring · uuidrequired

Unique identifier of the organization

usecase_namestringrequired

Name of the use case

usecase_descstringrequired

Description of the use case

tagsstring[]

List of tags associated with the use case

bucketsstring[]

Buckets used to categorize or group data

analysis_configobject

Configuration for analysis parameters

curl --request POST \
  --url https://backend.vozzo.ai/v1alpha/callintel/usecase \
  --header 'Authorization: <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
    "usecase_name": "Lead generation",
    "usecase_desc": "Analyze sales calls for quality",
    "tags": ["sales", "quality"],
    "buckets": ["bucket1", "bucket2"],
    "analysis_config": {
      "analysis_questions": [
        "If the lead is interested in the loan offer. (Yes/No)"
      ],
      "analysis_buckets": [
        {
          "objective_bucket_name": "Hot Lead",
          "description": "If user is interested in the loan offer."
        },
        {
          "objective_bucket_name": "Warm Lead",
          "description": "if user shows no interest."
        },
        {
          "objective_bucket_name": "Not Clear",
          "description": "if it is not clear that user is not interested in loan offer."
        }
      ]
    }
  }'

Example Request Body


Code
 
{
  "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
  "usecase_name": "Lead generation",
  "usecase_desc": "Analyze sales calls for quality",
  "tags": ["sales", "quality"],
  "buckets": ["bucket1", "bucket2"],
  "analysis_config": {
    "enable_sentiment": true,
    "enable_transcript": true,
    "enable_summary": true,
    "analysis_questions": [
      "If the lead is interested in the loan offer. (Yes/No)"
    ],
    "analysis_buckets": [
      {
        "objective_bucket_name": "Hot Lead",
        "description": "If user is interested in the loan offer."
      },
      {
        "objective_bucket_name": "Warm Lead", 
        "description": "if user shows no interest."
      }
    ]
  }
}

Get Use Case Details

Endpoint

GET {{baseUrl}}/v1alpha/callintel/usecase/{usecase_uuid}

Retrieve detailed information about a specific analysis use case, including configuration, tags, buckets, and metadata.

Path Parameters

usecase_uuidstring · uuidrequired

Unique identifier of the use case

curl --request GET \
  --url https://backend.vozzo.ai/v1alpha/callintel/usecase/:usecase_uuid \
  --header 'Authorization: <YOUR_API_KEY>'

Example Response


Code
 
{
  "usecase_uuid": "815545c1-61c1-4ec7-aa14-365a07909937",
  "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
  "usecase_name": "Lead generation",
  "usecase_desc": "Analyze sales calls for quality",
  "tags": ["sales", "quality"],
  "buckets": ["bucket1", "bucket2"],
  "analysis_config": {
    "analysis_questions": [
      "If the lead is interested in the loan offer. (Yes/No)"
    ],
    "analysis_buckets": [
      {
        "objective_bucket_name": "Hot Lead",
        "description": "If user is interested in the loan offer."
      }
    ]
  },
  "is_active": true,
  "created_at": "2025-12-04T09:21:58.743598Z",
  "updated_at": "2025-12-04T09:21:58.743598Z"
}

Update Use Case

Endpoint

PUT {{baseUrl}}/v1alpha/callintel/usecase/{usecase_uuid}

Update an existing analysis use case with new metadata, tags, buckets, or configuration.

Request Body

org_uuid

string · uuid

usecase_name

string

usecase_desc

string

Path Parameters

usecase_uuidstring · uuidrequired

Unique identifier of the use case to delete

curl --request DELETE \
  --url https://backend.vozzo.ai/v1alpha/callintel/usecase/:usecase_uuid \
  --header 'Authorization: <YOUR_API_KEY>'

Example Response


Code
 
{
  "message": "Use case deleted successfully",
  "usecase_uuid": "dab80fa1-8bd1-4411-9333-c46970d27a1a"
}

Get Organization Use Cases

Endpoint

GET {{baseUrl}}/v1alpha/callintel/org-usecases/{org_uuid}

Retrieve a paginated list of all use cases for an organization with usage statistics.

Path Parameters

org_uuidstring · uuidrequired

Unique identifier of the organization

Query Parameters

pageintegerdefault: 1

Page number for pagination

limitintegerdefault: 10

Number of use cases per page

tagstringoptional

Filter use cases by tag

curl --request GET \
  --url https://backend.vozzo.ai/v1alpha/callintel/org-usecases/:org_uuid \
  --header 'Authorization: <YOUR_API_KEY>'

Example Response


Code
 
{
  "data": [
    {
      "usecase_uuid": "dab80fa1-8bd1-4411-9333-c46970d27a1a",
      "usecase_name": "Sales Quality Check",
      "created_at": "2025-12-03T11:08:54.665989+00:00",
      "updated_at": "2025-12-03T05:51:18.114878+00:00",
      "total_recordings": 17
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 10,
  "total_pages": 1
}

Create Secure Upload Link

Endpoint

POST {{baseUrl}}/v1alpha/callintel/{client_name}/{client_profile}/create-upload-link

Generate a pre-signed URL for securely uploading call recordings. This is the recommended two-step upload process: first get the upload link, then upload the file.

Path Parameters

client_namestringrequired

Client organization identifier

client_profilestringrequired

Profile name for organizing analysis requests

Request Body

file_namestringrequired

Original file name with extension

file_sizeintegermax: 100MB

File size in bytes

content_typestringrequired

MIME type of the file

metadataobjectoptional

Optional metadata about the call for enhanced analysis

curl --request POST \
  --url https://backend.vozzo.ai/v1alpha/callintel/:client_name/:client_profile/create-upload-link \
  --header 'Authorization: <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "file_name": "test.webm",
    "file_size": 357741,
    "content_type": "audio/webm",
    "metadata": {
      "usecase_uuid": "dab80fa1-8bd1-4411-9333-c46970d27a1a",
      "call_date": "2025-12-04",
      "call_type": "sales"
    }
  }'

Example Request


Code
 
{
  "file_name": "test.webm",
  "file_size": 357741,
  "content_type": "audio/webm",
  "metadata": {
    "usecase_uuid": "dab80fa1-8bd1-4411-9333-c46970d27a1a",
    "call_date": "2025-12-04",
    "call_type": "sales"
  }
}

Example Response


Code
 
{
  "upload_url": "https://storage.vozzo.ai/upload/acme-corp/default/550e8400-e29b-41d4-a716-446655440000?signature=abc123",
  "file_key": "acme-corp/default/550e8400-e29b-41d4-a716-446655440000",
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "expires_at": "2025-12-04T11:30:00Z",
  "upload_instructions": {
    "method": "PUT",
    "headers": {
      "Content-Type": "application/octet-stream"
    },
    "timeout_seconds": 300
  }
}

Direct Upload

Endpoint

POST {{baseUrl}}/v1alpha/callintel/{client_name}/{client_profile}/direct-upload

Directly upload a call recording in a single request. This experimental endpoint handles both file upload and analysis request creation in one step.

Path Parameters

client_namestringrequired

Client organization identifier

client_profilestringrequired

Profile name for organizing analysis requests

Request Body

filefile (binary)required

Audio file to upload

usecase_uuidstring · uuidoptional

Optional use case UUID for analysis configuration

curl --request POST \
  --url https://backend.vozzo.ai/v1alpha/callintel/:client_name/:client_profile/direct-upload \
  --header 'Authorization: <YOUR_API_KEY>' \
  --header 'Content-Type: multipart/form-data' \
  --form file=@file.webm \
  --form usecase_uuid=00000000-0000-0000-0000-000000000000

Example Response


Code
 
{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "file_name": "test.webm",
  "file_size": 357741,
  "status": "pending",
  "created_at": "2025-12-04T09:30:00Z"
}

Get Use Case Recordings

Endpoint

POST {{baseUrl}}/v1alpha/callintel/org-usecases/recordings

Retrieve a paginated list of all recordings associated with a specific use case, including processing status and metadata.

Request Body

usecase_uuidstring · uuidrequired

Unique identifier of the use case

pageintegeroptional

Page number for pagination (default: 1)

limitintegeroptional

Number of recordings per page (default: 10)

statusstringoptional

Filter by processing state: INITIATED, TRANSCRIPTION_COMPLETED, ANALYSIS_COMPLETED, FAILED

from_datestring · date-timeoptional

Start date filter

to_datestring · date-timeoptional

End date filter

curl --request POST \
  --url https://backend.vozzo.ai/v1alpha/callintel/org-usecases/recordings \
  --header 'Authorization: <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "usecase_uuid": "dab80fa1-8bd1-4411-9333-c46970d27a1a",
    "page": 1,
    "limit": 10
  }'

Example Request


Code
 
{
  "usecase_uuid": "dab80fa1-8bd1-4411-9333-c46970d27a1a",
  "page": 1,
  "limit": 10
}

Example Response


Code
 
{
  "data": [
    {
      "recording_uuid": "1c43a668-1c11-4993-9059-6366250686d7",
      "file_name": "d586a7a6-39d4-49c0-94ad-891fd9c7d43c.webm",
      "transcription_ref": "s3://vozzo-call-intel-dev/vozzodev-org/default/transcription/d586a7a6-39d4-49c0-94ad-891fd9c7d43c.json",
      "processing_state": "TRANSCRIPTION_COMPLETED",
      "is_active": true,
      "updated_at": "2025-12-04T03:31:49.152074+00:00",
      "file_metadata": {
        "bucket": "vozzo-call-intel-dev",
        "client_org": "vozzodev-org",
        "request_id": "d586a7a6-39d4-49c0-94ad-891fd9c7d43c",
        "client_profile": "default",
        "analysis_config": {
          "analysis_buckets": [
            {
              "description": "If user is interested in the loan offer.",
              "objective_bucket_name": "Hot Lead"
            }
          ],
          "analysis_questions": [
            "If the lead is interested in the loan offer. (Yes/No)"
          ]
        }
      },
      "usecase_uuid": "dab80fa1-8bd1-4411-9333-c46970d27a1a",
      "analysis_ref": "s3://vozzo-call-intel-dev/vozzodev-org/default/analysis/d586a7a6-39d4-49c0-94ad-891fd9c7d43c.json",
      "processing_history": [
        {
          "state": "INITIATED",
          "timestamp": "2025-11-19T23:50:51.309810"
        }
      ],
      "created_at": "2025-12-04T03:31:49.152074+00:00"
    }
  ],
  "total": 17,
  "page": 1,
  "limit": 10,
  "total_pages": 2
}

Get Recording Details

Endpoint

POST {{baseUrl}}/v1alpha/callintel/org-usecases/get-recording-details

Retrieve detailed information about a specific recording including metadata, processing history, and file information.

Request Body Parameters

org_uuidstring · uuidrequired

Unique identifier of the organization

usecase_uuidstring · uuidrequired

Unique identifier of the use case

recording_uuidstring · uuidrequired

Unique identifier of the recording

curl --request POST \
  --url https://backend.vozzo.ai/v1alpha/callintel/org-usecases/get-recording-details \
  --header 'Authorization: <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
    "usecase_uuid": "dab80fa1-8bd1-4411-9333-c46970d27a1a",
    "recording_uuid": "4cb66f57-f16b-461d-a670-6585b2fe9456"
  }'

Example Request


Code
 
{
  "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
  "usecase_uuid": "dab80fa1-8bd1-4411-9333-c46970d27a1a",
  "recording_uuid": "4cb66f57-f16b-461d-a670-6585b2fe9456"
}

Example Response


Code
 
 {
   "file_metadata": {
     "bucket": "vozzo-call-intel-dev",
     "client_org": "vozzodev-org",
     "request_id": "4d2d68a1-5d25-4154-9dc4-b862196903ca",
     "client_profile": "default",
     "analysis_config": {
       "analysis_buckets": [
         { "objective_bucket_name": "Hot Lead", "description": "If user is interested in the loan offer." }
       ],
       "analysis_questions": ["If the lead is interested in the loan offer. (Yes/No)"]
     },
     "analysis_object_key": "vozzodev-org/default/analysis/4d2d68a1-5d25-4154-9dc4-b862196903ca.json",
     "recording_file_name": "4d2d68a1-5d25-4154-9dc4-b862196903ca.webm",
     "recording_file_size": 357741,
     "recording_object_key": "vozzodev-org/default/recordings/4d2d68a1-5d25-4154-9dc4-b862196903ca.webm",
     "recording_file_extension": ".webm",
     "transcription_object_key": "vozzodev-org/default/transcription/4d2d68a1-5d25-4154-9dc4-b862196903ca.json"
   },
   "usecase_uuid": "dab80fa1-8bd1-4411-9333-c46970d27a1a",
   "analysis_ref": "s3://vozzo-call-intel-dev/vozzodev-org/default/analysis/4d2d68a1-5d25-4154-9dc4-b862196903ca.json",
   "processing_history": [{"state": "INITIATED","timestamp": "2025-11-19T23:59:39.665614"}],
   "created_at": "2025-12-04T03:31:49.152074+00:00",
   "file_name": "4d2d68a1-5d25-4154-9dc4-b862196903ca.webm",
   "recording_uuid": "4cb66f57-f16b-461d-a670-6585b2fe9456",
   "transcription_ref": "s3://vozzo-call-intel-dev/vozzodev-org/default/transcription/4d2d68a1-5d25-4154-9dc4-b862196903ca.json",
   "processing_state": "INITIATED",
   "is_active": true,
   "updated_at": "2025-12-04T03:31:49.152074+00:00"
 }

Get Recording Transcript and Analytics

Endpoint

POST {{baseUrl}}/v1alpha/callintel/org-usecases/recording/transcript-analytics

Retrieve complete transcript and analytics for a specific recording including speaker analysis, timestamps, and confidence scores.

Request Body Parameters

org_uuidstring · uuidrequired

Unique identifier of the organization

usecase_uuidstring · uuidrequired

Unique identifier of the use case

recording_uuidstring · uuidrequired

Unique identifier of the recording

curl --request POST \
  --url https://backend.vozzo.ai/v1alpha/callintel/org-usecases/recording/transcript-analytics \
  --header 'Authorization: <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
    "usecase_uuid": "dab80fa1-8bd1-4411-9333-c46970d27a1a",
    "recording_uuid": "4cb66f57-f16b-461d-a670-6585b2fe9456"
  }'

Example Request


Code
 
{
  "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
  "usecase_uuid": "dab80fa1-8bd1-4411-9333-c46970d27a1a",
  "recording_uuid": "4cb66f57-f16b-461d-a670-6585b2fe9456"
}

Example Response


Code
 
{
  "transcript": {
    "jobName": "default__recordings__4d2d68a1-5d25-4154-9dc4-b862196903ca.webm__948b7ca3-20df-4ee6-87db-bba99a05ce34",
    "accountId": "626635402027",
    "status": "COMPLETED",
    "results": {
      "language_code": "hi-IN",
      "transcripts": [
        {
          "transcript": "नमस्ते अपर्णा जी मैं नेहा श्रीराम फाइनेंस से बोल रही हूँ । कैसे हैं आप आईएम हैविंग टब हंग । मैं ठीक है । बहुत अच्छा अपर्णा जी धन्यवाद । ..."
        }
      ]
    }
  },
  "analytics": {}
}

Get Analytics Summary Counts

Endpoint

POST {{baseUrl}}/v1alpha/callintel/org-usecases/analytics/summary-counts

Retrieve high-level summary counts for a specific use case including total calls, completed analytics, and completion percentages.

Request Body Parameters

org_uuidstring · uuidrequired

Unique identifier of the organization

usecase_uuidstring · uuidrequired

Unique identifier of the use case

curl --request POST \
  --url https://backend.vozzo.ai/v1alpha/callintel/org-usecases/analytics/summary-counts \
  --header 'Authorization: <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
    "usecase_uuid": "dab80fa1-8bd1-4411-9333-c46970d27a1a"
  }'

Example Request


Code
 
{
  "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
  "usecase_uuid": "dab80fa1-8bd1-4411-9333-c46970d27a1a"
}

Example Response


Code
 
{
  "total_calls": 18,
  "total_analytics_completed": 0,
  "percentage_analytics_completed": 0.0
}

Get Detailed Analytics Summary

Endpoint

POST {{baseUrl}}/v1alpha/callintel/org-usecases/analytics/summary-details

Retrieve detailed analytics summary for a use case including categorization and tagging breakdowns. This endpoint provides insights into how recordings are categorized and tagged within the use case.

Request Body Parameters

org_uuidstring · uuidrequired

Unique identifier of the organization

usecase_uuidstring · uuidrequired

Unique identifier of the use case

curl --request POST \
  --url https://backend.vozzo.ai/v1alpha/callintel/org-usecases/analytics/summary-details \
  --header 'Authorization: <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
    "usecase_uuid": "815545c1-61c1-4ec7-aa14-365a07909937"
  }'

Example Request


Code
 
{
  "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
  "usecase_uuid": "815545c1-61c1-4ec7-aa14-365a07909937"
}

Example Response


Code
 
  {
    "categories": {
      "Others": 4
    },
    "tags": {
      "null": 4
    }
  }

Get Audio Presigned URL

Endpoint

POST {{baseUrl}}/v1alpha/callintel/org-usecases/recording/get-audio-presigned-url

Generate a presigned URL for securely accessing and streaming an audio recording. The URL is time-limited and provides direct access to the stored audio file.

Request Body Parameters

s3_keystringrequired

S3 object key for the audio recording

curl --request POST \
  --url https://backend.vozzo.ai/v1alpha/callintel/org-usecases/recording/get-audio-presigned-url \
  --header 'Authorization: <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "s3_key": "vozzodev-org/default/recordings/4d2d68a1-5d25-4154-9dc4-b862196903ca.webm"
  }'

Example Request


Code
 
  {
    "s3_key": "vozzodev-org/default/recordings/4d2d68a1-5d25-4154-9dc4-b862196903ca.webm"
  }

Example Response


Code
 
  {
    "presigned_url": "https://vozzo-call-intel-dev.s3.amazonaws.com/vozzodev-org/default/recordings/4d2d68a1-5d25-4154-9dc4-b862196903ca.webm?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIAZDZTBNMVXR4CTDQD%2F20251219%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251219T124531Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEOX...&X-Amz-Signature=8a69d01e8e6c3cc96b7a6e4954d65a1a5c192bed2818d6ac85aa59a98d375a5c"
  }

Common Pitfalls & Solutions

Problem: "Invalid or expired authentication token"

Solution: Ensure your API key is formatted correctly as Token YOUR_SECRET_API_KEY (with "Token" prefix)

Problem: "Agent not found"

Solution: Verify your agent UUID exists in the Vozzo platform and you have access to it

Problem: "Invalid phone number format"

Solution: Use E.164 format with country code: +[country_code][number] (e.g., +911234567890)

Problem: "Invalid date format"

Solution: Use YYYY-MM-DD format for dates (e.g., 2026-01-04)

Problem: "Metadata must be a valid JSON string"

Solution: Ensure metadata is a JSON string, not an object: "{"key":"value"}", not {"key":"value"}

Best Practices

Start Small

Begin with 2-5 test recipients before scaling to hundreds or thousands

Use Descriptive Names

Name campaigns clearly: "Q1_2026_Product_Launch" instead of "Campaign_1"

Set Realistic Time Windows

Consider recipient timezones and avoid early morning or late evening calls

Implement Error Handling

Always check response status codes and handle errors gracefully

Monitor Performance

Regularly check analytics to optimize retry settings and calling windows

Respect Privacy

Only call numbers with proper consent and follow local regulations

Next Steps

Explore API Reference

Dive deep into all available endpoints and parameters

View API Reference →

Support

Need help? We're here for you:

Email:support@vozzo.ai
Community Forum:Join discussions with other developers
Documentation:Comprehensive guides and examples
Issue Tracker:Report bugs and request features

Last modified on February 23, 2026

Introduction Make a Call