Multi-Campaign Operations

Manage multiple campaigns through unified analytics, aggregated dashboards, combined queue views, and bulk exports.

These APIs are designed for high-volume operations where campaigns are grouped by region, language, cohort, or business workflow.

Combined Operations Overview

Unified Dashboard Metrics

Aggregate progress and operational metrics across multiple campaigns.

Code
 
POST /v1alpha/campaign/get_campaign_data_by_ids/

Example Request

Code
 
{
  "campaign_ids": [
    "dc9a563f-e9e7-486c-b911-78af74567821",
    "59832518-3b39-4e2d-812b-ca92a858ace6"
  ]
}

Aggregated Metrics Include

• Total scheduled calls
• Completed calls
• Pending queues
• Retry analytics
• Average call duration
• Combined campaign performance

Combined AI Analytics

Retrieve aggregated dispositions and conversational analytics.

Code
 
POST /v1alpha/campaign/get_campaign_analytics_by_ids/

Returned Analytics

Combined Queue Operations

Query and manage call items across multiple campaigns from a single interface.

Fetch Available Dispositions

Code
 
POST /v1alpha/campaign/items/dispositions_by_ids

Example Response

Code
 
{
  "dispositions": ["Interested", "Transferred to Agent", "No Answer"]
}

Query Combined Call Items

Code
 
POST /v1alpha/campaign/items/items_by_ids

Example Request

Code
 
{
  "campaign_ids": [
    "dc9a563f-e9e7-486c-b911-78af74567821",
    "59832518-3b39-4e2d-812b-ca92a858ace6"
  ],

  "page": 1,
  "page_size": 10,

  "search_term": "Priya",

  "disposition": "Transferred to Agent"
}

Supported Filters

Bulk CSV Exports

Export large datasets across multiple campaigns using streaming CSV APIs.

Code
 
POST /v1alpha/campaign/items/download_csv_by_ids

Export Includes

• Call records
• Dispositions
• Metadata
• AI analytics
• Durations
• Recipient details
• Structured insights

Python Example

Stream aggregated CSV exports directly to disk.

Code
 
import requests

API_KEY = "vzt_YOUR_SECRET_KEY"

HEADERS = {
    "Authorization": f"Token {API_KEY}",
    "Content-Type": "application/json"
}

payload = {
    "campaign_ids": [
        "dc9a563f-e9e7-486c-b911-78af74567821",
        "59832518-3b39-4e2d-812b-ca92a858ace6"
    ]
}

url = "https://backend.vozzo.ai/v1alpha/campaign/items/download_csv_by_ids"

with requests.post(url, headers=HEADERS, json=payload, stream=True) as response:
    with open("combined_export.csv", "wb") as file:
        for chunk in response.iter_content(chunk_size=8192):
            if chunk:
                file.write(chunk)

print("Export completed")

Node.js Example

Query combined campaign call items.

Code
 
const axios = require("axios");

const API_KEY = "vzt_YOUR_SECRET_KEY";

const payload = {
  campaign_ids: [
    "dc9a563f-e9e7-486c-b911-78af74567821",
    "59832518-3b39-4e2d-812b-ca92a858ace6",
  ],

  page: 1,
  page_size: 10,

  search_term: null,
  disposition: null,
};

axios
  .post(
    "https://backend.vozzo.ai/v1alpha/campaign/items/items_by_ids",
    payload,
    {
      headers: {
        Authorization: `Token ${API_KEY}`,
        "Content-Type": "application/json",
      },
    },
  )
  .then((response) => {
    console.log(response.data);
  })
  .catch((error) => {
    console.error(error.response?.data || error.message);
  });

Common Use Cases

Next Steps