vonage-messages

What it is and what it does

vonage-messages is a Python package that provides typed message models and integration helpers for Vonage's Messages API. It lets you construct and send messages across multiple channels—SMS, MMS, RCS, WhatsApp, Messenger, and Viber—by instantiating the appropriate message class (Sms, WhatsappText, MessengerImage, etc.) and passing it to a Vonage client's send method. The package is designed to be used as part of the main vonage package and relies on vonage-http-client for API communication and pydantic for message validation.

The package abstracts away API endpoint details and request formatting, letting you work with strongly-typed message objects instead of raw JSON. It supports message-type-specific options through submodels (e.g., MessengerOptions, MessengerResource) and provides convenience methods for channel-specific operations like marking WhatsApp messages as read or revoking RCS messages. It requires Python 3.9+ and depends on three runtime packages: vonage-http-client, vonage-utils, and pydantic.

Use it for:

• Send SMS notifications or alerts from a Python application using the Sms message model
• Build multi-channel messaging workflows that route messages to WhatsApp, Messenger, or Viber based on user preference
• Send rich media messages (images, audio, video, files) via MMS, RCS, or WhatsApp with typed message models
• Manage WhatsApp message state by marking messages as read or revoking RCS messages via Vonage API methods
• Integrate Vonage messaging into a larger application using the main vonage package with pre-built message types

Worth the install?

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

Provides Python message models and client integration for Vonage's Messages API, supporting SMS, MMS, RCS, WhatsApp, Messenger, and Viber message types.

Yes. vonage-messages is actively maintained, has low install friction, carries a permissive Apache license, and provides a clean, typed interface to Vonage's multi-channel messaging API. Install it if you need to send messages across SMS, MMS, RCS, WhatsApp, Messenger, or Viber from Python. It is best used as part of the main vonage package rather than standalone.

Install

vonage-messages on PyPI

pip install vonage-messages

uv add vonage-messages

poetry add vonage-messages

Installing vonage-messages

Before you install

Low install friction with pure Python wheel distribution. Active maintenance as of late July 2026, with recent release activity and 213 repository stars.

License in practice

Licensed under Apache Software License (permissive), allowing commercial and private use with minimal restrictions.

Quickstart

pip install vonage-messages

from vonage_messages import Sms
from vonage import Vonage, Auth

auth = Auth(application_id='my-app-id', private_key='my-key')
vonage_client = Vonage(auth)

message = Sms(from_='Vonage', to='1234567890', text='Hello')
vonage_client.messages.send(message)

Requires Python 3.9 or later. Vonage API credentials (application_id and private_key) are needed to authenticate and send messages.

Verify before relying

• Rate limits or quota restrictions on message sending through the Vonage API
• Delivery guarantees or retry behavior for failed message sends
• Regional API endpoint availability and latency characteristics

Package facts

Evidence: vonage_messages-1.7.1-py3-none-any.whl

Tags

More Internet packages