Vobiz Voice Calls

Vobiz Voice Calls skill

Use this when the user wants to dial out, control an active call, or look up a live call. For completed-call history, prefer the vobiz-cdr skill.

What you can do

• Make a call - POST /api/v1/Account/{auth_id}/Call/ with {from, to, answer_url, answer_method}. Returns a call_uuid.
• List live calls - GET /api/v1/Account/{auth_id}/Call to see all in-progress/queued calls.
• Get one live call - GET /api/v1/Account/{auth_id}/Call/{call_uuid}.
• Hangup a call - DELETE /api/v1/Account/{auth_id}/Call/{call_uuid}.
• Mid-call actions - play audio, speak TTS, send DTMF, start/stop recording, start audio stream. Each is a POST to /Call/{call_uuid}/{action}/.
• Machine detection - outbound calls support synchronous and async answering-machine detection with configurable sensitivity. See call/machine-detection.

Required inputs

• from: a Vobiz number you own (or a verified caller-ID).
• to: E.164 format (+91...). Use NAME room and Vobiz auto-creates it. The REST Conference endpoints only inspect/control/record existing rooms.
• member_id accepts a single id, a comma-separated list (10,15,22), or all. Conference names with spaces must be URL-encoded (My%20Conf%20Room); names are case-sensitive.
• Play urls, Speak text, member Play url are required; sending them empty fails. Audio must be public .mp3/.wav over HTTP(S).
• Stop actions are idempotent: stopping play/speak/recording when nothing is active still returns success (204). Hangup and conference deletes are destructive and not reversible.
• A real call costs money and can fail for 402 (insufficient balance) or be throttled by 429 (CPS/concurrency limit). In sandbox/test work, place at most one short call per scenario.

Flow recipes

• Outbound call + answer flow: POST /Call/ with {from,to,answer_url,answer_method} → returns request_uuid and message: "Call fired". On answer, Vobiz POSTs the answer-URL params to answer_url; reply with VobizXML. Configure ring_url/hangup_url for lifecycle webhooks (see call/make-call).
• Voicemail handling: add machine_detection=true|hangup (+ optional machine_detection_url for async). On async, Vobiz POSTs Machine: true/false to your URL while the call continues - branch on it (see call/machine-detection).
• Mid-call control: retrieve the live call_uuid, then POST /Call/{call_uuid}/Play|Speak|DTMF|Record/. Pick legs/leg to target a side. Stop with the matching DELETE.
• Warm transfer: POST /Call/{call_uuid}/ with legs=aleg + aleg_url to send the caller to hold/another flow while you set up the callee, then transfer with new XML.
• Conference moderation: caller joins via ` XML → GET /Conference/{name}/ for member_ids → Mute/Deaf/Kick/Play per member (or all) → Record the room → DELETE` to end.

When to search docs

• "How do I make a call from Python?" → search call/make-call
• "What does the answer URL receive?" → search xml/request
• "How do I detect voicemail?" → search call/machine-detection
• "How do I record a call?" → search call/record-calls
• "How do I transfer or redirect a live call?" → search call/transfer-call
• "How do I mute/kick a conference participant?" → search conference/members
• "How are conferences created?" → search xml/conference

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: vobiz-ai
• Source: vobiz-ai/Agent-Skills
• License: MIT

Install and usage instructions live in the source repository linked above.