Get started with the Vozzo Make Call (Dispatcher) API in minutes.
This guide walks you through triggering a single or scheduled outbound AI call using a configured agent.
Prerequisites
Before you begin, ensure you have:
- A Vozzo account with API access
- A valid Bearer access token obtained after authentication
- An AI agent created and configured in the Vozzo platform
- Agent UUID from the agent settings page
- Phone numbers in E.164 format (e.g.
+916376526334)
Step 1: Verify Authentication
Ensure your Bearer token is valid before making a call.
Code
Step 2: Make Your First Call
Trigger a scheduled outbound AI call using the Dispatcher API.
Code
Understanding the Request
| Field | Description |
|---|---|
| agent_uuid | AI agent that will place the call |
| scheduled_call_config | Controls scheduling rules and allowed time windows |
| scheduled_call_data | Recipient list and per-call personalization data |
| post_call_config | Optional configuration for tagging, scoring, and analytics |
Scheduled Call Data Structure
Code
to_phone_number: E.164 formatted phone number
agent_language: Language the agent will speak
metadata: JSON string for call personalization
Expected Response
Code
Success! Your AI call is now queued and will be executed within the defined time window.
How to Integrate API
Make Call (Dispatcher)
Endpoint
POST {{baseUrl}}/v1alpha/dispatcher
Trigger an outbound AI-powered voice call instantly or schedule it within a defined time window. This endpoint supports single or bulk recipients, personalization via metadata, and advanced scheduling rules.
Headers
| Header | Value | Required | Description |
|---|---|---|---|
| Authorization | Bearer <ACCESS_TOKEN> | Yes | OAuth Bearer token obtained after authentication |
| Content-Type | application/json | Yes | Indicates JSON request body |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| agent_uuid | string (uuid) | Yes | UUID of the AI agent that will handle the call |
| prompt_history_id | string | null | No | Reference to previous conversation history, if any |
| scheduled_call_config | object | Yes | Defines scheduling rules, time window, and timezone |
| post_call_config | object | No | Optional configuration for goals, tags, scoring, and analytics |
| scheduled_call_data | object[] | Yes | List of recipients and call-specific parameters |
curl --request POST \
--url https://backend.vozzo.ai/v1alpha/dispatcher \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"agent_uuid": "042cd5ea-07e9-4b49-8782-658d8128889d",
"prompt_history_id": null,
"scheduled_call_config": {
"searchable_attr": "phone_number",
"timeslot_settings": {
"timezone": "IST",
"allow_on_weekends": false,
"start_time": "09:00",
"end_time": "18:00",
"start_date": "2026-02-04"
}
},
"post_call_config": {
"goals": [],
"criteria": [],
"buckets": [],
"tags": [],
"questions": []
},
"scheduled_call_data": [
{
"to_phone_number": "+916376526334",
"agent_language": "Hindi",
"metadata": "{\"name\":\"john\"}"
}
]
}'Example Request Body
Code
Common Pitfalls
Problem: Using an expired Bearer token
Problem: Sending metadata as an object instead of a JSON string
Problem: Invalid phone number format
Problem: "Invalid date format"
Problem: Scheduling calls outside allowed hours
Best Practices
Start with a single test number
Keep metadata small and meaningful
Respect recipient timezones and consent
Log call_id for debugging and audits
Next Steps
Explore Dispatcher API
Learn how to batch calls, add scoring, and post-call analytics
Support
Need help?
- Email: support@vozzo.ai
- Full API documentation
- Developer community