vonage-voice

What it is and what it does

vonage-voice is a Python client library for Vonage's Voice API, enabling programmatic control of phone calls. It wraps Vonage's REST endpoints and provides a Pydantic-based request/response model layer, so you construct call parameters as typed objects rather than raw dictionaries. The package includes an NCCO builder—a set of classes representing call control actions (Talk, Play, Transfer, etc.)—that you chain together to define call flow logic.

You use it by instantiating a Vonage client (typically through the main vonage package) and calling methods like create_call, transfer_call_ncco, play_audio_into_call, or hangup on the voice submodule. The package handles serialization to Vonage's API format and parsing responses back into Python objects. It depends on vonage-http-client for HTTP transport, vonage-utils for shared utilities, and pydantic for data validation.

Use it for:

• Build an IVR (interactive voice response) system that plays prompts and routes calls based on DTMF input.
• Programmatically initiate outbound calls with custom audio or text-to-speech messages for notifications or surveys.
• Transfer an active call to a new NCCO or URL without dropping the connection.
• Play audio streams or TTS into an ongoing call for real-time announcements or hold messages.
• Query call history and status across your Vonage account with filtering by date, status, or conversation ID.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides Python bindings to Vonage's Voice API for making and managing phone calls, including call creation, transfer, audio/TTS playback, and NCCO (Call Control Object) building.

Yes. The package is actively maintained, has low install friction, carries no known vulnerabilities, and is the official Vonage Voice API client for Python. Install it if you need to integrate Vonage voice capabilities into a Python application; the Pydantic-based API and NCCO builder reduce boilerplate compared to raw HTTP calls.

Install

vonage-voice on PyPI

pip install vonage-voice

uv add vonage-voice

poetry add vonage-voice

Installing vonage-voice

Before you install

Low install friction with a pure-Python wheel and three lightweight runtime dependencies. Active maintenance with a recent release (25 days old) and ongoing repository activity.

License in practice

Permissive Apache license allows commercial and private use with minimal restrictions.

Quickstart

pip install vonage-voice

from vonage import Vonage, Auth
from vonage_voice import CreateCallRequest, Talk

vonage_client = Vonage(Auth('MY_AUTH_INFO'))
ncco = [Talk(text='Hello world', loop=3, language='en-GB')]
call = CreateCallRequest(
    to=[{'type': 'phone', 'number': '1234567890'}],
    ncco=ncco,
    random_from_number=True,
)
response = vonage_client.voice.create_call(call)

Requires Vonage authentication credentials and an active Vonage account.

Verify before relying

• Whether vonage-http-client and vonage-utils are maintained and have their own security track record.
• Specific latency or throughput characteristics for high-volume call operations.
• Whether the package supports webhook handling for inbound calls or only outbound call control.

Package facts

Evidence: vonage_voice-1.5.1-py3-none-any.whl

Tags

More Internet packages