zavudev 0.15.0 → 0.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c47655af05e478984221142dbae0a305261b0e154bda36ba6d11370540f4b159
-  data.tar.gz: 61f9fb898a158c74137d0222bea09e68257115df2d451cf2b9d152bc76348000
+  metadata.gz: 8dd10ff9ca84c30d11bb953aa432150b013477e826ce1f23c0e03f751e97bb8f
+  data.tar.gz: e36f8e76c1c90c54b66c061b9e9ca3320566955505dd361e160b1f98e1cf3a74
 SHA512:
-  metadata.gz: 037ef7d5bd90239e10bf70596a6bf95041d0b80ca05f3086281e97e117464559ca1607cab6a6a315b541dcfeae46371c3adec06aff60dd4fc835e8d0715ee17d
-  data.tar.gz: 9a81cc375e69f7280ce8e49677582bf3d1cb1d227bf05f37c87ef697d8446af7b1b3ed61571cbc8a8973c128263a95850519ad2bbb3d33d2195515cbba8ba70e
+  metadata.gz: cca22267fd9aea296726f3be4e762a41a8e5c5ef3de9e20b6d39cf991d3392acf965913190928bd3dedd2bb21a23d2569ca98eb5a625b752c76c58a9da5f99e3
+  data.tar.gz: 62472e6e4ae3c6b4223f48ad80ad5b8444d0754d0740911a67b48b60137dbdbccec54279710966a3bc35fdb7fa176049c72ca5654f0252805b4fb235cb330d99

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.16.0 (2026-07-07)
+
+Full Changelog: [v0.15.0...v0.16.0](https://github.com/zavudev/sdk-ruby/compare/v0.15.0...v0.16.0)
+
+### Features
+
+* **api:** api update ([cd49564](https://github.com/zavudev/sdk-ruby/commit/cd49564f9c54a8aef2de33ad0b484cc6bd6c7ae3))
+* **api:** api update ([676212b](https://github.com/zavudev/sdk-ruby/commit/676212b365d2860826b55a8106ea129faaa533ed))
+
 ## 0.15.0 (2026-07-05)
 
 Full Changelog: [v0.14.0...v0.15.0](https://github.com/zavudev/sdk-ruby/compare/v0.14.0...v0.15.0)

data/README.md

@@ -26,7 +26,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "zavudev", "~> 0.15.0"
+gem "zavudev", "~> 0.16.0"
 ```
 
 <!-- x-release-please-end -->
@@ -235,11 +235,11 @@ zavudev.messages.send_(**params)
 Since this library does not depend on `sorbet-runtime`, it cannot provide [`T::Enum`](https://sorbet.org/docs/tenum) instances. Instead, we provide "tagged symbols" instead, which is always a primitive at runtime:
 
 ```ruby
-# :auto
-puts(Zavudev::Channel::AUTO)
+# :sms
+puts(Zavudev::MessageListParams::Channel::SMS)
 
-# Revealed type: `T.all(Zavudev::Channel, Symbol)`
-T.reveal_type(Zavudev::Channel::AUTO)
+# Revealed type: `T.all(Zavudev::MessageListParams::Channel, Symbol)`
+T.reveal_type(Zavudev::MessageListParams::Channel::SMS)
 ```
 
 Enum parameters have a "relaxed" type, so you can either pass in enum constants or their literal value:
@@ -247,13 +247,13 @@ Enum parameters have a "relaxed" type, so you can either pass in enum constants
 ```ruby
 # Using the enum constants preserves the tagged type information:
 zavudev.messages.list(
-  channel: Zavudev::Channel::AUTO,
+  channel: Zavudev::MessageListParams::Channel::SMS,
   # …
 )
 
 # Literal values are also permissible:
 zavudev.messages.list(
-  channel: :auto,
+  channel: :sms,
   # …
 )
 ```

data/lib/zavudev/models/broadcast_channel.rb

@@ -12,9 +12,6 @@ module Zavudev
       WHATSAPP = :whatsapp
       TELEGRAM = :telegram
       EMAIL = :email
-      INSTAGRAM = :instagram
-      MESSENGER = :messenger
-      VOICE = :voice
 
       # @!method self.values
       #   @return [Array<Symbol>]

data/lib/zavudev/models/channel.rb

@@ -2,7 +2,10 @@
 
 module Zavudev
   module Models
-    # Delivery channel. Use 'auto' for intelligent routing.
+    # Delivery channel. Use 'auto' for intelligent routing. `whatsapp_alt` is the
+    # QR-linked WhatsApp channel and is only accepted for teams with the WhatsApp
+    # Alternative feature enabled; the sender must have a connected whatsapp_alt
+    # session.
     module Channel
       extend Zavudev::Internal::Type::Enum
 
@@ -10,6 +13,7 @@ module Zavudev
       SMS = :sms
       SMS_ONEWAY = :sms_oneway
       WHATSAPP = :whatsapp
+      WHATSAPP_ALT = :whatsapp_alt
       TELEGRAM = :telegram
       EMAIL = :email
       INSTAGRAM = :instagram

data/lib/zavudev/models/contact_channel.rb

@@ -108,6 +108,7 @@ module Zavudev
         WHATSAPP = :whatsapp
         EMAIL = :email
         TELEGRAM = :telegram
+        INSTAGRAM = :instagram
         MESSENGER = :messenger
         VOICE = :voice
 

data/lib/zavudev/models/contact_create_params.rb

@@ -88,6 +88,7 @@ module Zavudev
           WHATSAPP = :whatsapp
           EMAIL = :email
           TELEGRAM = :telegram
+          INSTAGRAM = :instagram
           MESSENGER = :messenger
           VOICE = :voice
 

data/lib/zavudev/models/contacts/channel_add_params.rb

@@ -66,6 +66,7 @@ module Zavudev
           WHATSAPP = :whatsapp
           EMAIL = :email
           TELEGRAM = :telegram
+          INSTAGRAM = :instagram
           MESSENGER = :messenger
           VOICE = :voice
 

data/lib/zavudev/models/message.rb

@@ -10,7 +10,10 @@ module Zavudev
       required :id, String
 
       # @!attribute channel
-      #   Delivery channel. Use 'auto' for intelligent routing.
+      #   Delivery channel. Use 'auto' for intelligent routing. `whatsapp_alt` is the
+      #   QR-linked WhatsApp channel and is only accepted for teams with the WhatsApp
+      #   Alternative feature enabled; the sender must have a connected whatsapp_alt
+      #   session.
       #
       #   @return [Symbol, Zavudev::Models::Channel]
       required :channel, enum: -> { Zavudev::Channel }
@@ -44,19 +47,20 @@ module Zavudev
       optional :content, -> { Zavudev::MessageContent }
 
       # @!attribute cost
-      #   MAU cost in USD (charged for first contact of the month).
+      #   Zavu platform charge in USD for this message. Messaging is billed against your
+      #   plan's monthly limits plus usage-based overage.
       #
       #   @return [Float, nil]
       optional :cost, Float, nil?: true
 
       # @!attribute cost_provider
-      #   Provider cost in USD (Telnyx, SES, etc.).
+      #   Carrier and delivery cost in USD.
       #
       #   @return [Float, nil]
       optional :cost_provider, Float, api_name: :costProvider, nil?: true
 
       # @!attribute cost_total
-      #   Total cost in USD (MAU + provider cost).
+      #   Total cost in USD (platform charge + delivery cost).
       #
       #   @return [Float, nil]
       optional :cost_total, Float, api_name: :costTotal, nil?: true
@@ -109,7 +113,7 @@ module Zavudev
       #
       #   @param id [String]
       #
-      #   @param channel [Symbol, Zavudev::Models::Channel] Delivery channel. Use 'auto' for intelligent routing.
+      #   @param channel [Symbol, Zavudev::Models::Channel] Delivery channel. Use 'auto' for intelligent routing. `whatsapp_alt` is the QR-l
       #
       #   @param created_at [Time]
       #
@@ -121,11 +125,11 @@ module Zavudev
       #
       #   @param content [Zavudev::Models::MessageContent] Content for non-text message types (WhatsApp and Telegram).
       #
-      #   @param cost [Float, nil] MAU cost in USD (charged for first contact of the month).
+      #   @param cost [Float, nil] Zavu platform charge in USD for this message. Messaging is billed against your p
       #
-      #   @param cost_provider [Float, nil] Provider cost in USD (Telnyx, SES, etc.).
+      #   @param cost_provider [Float, nil] Carrier and delivery cost in USD.
       #
-      #   @param cost_total [Float, nil] Total cost in USD (MAU + provider cost).
+      #   @param cost_total [Float, nil] Total cost in USD (platform charge + delivery cost).
       #
       #   @param error_code [String, nil]
       #

data/lib/zavudev/models/message_list_params.rb

@@ -8,10 +8,10 @@ module Zavudev
       include Zavudev::Internal::Type::RequestParameters
 
       # @!attribute channel
-      #   Delivery channel. Use 'auto' for intelligent routing.
+      #   Filter by delivery channel.
       #
-      #   @return [Symbol, Zavudev::Models::Channel, nil]
-      optional :channel, enum: -> { Zavudev::Channel }
+      #   @return [Symbol, Zavudev::Models::MessageListParams::Channel, nil]
+      optional :channel, enum: -> { Zavudev::MessageListParams::Channel }
 
       # @!attribute cursor
       #
@@ -24,9 +24,10 @@ module Zavudev
       optional :limit, Integer
 
       # @!attribute status
+      #   Filter by status. Not all stored statuses are filterable.
       #
-      #   @return [Symbol, Zavudev::Models::MessageStatus, nil]
-      optional :status, enum: -> { Zavudev::MessageStatus }
+      #   @return [Symbol, Zavudev::Models::MessageListParams::Status, nil]
+      optional :status, enum: -> { Zavudev::MessageListParams::Status }
 
       # @!attribute to
       #
@@ -34,17 +35,49 @@ module Zavudev
       optional :to, String
 
       # @!method initialize(channel: nil, cursor: nil, limit: nil, status: nil, to: nil, request_options: {})
-      #   @param channel [Symbol, Zavudev::Models::Channel] Delivery channel. Use 'auto' for intelligent routing.
+      #   @param channel [Symbol, Zavudev::Models::MessageListParams::Channel] Filter by delivery channel.
       #
       #   @param cursor [String]
       #
       #   @param limit [Integer]
       #
-      #   @param status [Symbol, Zavudev::Models::MessageStatus]
+      #   @param status [Symbol, Zavudev::Models::MessageListParams::Status] Filter by status. Not all stored statuses are filterable.
       #
       #   @param to [String]
       #
       #   @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}]
+
+      # Filter by delivery channel.
+      module Channel
+        extend Zavudev::Internal::Type::Enum
+
+        SMS = :sms
+        SMS_ONEWAY = :sms_oneway
+        WHATSAPP = :whatsapp
+        EMAIL = :email
+        TELEGRAM = :telegram
+        INSTAGRAM = :instagram
+        MESSENGER = :messenger
+        VOICE = :voice
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # Filter by status. Not all stored statuses are filterable.
+      module Status
+        extend Zavudev::Internal::Type::Enum
+
+        QUEUED = :queued
+        SENDING = :sending
+        SENT = :sent
+        DELIVERED = :delivered
+        FAILED = :failed
+        RECEIVED = :received
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/zavudev/models/phone_number_type.rb

@@ -6,7 +6,7 @@ module Zavudev
       extend Zavudev::Internal::Type::Enum
 
       LOCAL = :local
-      MOBILE = :mobile
+      NATIONAL = :national
       TOLL_FREE = :tollFree
 
       # @!method self.values

data/lib/zavudev/models/url_list_verified_params.rb

@@ -39,6 +39,7 @@ module Zavudev
         PENDING = :pending
         APPROVED = :approved
         REJECTED = :rejected
+        ESCALATED = :escalated
         MALICIOUS = :malicious
 
         # @!method self.values

data/lib/zavudev/models/verified_url.rb

@@ -67,6 +67,7 @@ module Zavudev
         PENDING = :pending
         APPROVED = :approved
         REJECTED = :rejected
+        ESCALATED = :escalated
         MALICIOUS = :malicious
 
         # @!method self.values

data/lib/zavudev/models.rb

@@ -119,14 +119,6 @@ module Zavudev
 
   ContactUpdateParams = Zavudev::Models::ContactUpdateParams
 
-  DataExport = Zavudev::Models::DataExport
-
-  ExportCreateParams = Zavudev::Models::ExportCreateParams
-
-  ExportListParams = Zavudev::Models::ExportListParams
-
-  ExportRetrieveParams = Zavudev::Models::ExportRetrieveParams
-
   FunctionCreateParams = Zavudev::Models::FunctionCreateParams
 
   FunctionDeleteParams = Zavudev::Models::FunctionDeleteParams
@@ -207,8 +199,6 @@ module Zavudev
 
   PhoneNumberUpdateParams = Zavudev::Models::PhoneNumberUpdateParams
 
-  PlanRetrieveParams = Zavudev::Models::PlanRetrieveParams
-
   RegulatoryDocument = Zavudev::Models::RegulatoryDocument
 
   RegulatoryDocumentCreateParams = Zavudev::Models::RegulatoryDocumentCreateParams
@@ -287,8 +277,6 @@ module Zavudev
 
   URLSubmitForVerificationParams = Zavudev::Models::URLSubmitForVerificationParams
 
-  UsageRetrieveParams = Zavudev::Models::UsageRetrieveParams
-
   VerifiedURL = Zavudev::Models::VerifiedURL
 
   WebhookEvent = Zavudev::Models::WebhookEvent

data/lib/zavudev/resources/exports.rb

@@ -3,81 +3,6 @@
 module Zavudev
   module Resources
     class Exports
-      # Create a new data export job. The export will be processed asynchronously and
-      # the download URL will be available when status is 'completed'. Export links
-      # expire after 24 hours.
-      #
-      # @overload create(data_types:, date_from: nil, date_to: nil, request_options: {})
-      #
-      # @param data_types [Array<Symbol, Zavudev::Models::ExportCreateParams::DataType>] List of data types to include in the export.
-      #
-      # @param date_from [Time] Start date for data to export (inclusive).
-      #
-      # @param date_to [Time] End date for data to export (inclusive).
-      #
-      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
-      #
-      # @return [Zavudev::Models::ExportCreateResponse]
-      #
-      # @see Zavudev::Models::ExportCreateParams
-      def create(params)
-        parsed, options = Zavudev::ExportCreateParams.dump_request(params)
-        @client.request(
-          method: :post,
-          path: "v1/exports",
-          body: parsed,
-          model: Zavudev::Models::ExportCreateResponse,
-          options: options
-        )
-      end
-
-      # Get details of a specific data export, including download URL when completed.
-      #
-      # @overload retrieve(export_id, request_options: {})
-      #
-      # @param export_id [String]
-      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
-      #
-      # @return [Zavudev::Models::ExportRetrieveResponse]
-      #
-      # @see Zavudev::Models::ExportRetrieveParams
-      def retrieve(export_id, params = {})
-        @client.request(
-          method: :get,
-          path: ["v1/exports/%1$s", export_id],
-          model: Zavudev::Models::ExportRetrieveResponse,
-          options: params[:request_options]
-        )
-      end
-
-      # List data exports for this project.
-      #
-      # @overload list(cursor: nil, limit: nil, status: nil, request_options: {})
-      #
-      # @param cursor [String]
-      #
-      # @param limit [Integer]
-      #
-      # @param status [Symbol, Zavudev::Models::ExportListParams::Status] Status of a data export job.
-      #
-      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
-      #
-      # @return [Zavudev::Internal::Cursor<Zavudev::Models::DataExport>]
-      #
-      # @see Zavudev::Models::ExportListParams
-      def list(params = {})
-        parsed, options = Zavudev::ExportListParams.dump_request(params)
-        query = Zavudev::Internal::Util.encode_query_params(parsed)
-        @client.request(
-          method: :get,
-          path: "v1/exports",
-          query: query,
-          page: Zavudev::Internal::Cursor,
-          model: Zavudev::DataExport,
-          options: options
-        )
-      end
-
       # @api private
       #
       # @param client [Zavudev::Client]

data/lib/zavudev/resources/messages.rb

@@ -26,13 +26,13 @@ module Zavudev
       #
       # @overload list(channel: nil, cursor: nil, limit: nil, status: nil, to: nil, request_options: {})
       #
-      # @param channel [Symbol, Zavudev::Models::Channel] Delivery channel. Use 'auto' for intelligent routing.
+      # @param channel [Symbol, Zavudev::Models::MessageListParams::Channel] Filter by delivery channel.
       #
       # @param cursor [String]
       #
       # @param limit [Integer]
       #
-      # @param status [Symbol, Zavudev::Models::MessageStatus]
+      # @param status [Symbol, Zavudev::Models::MessageListParams::Status] Filter by status. Not all stored statuses are filterable.
       #
       # @param to [String]
       #

data/lib/zavudev/resources/plan.rb

@@ -3,25 +3,6 @@
 module Zavudev
   module Resources
     class Plan
-      # Get the current subscription plan for the API key's team, including tier,
-      # billing interval, and period dates.
-      #
-      # @overload retrieve(request_options: {})
-      #
-      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
-      #
-      # @return [Zavudev::Models::PlanRetrieveResponse]
-      #
-      # @see Zavudev::Models::PlanRetrieveParams
-      def retrieve(params = {})
-        @client.request(
-          method: :get,
-          path: "v1/plan",
-          model: Zavudev::Models::PlanRetrieveResponse,
-          options: params[:request_options]
-        )
-      end
-
       # @api private
       #
       # @param client [Zavudev::Client]

data/lib/zavudev/resources/usage.rb

@@ -3,25 +3,6 @@
 module Zavudev
   module Resources
     class Usage
-      # Get the current month's usage counters for A2P messages and emails, along with
-      # the tier limits.
-      #
-      # @overload retrieve(request_options: {})
-      #
-      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
-      #
-      # @return [Zavudev::Models::UsageRetrieveResponse]
-      #
-      # @see Zavudev::Models::UsageRetrieveParams
-      def retrieve(params = {})
-        @client.request(
-          method: :get,
-          path: "v1/usage",
-          model: Zavudev::Models::UsageRetrieveResponse,
-          options: params[:request_options]
-        )
-      end
-
       # @api private
       #
       # @param client [Zavudev::Client]

data/lib/zavudev/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Zavudev
-  VERSION = "0.15.0"
+  VERSION = "0.16.0"
 end

data/lib/zavudev.rb

@@ -113,12 +113,6 @@ require_relative "zavudev/models/contacts/channel_set_primary_response"
 require_relative "zavudev/models/contacts/channel_update_params"
 require_relative "zavudev/models/contacts/channel_update_response"
 require_relative "zavudev/models/contact_update_params"
-require_relative "zavudev/models/data_export"
-require_relative "zavudev/models/export_create_params"
-require_relative "zavudev/models/export_create_response"
-require_relative "zavudev/models/export_list_params"
-require_relative "zavudev/models/export_retrieve_params"
-require_relative "zavudev/models/export_retrieve_response"
 require_relative "zavudev/models/function_create_params"
 require_relative "zavudev/models/function_create_response"
 require_relative "zavudev/models/function_delete_params"
@@ -214,8 +208,6 @@ require_relative "zavudev/models/phone_number_status"
 require_relative "zavudev/models/phone_number_type"
 require_relative "zavudev/models/phone_number_update_params"
 require_relative "zavudev/models/phone_number_update_response"
-require_relative "zavudev/models/plan_retrieve_params"
-require_relative "zavudev/models/plan_retrieve_response"
 require_relative "zavudev/models/regulatory_document"
 require_relative "zavudev/models/regulatory_document_create_params"
 require_relative "zavudev/models/regulatory_document_create_response"
@@ -332,8 +324,6 @@ require_relative "zavudev/models/url_retrieve_details_params"
 require_relative "zavudev/models/url_retrieve_details_response"
 require_relative "zavudev/models/url_submit_for_verification_params"
 require_relative "zavudev/models/url_submit_for_verification_response"
-require_relative "zavudev/models/usage_retrieve_params"
-require_relative "zavudev/models/usage_retrieve_response"
 require_relative "zavudev/models/verified_url"
 require_relative "zavudev/models/webhook_event"
 require_relative "zavudev/models/webhook_secret_response"

data/rbi/zavudev/models/broadcast_channel.rbi

@@ -15,9 +15,6 @@ module Zavudev
       WHATSAPP = T.let(:whatsapp, Zavudev::BroadcastChannel::TaggedSymbol)
       TELEGRAM = T.let(:telegram, Zavudev::BroadcastChannel::TaggedSymbol)
       EMAIL = T.let(:email, Zavudev::BroadcastChannel::TaggedSymbol)
-      INSTAGRAM = T.let(:instagram, Zavudev::BroadcastChannel::TaggedSymbol)
-      MESSENGER = T.let(:messenger, Zavudev::BroadcastChannel::TaggedSymbol)
-      VOICE = T.let(:voice, Zavudev::BroadcastChannel::TaggedSymbol)
 
       sig do
         override.returns(T::Array[Zavudev::BroadcastChannel::TaggedSymbol])

data/rbi/zavudev/models/channel.rbi

@@ -2,7 +2,10 @@
 
 module Zavudev
   module Models
-    # Delivery channel. Use 'auto' for intelligent routing.
+    # Delivery channel. Use 'auto' for intelligent routing. `whatsapp_alt` is the
+    # QR-linked WhatsApp channel and is only accepted for teams with the WhatsApp
+    # Alternative feature enabled; the sender must have a connected whatsapp_alt
+    # session.
     module Channel
       extend Zavudev::Internal::Type::Enum
 
@@ -13,6 +16,7 @@ module Zavudev
       SMS = T.let(:sms, Zavudev::Channel::TaggedSymbol)
       SMS_ONEWAY = T.let(:sms_oneway, Zavudev::Channel::TaggedSymbol)
       WHATSAPP = T.let(:whatsapp, Zavudev::Channel::TaggedSymbol)
+      WHATSAPP_ALT = T.let(:whatsapp_alt, Zavudev::Channel::TaggedSymbol)
       TELEGRAM = T.let(:telegram, Zavudev::Channel::TaggedSymbol)
       EMAIL = T.let(:email, Zavudev::Channel::TaggedSymbol)
       INSTAGRAM = T.let(:instagram, Zavudev::Channel::TaggedSymbol)

data/rbi/zavudev/models/contact_channel.rbi

@@ -146,6 +146,8 @@ module Zavudev
         EMAIL = T.let(:email, Zavudev::ContactChannel::Channel::TaggedSymbol)
         TELEGRAM =
           T.let(:telegram, Zavudev::ContactChannel::Channel::TaggedSymbol)
+        INSTAGRAM =
+          T.let(:instagram, Zavudev::ContactChannel::Channel::TaggedSymbol)
         MESSENGER =
           T.let(:messenger, Zavudev::ContactChannel::Channel::TaggedSymbol)
         VOICE = T.let(:voice, Zavudev::ContactChannel::Channel::TaggedSymbol)

data/rbi/zavudev/models/contact_create_params.rbi

@@ -169,6 +169,11 @@ module Zavudev
               :telegram,
               Zavudev::ContactCreateParams::Channel::Channel::TaggedSymbol
             )
+          INSTAGRAM =
+            T.let(
+              :instagram,
+              Zavudev::ContactCreateParams::Channel::Channel::TaggedSymbol
+            )
           MESSENGER =
             T.let(
               :messenger,

data/rbi/zavudev/models/contacts/channel_add_params.rbi

@@ -120,6 +120,11 @@ module Zavudev
               :telegram,
               Zavudev::Contacts::ChannelAddParams::Channel::TaggedSymbol
             )
+          INSTAGRAM =
+            T.let(
+              :instagram,
+              Zavudev::Contacts::ChannelAddParams::Channel::TaggedSymbol
+            )
           MESSENGER =
             T.let(
               :messenger,

data/rbi/zavudev/models/message.rbi

@@ -9,7 +9,10 @@ module Zavudev
       sig { returns(String) }
       attr_accessor :id
 
-      # Delivery channel. Use 'auto' for intelligent routing.
+      # Delivery channel. Use 'auto' for intelligent routing. `whatsapp_alt` is the
+      # QR-linked WhatsApp channel and is only accepted for teams with the WhatsApp
+      # Alternative feature enabled; the sender must have a connected whatsapp_alt
+      # session.
       sig { returns(Zavudev::Channel::TaggedSymbol) }
       attr_accessor :channel
 
@@ -34,15 +37,16 @@ module Zavudev
       sig { params(content: Zavudev::MessageContent::OrHash).void }
       attr_writer :content
 
-      # MAU cost in USD (charged for first contact of the month).
+      # Zavu platform charge in USD for this message. Messaging is billed against your
+      # plan's monthly limits plus usage-based overage.
       sig { returns(T.nilable(Float)) }
       attr_accessor :cost
 
-      # Provider cost in USD (Telnyx, SES, etc.).
+      # Carrier and delivery cost in USD.
       sig { returns(T.nilable(Float)) }
       attr_accessor :cost_provider
 
-      # Total cost in USD (MAU + provider cost).
+      # Total cost in USD (platform charge + delivery cost).
       sig { returns(T.nilable(Float)) }
       attr_accessor :cost_total
 
@@ -114,7 +118,10 @@ module Zavudev
       end
       def self.new(
         id:,
-        # Delivery channel. Use 'auto' for intelligent routing.
+        # Delivery channel. Use 'auto' for intelligent routing. `whatsapp_alt` is the
+        # QR-linked WhatsApp channel and is only accepted for teams with the WhatsApp
+        # Alternative feature enabled; the sender must have a connected whatsapp_alt
+        # session.
         channel:,
         created_at:,
         # Type of message. Non-text types are supported by WhatsApp and Telegram (varies
@@ -124,11 +131,12 @@ module Zavudev
         to:,
         # Content for non-text message types (WhatsApp and Telegram).
         content: nil,
-        # MAU cost in USD (charged for first contact of the month).
+        # Zavu platform charge in USD for this message. Messaging is billed against your
+        # plan's monthly limits plus usage-based overage.
         cost: nil,
-        # Provider cost in USD (Telnyx, SES, etc.).
+        # Carrier and delivery cost in USD.
         cost_provider: nil,
-        # Total cost in USD (MAU + provider cost).
+        # Total cost in USD (platform charge + delivery cost).
         cost_total: nil,
         error_code: nil,
         error_message: nil,