Docs / Developers

Build on Voxovo

Stable API surface for freelancers and partners — auth, webhooks, browser voice, and outbound without DMing us.

1. 1. Auth

   Create an omni_sk_ key in Settings → API. Send Authorization: Bearer omni_sk_…. Idempotency via Idempotency-Key on writes.

   curl -s https://api.voxovo-ai.com/api/v1/agents \
     -H "Authorization: Bearer omni_sk_YOUR_KEY"

2. 2. Webhooks (versioned)

   Events: call.completed, qa.completed, transfer.*, handoff. Catalog: GET /api/v1/webhook-events. Verify HMAC signature header.

3. 3. Test Live WebSocket

   Browser mic PCM over WebSocket (not WebRTC) → same pipeline as phone. Use dashboard Test Live or SDK WebVoiceClient. Scorecards land on /latency.

4. 4. Hello outbound

   curl -s -X POST https://api.voxovo-ai.com/api/v1/calls \
     -H "Authorization: Bearer omni_sk_YOUR_KEY" \
     -H "Content-Type: application/json" \
     -H "Idempotency-Key: hello-1" \
     -d '{"agent_id":"AGENT_UUID","to":"+15551234567","mode":"phone"}'

   Or: npm i @voxovo/sdk / pip install voxovo.

5. 5. Voice cloning

   Upload a 10–30s sample in the dashboard or list clones via API. Requires Cartesia or ElevenLabs BYOK.

   curl -s https://api.voxovo-ai.com/api/v1/voices/clones \
     -H "Authorization: Bearer omni_sk_YOUR_KEY"

6. 6. Workflows + integrations catalog

   List published workflows and the deep integration catalog (routers, compliance, CRM, live search). Agency keys may pass X-Client-Workspace-Id for client workspaces.

   curl -s https://api.voxovo-ai.com/api/v1/workflows \
     -H "Authorization: Bearer omni_sk_YOUR_KEY"
   
   curl -s https://api.voxovo-ai.com/api/v1/integrations/catalog \
     -H "Authorization: Bearer omni_sk_YOUR_KEY"

7. 7. Agent / workflow export

   GET /agents/{id}/export → voxovo.agent.export.v1 JSON (no secrets) for templates later.