VoxPro Developer Docs

{
  "ok": true,
  "assistants": [
    {
      "id": "asst_abc123",
      "name": "Maya",
      "displayName": "Maya — Xanderia",
      "voiceProvider": "ytl",
      "voice": "voice_1",
      "llmProvider": "ytl",
      "firstMessage": "Selamat datang! Saya Maya...",
      "systemPrompt": "You are Maya...",
      "selectedToolIds": ["crm-lookup"],
      "createdAt": "2025-06-01T10:00:00.000Z",
      "updatedAt": "2025-06-15T08:22:00.000Z"
    }
  ]
}

{
  "name": "Maya",
  "displayName": "Maya — Loan Advisor",
  "llmProvider": "ytl",
  "llmModel": "ilmu-text-free-v2",
  "asrProvider": "ytl",
  "voiceProvider": "ytl",
  "voice": "voice_1",
  "language": "ms",
  "temperature": 0.4,
  "maxTokens": 220,
  "firstMessage": "Selamat datang! Saya Maya dari Xanderia.",
  "systemPrompt": "Anda adalah Maya...\n\n{{knowledge_base}}",
  "selectedToolIds": [],
  "allowInterruption": true,
  "autoEndOnSilenceSec": 60
}

{ "ok": true, "assistant": { "id": "asst_abc123", "..." } }

{ "systemPrompt": "You are Maya v2. {{kb_xanderia_faq}}" }

{ "ok": true, "assistant": { "id": "asst_xyz789", "name": "Maya (copy)", "..." } }

{ "ok": true }

{
  "files": [
    {
      "name": "xanderia_faq.csv",
      "size": 3840,
      "uploadedAt": "2025-06-20T08:00:00.000Z"
    }
  ]
}

const fd = new FormData();
fd.append("files", myFile); // can append multiple

const res = await fetch(`/knowledge/${assistantId}/upload`, {
  method: "POST",
  headers: { Authorization: `Bearer ${token}` },
  body: fd  // DO NOT set Content-Type manually
});
const { files } = await res.json();

{ "ok": true, "files": [ /* remaining files */ ] }

{
  "campaigns": [
    {
      "id": "blast-1719825600-a1b2c3",
      "campaignName": "June Collections",
      "stats": {
        "totalTargets": 50,
        "called": 48,
        "active": 3,
        "completed": 32,
        "failed": 5,
        "pending": 2
      }
    }
  ]
}

{
  "numbers": [
    {
      "id": "num_abc",
      "number": "+60312345678",
      "label": "Sales hotline",
      "enabled": true,
      "assistantId": "asst_abc123",
      "assistantName": "Maya"
    }
  ]
}

{
  "number": "+60312345678",
  "label": "Sales hotline",
  "enabled": true,
  "assistantId": "asst_abc123"
}

{
  "ok": true,
  "roomName": "voxpro-inbound-room-xyz",
  "assistantId": "asst_abc123",
  "assistantName": "Maya",
  "sipUri": "sip:voxpro-inbound-room-xyz@livekit.example.com"
}

{
  "tools": [
    {
      "id": "tool_abc",
      "toolId": "crm-lookup",
      "name": "CRM Lookup",
      "type": "webhook",
      "method": "POST",
      "webhookUrl": "https://yourapi.example.com/crm",
      "description": "Look up customer loan status"
    }
  ]
}

{
  "toolId": "crm-lookup",
  "args": { "phone_number": "+60123456789" }
}

{
  "ok": true,
  "toolId": "crm-lookup",
  "name": "CRM Lookup",
  "status": 200,
  "responseText": "{\"customerName\":\"Ahmad\",\"balance\":14850}"
}

{
  "name": "Post-call to CRM",
  "triggerEvent": "call.completed",
  "enabled": true,
  "webhookUrl": "https://yourapp.example.com/webhooks/voxpro",
  "selectedFields": ["phoneNumber", "transcript", "outcome", "matchedCsvRow"],
  "customPayload": ""
}

{
  "webhookUrl": "https://yourapp.example.com/webhooks/voxpro",
  "triggerEvent": "call.completed",
  "selectedFields": ["phoneNumber", "outcome"],
  "sampleData": { "phoneNumber": "+60123456789" }
}

{
  "triggerEvent": "call.completed",
  "payload": {
    "phoneNumber": "+60123456789",
    "roomName": "voxpro-room-xyz",
    "outcome": "PTP"
  }
}

{
  "triggerEvent": "call.completed",
  "matched": 2,
  "results": [
    { "id": "auto_abc", "name": "Post-call CRM", "ok": true, "status": 200 },
    { "id": "auto_xyz", "name": "n8n Pipeline",  "ok": true, "status": 200 }
  ]
}

{
  "logs": [
    {
      "id": "voxpro-room-1719825600-abc",
      "phoneNumber": "+60123456789",
      "contactName": "Ahmad Zaki",
      "assistantId": "asst_abc123",
      "assistantName": "Maya",
      "startedAt": "2025-06-20T14:00:00.000Z",
      "updatedAt": "2025-06-20T14:03:05.000Z",
      "endedReason": "customer-ended-call",
      "outcome": "PTP",
      "durationSeconds": 185,
      "recordingPath": "/recordings/voxpro-room-abc.wav",
      "campaignId": "blast-1719825600-a1b2c3",
      "campaignName": "June Collections",
      "structuredOutput": {
        "disposition": "PTP",
        "paymentDate": "2025-07-01",
        "amountPromised": 5000
      }
    }
  ]
}

// Authenticated streaming with fetch + Blob URL
const res = await fetch(`/logs/${logId}/recording`, {
  headers: { Authorization: `Bearer ${token}` }
});
const blob = await res.blob();
const url  = URL.createObjectURL(blob);
audioElement.src = url;

{
  "customerId": "acme-bpo",
  "customerName": "ACME BPO",
  "status": "active",
  "maxConcurrentCalls": 10,
  "enforceConcurrencyLimit": true,
  "monthlyMinuteLimit": 5000,
  "enforceMinuteLimit": true,
  "assistantIds": ["asst_abc123"]
}

{
  "customerId": "acme-bpo",
  "month": "2025-06",
  "totalMinutesUsed": 1248,
  "estimatedMinutesRemaining": 3752
}

{
  "ytl": [
    { "id": "voice_1", "name": "Voice 1" },
    { "id": "voice_2", "name": "Voice 2" },
    { "id": "voice_3", "name": "Voice 3" }
  ],
  "edge": [
    { "id": "ms-MY-YasminNeural", "name": "Yasmin — Malay Female" },
    { "id": "ms-MY-OsmanNeural",  "name": "Osman — Malay Male" },
    { "id": "en-SG-LunaNeural",   "name": "Luna — English SG Female" }
  ],
  "openai": [
    { "id": "alloy",   "name": "Alloy" },
    { "id": "shimmer", "name": "Shimmer" }
  ]
}