Deploy to Phone

To enable your Vozzo AI Agent to participate in PSTN telephony (traditional phone calls), you can assign a dedicated phone number to it. Vozzo manages the underlying SIP and telephony infrastructure using Plivo.

1. List Purchased Phone Numbers

Before assigning an agent to a phone number, fetch the available numbers in your organization using /plivo/numbers/list-numbers. This endpoint returns each number's rental ID (ph_rent_id), country, status, and currently assigned agent.

cURL
 
curl -X GET https://backend.vozzo.ai/plivo/numbers/list-numbers \
  -H "Authorization: Token YOUR_API_KEY"

JavaScript
 
const response = await fetch("https://backend.vozzo.ai/plivo/numbers/list-numbers", {
  method: "GET",
  headers: {
    Authorization: "Token YOUR_API_KEY", // Or "Bearer YOUR_JWT"
    "accept": "application/json",
  },
});
const numbers = await response.json();
console.log("Available numbers:", numbers);

Response Example

Code
 
[
  {
    "ph_rent_id": "101",
    "number": "+18005550199",
    "country": "US",
    "assign_agent_name": "Customer Support Bot",
    "label": "Support Line 1",
    "is_sip": false,
    "assigned_agent_uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "inbound": true,
    "outbound": true,
    "status": "Active",
    "renewal": "auto",
    "renewal_date": "2026-12-01",
    "purchase_date": "2026-01-01"
  }
]

2. Assign Agent to Phone Numbers

To attach your voice AI agent to one or more rented phone numbers, call the /plivo/numbers/assign-agent endpoint. When incoming calls arrive on these numbers, or outbound campaigns place calls through them, your configured AI agent handles the conversation.

Request

• Endpoint: https://backend.vozzo.ai/plivo/numbers/assign-agent
• Method: POST
• Headers:
  • Authorization: Token YOUR_API_KEY (or Bearer YOUR_JWT)
  • Content-Type: application/json

cURL
 
curl -X POST https://backend.vozzo.ai/plivo/numbers/assign-agent \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "phone_rental_ids": [101]
  }'

JavaScript
 
const response = await fetch("https://backend.vozzo.ai/plivo/numbers/assign-agent", {
  method: "POST",
  headers: {
    Authorization: "Token YOUR_API_KEY",
    "Content-Type": "application/json",
    accept: "application/json",
  },
  body: JSON.stringify({
    agent_uuid: "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    phone_rental_ids: [101],
  }),
});
const result = await response.json();
console.log("Assignment Result:", result);

Response (200 OK)

Code
 
{
  "success": true,
  "message": "Agents assigned successfully",
  "results": [
    {
      "ph_rent_id": 101,
      "success": true,
      "message": "Agent assigned successfully",
      "phone_number": "+18005550199",
      "agent_name": "Support Bot"
    }
  ]
}

SIP Integration Overview

Vozzo maps the assigned phone number to a dynamically scalable SIP endpoint.

Bring Your Own Carrier (BYOC)

If your enterprise already uses Twilio, Vonage, or a custom SIP trunk, Vozzo supports receiving standard SIP INVITE requests directly. Contact enterprise support to provision an inbound SIP domain for your agent.