feat: Messages API Updates (March 2026)

messages/src/vonage_messages/messages.py

@@ -1,7 +1,7 @@
 from pydantic import validate_call
 from vonage_http_client.http_client import HttpClient
 
-from .models import BaseMessage
+from .models import BaseMessage, ReplyingIndicatorText
 from .responses import SendMessageResponse
 
 
@@ -66,7 +66,9 @@ def send(
         return SendMessageResponse(**response)
 
     @validate_call
-    def mark_whatsapp_message_read(self, message_uuid: str) -> None:
+    def mark_whatsapp_message_read(
+        self, message_uuid: str, replying_indicator: ReplyingIndicatorText = None
+    ) -> None:
         """Mark a WhatsApp message as read.
 
         Note: to use this method, update the `api_host` attribute of the
@@ -78,11 +80,18 @@ def mark_whatsapp_message_read(self, message_uuid: str) -> None:
 
         Args:
             message_uuid (str): The unique identifier of the WhatsApp message to mark as read.
+            replying_indicator (ReplyingIndicatorText, optional): An object indicating whether to show the replying indicator on the WhatsApp message.
         """
+        body = {'status': 'read'}
+        if replying_indicator is not None:
+            body['replying_indicator'] = replying_indicator.model_dump(
+                by_alias=True, exclude_none=True
+            )
+
         self._http_client.patch(
             self._http_client.api_host,
             f'/v1/messages/{message_uuid}',
-            {'status': 'read'},
+            body,
             self._auth_type,
         )
 

messages/src/vonage_messages/models/__init__.py

@@ -1,5 +1,16 @@
 from .base_message import BaseMessage
-from .enums import ChannelType, EncodingType, MessageType, WebhookVersion
+from .enums import (
+    ChannelType,
+    EncodingType,
+    MessageType,
+    MmsContentItemType,
+    RcsCardOrientation,
+    RcsCardWidth,
+    RcsCategory,
+    RcsImageAlignment,
+    RcsMediaHeight,
+    WebhookVersion,
+)
 from .messenger import (
     MessengerAudio,
     MessengerFile,
@@ -9,8 +20,44 @@
     MessengerText,
     MessengerVideo,
 )
-from .mms import MmsAudio, MmsImage, MmsResource, MmsVcard, MmsVideo
-from .rcs import RcsCustom, RcsFile, RcsImage, RcsResource, RcsText, RcsVideo
+from .mms import (
+    MmsAudio,
+    MmsContent,
+    MmsContentItemAudio,
+    MmsContentItemFile,
+    MmsContentItemImage,
+    MmsContentItemVcard,
+    MmsContentItemVideo,
+    MmsFile,
+    MmsImage,
+    MmsResource,
+    MmsText,
+    MmsVcard,
+    MmsVideo,
+)
+from .rcs import (
+    RcsCard,
+    RcsCardMessage,
+    RcsCarousel,
+    RcsCarouselMessage,
+    RcsCustom,
+    RcsFile,
+    RcsImage,
+    RcsOptions,
+    RcsOptionsCard,
+    RcsOptionsCarousel,
+    RcsResource,
+    RcsSuggestionActionCreateCalendarEvent,
+    RcsSuggestionActionDial,
+    RcsSuggestionActionOpenUrl,
+    RcsSuggestionActionOpenUrlWebview,
+    RcsSuggestionActionShareLocation,
+    RcsSuggestionActionViewLocation,
+    RcsSuggestionBase,
+    RcsSuggestionReply,
+    RcsText,
+    RcsVideo,
+)
 from .sms import Sms, SmsOptions
 from .viber import (
     ViberAction,
@@ -27,6 +74,7 @@
     ViberVideoResource,
 )
 from .whatsapp import (
+    ReplyingIndicatorText,
     WhatsappAudio,
     WhatsappAudioResource,
     WhatsappContext,
@@ -59,16 +107,46 @@
     'MessengerText',
     'MessengerVideo',
     'MmsAudio',
+    'MmsContent',
+    'MmsContentItemImage',
+    'MmsContentItemAudio',
+    'MmsContentItemVideo',
+    'MmsContentItemFile',
+    'MmsContentItemVcard',
+    'MmsContentItemType',
+    'MmsFile',
     'MmsImage',
     'MmsResource',
+    'MmsText',
     'MmsVcard',
     'MmsVideo',
+    'RcsCard',
+    'RcsCardMessage',
+    'RcsCarousel',
+    'RcsCarouselMessage',
     'RcsCustom',
     'RcsFile',
     'RcsImage',
+    'RcsOptions',
+    'RcsOptionsCard',
+    'RcsOptionsCarousel',
     'RcsResource',
+    'RcsSuggestionActionCreateCalendarEvent',
+    'RcsSuggestionActionDial',
+    'RcsSuggestionActionOpenUrl',
+    'RcsSuggestionActionOpenUrlWebview',
+    'RcsSuggestionActionShareLocation',
+    'RcsSuggestionActionViewLocation',
+    'RcsSuggestionBase',
+    'RcsSuggestionReply',
     'RcsText',
     'RcsVideo',
+    'RcsCategory',
+    'RcsCardOrientation',
+    'RcsImageAlignment',
+    'RcsCardWidth',
+    'RcsMediaHeight',
+    'ReplyingIndicatorText',
     'Sms',
     'SmsOptions',
     'ViberAction',

messages/src/vonage_messages/models/enums.py

@@ -13,6 +13,9 @@ class MessageType(str, Enum):
     STICKER = 'sticker'
     CUSTOM = 'custom'
     VCARD = 'vcard'
+    CARD = 'card'
+    CAROUSEL = 'carousel'
+    CONTENT = 'content'
 
 
 class ChannelType(str, Enum):
@@ -37,3 +40,78 @@ class EncodingType(str, Enum):
     TEXT = 'text'
     UNICODE = 'unicode'
     AUTO = 'auto'
+
+
+class SuggestionType(str, Enum):
+    """The type of RCS suggestion."""
+
+    REPLY = 'reply'
+    DIAL = 'dial'
+    VIEW_LOCATION = 'view_location'
+    SHARE_LOCATION = 'share_location'
+    OPEN_URL = 'open_url'
+    OPEN_URL_IN_WEBVIEW = 'open_url_in_webview'
+    CREATE_CALENDAR_EVENT = 'create_calendar_event'
+
+
+class UrlWebviewViewMode(str, Enum):
+    """The view mode for an RCS suggestion that opens a URL in a webview."""
+
+    FULL = 'FULL'
+    TALL = 'TALL'
+    HALF = 'HALF'
+
+
+class RcsCategory(str, Enum):
+    """The category of an RCS message."""
+
+    ACKNOWLEDGEMENT = 'acknowledgement'
+    AUTHENTICATION = 'authentication'
+    PROMOTION = 'promotion'
+    SERVICE_REQUEST = 'service-request'
+    TRANSACTION = 'transaction'
+
+
+class RcsCardOrientation(str, Enum):
+    """The orientation of an RCS card."""
+
+    VERTICAL = 'VERTICAL'
+    HORIZONTAL = 'HORIZONTAL'
+
+
+class RcsImageAlignment(str, Enum):
+    """The alignment of an image on an RCS card."""
+
+    LEFT = 'LEFT'
+    RIGHT = 'RIGHT'
+
+
+class RcsCardWidth(str, Enum):
+    """The width of a card in an RCS carousel."""
+
+    SMALL = 'SMALL'
+    MEDIUM = 'MEDIUM'
+
+
+class RcsMediaHeight(str, Enum):
+    """The height of media on an RCS card."""
+
+    SHORT = 'SHORT'
+    MEDIUM = 'MEDIUM'
+    TALL = 'TALL'
+
+
+class MmsContentItemType(str, Enum):
+    """The type of a content item in an MMS Content message."""
+
+    IMAGE = 'image'
+    AUDIO = 'audio'
+    VIDEO = 'video'
+    FILE = 'file'
+    VCARD = 'vcard'
+
+
+class ReplyingIndicatorType(str, Enum):
+    """The type of a WhatsApp replying indicator."""
+
+    TEXT = 'text'