Voice AI Agent Quickstart

Welcome to Vozzo Voice AI Agents. In this guide you will create a fully functional AI voice agent, retrieve its UUID, and make your first API call — all in under 5 minutes.

What is a Voice AI Agent?

A Vozzo Voice AI Agent is a programmable conversational AI that speaks naturally over phone and web channels. Each agent has its own:

• Identity — name, language, accent, avatar
• Intelligence — LLM model, STT/TTS pipeline, knowledge base
• Personality — greeting, behaviour, system prompt
• Deployment — web widget or phone number

Prerequisites

Step 1 — Create an Agent

Create your first agent by specifying the voice, language, and model.

cURL
 
# Using API Key
curl -X POST https://backend.vozzo.ai/agent/create-agent/ \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_name": "Support Bot",
    "org_id": 1,
    "voice_id": 935,
    "agent_language": "English",
    "agent_accent": "",
    "vz_model_id": 2
  }'

JavaScript
 
const response = await fetch(
  "https://backend.vozzo.ai/agent/create-agent/",
  {
    method: "POST",
    headers: {
      Authorization: "Token YOUR_API_KEY", // Or "Bearer YOUR_JWT"
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      agent_name: "Support Bot",
      org_id: 1,
      voice_id: 935,
      agent_language: "English",
      agent_accent: "",
      vz_model_id: 2,
    }),
  },
);
const { data } = await response.json();
console.log("Agent UUID:", data.agent_uuid);

Successful response:

Code
 
{
  "success": true,
  "message": "Agent created successfully",
  "data": {
    "agent_uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "agent_name": "Support Bot",
    "vz_model_id": 2
  }
}

Step 2 — Retrieve Agent Details

Fetch the full configuration of your newly created agent using its UUID.

cURL
 
curl -X GET https://backend.vozzo.ai/agent/get-agent/3fa85f64-5717-4562-b3fc-2c963f66afa6 \
  -H "Authorization: Token YOUR_API_KEY"

Step 3 — Update Agent Personality

Personalize your agent with a greeting and a system prompt that defines its persona.

cURL
 
curl -X PUT https://backend.vozzo.ai/agent/update-agent/3fa85f64-5717-4562-b3fc-2c963f66afa6/ \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_greeting": "Hello! I am your AI assistant. How can I help you today?",
    "agent_prompt": "You are a helpful support agent for Acme Corp. Be concise and friendly.",
    "is_agent_greet_first": true
  }'

What's Next?