# Vobiz Voice Calls

> Place, control, and inspect voice calls on Vobiz - make outbound calls, transfer, hangup, list live calls, and react to call events via webhooks.

- **Type:** Skill
- **Install:** `agentstack add skill-vobiz-ai-agent-skills-vobiz-voice-calls`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [vobiz-ai](https://agentstack.voostack.com/s/vobiz-ai)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [vobiz-ai](https://github.com/vobiz-ai)
- **Source:** https://github.com/vobiz-ai/Agent-Skills/tree/main/skills/vobiz-voice-calls

## Install

```sh
agentstack add skill-vobiz-ai-agent-skills-vobiz-voice-calls
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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_id`s → `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](https://github.com/vobiz-ai)
- **Source:** [vobiz-ai/Agent-Skills](https://github.com/vobiz-ai/Agent-Skills)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-vobiz-ai-agent-skills-vobiz-voice-calls
- Seller: https://agentstack.voostack.com/s/vobiz-ai
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.