zavudev 0.13.0 → 0.15.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7acd7e0349acb65eada647202880714e47e5b9cfcfa12583f77e27db11993f82
-  data.tar.gz: bf70c460648a96d443e2bd79b8be6a678306be02d38fdde537c186aec4ba77d3
+  metadata.gz: c47655af05e478984221142dbae0a305261b0e154bda36ba6d11370540f4b159
+  data.tar.gz: 61f9fb898a158c74137d0222bea09e68257115df2d451cf2b9d152bc76348000
 SHA512:
-  metadata.gz: 751db02e34b4d9766f38893a15353ebdca10307eec404418c8ea0a690c0c566f65d1e6fe5d25297872b17a877d0d13c5c230cfc0cd094445c4d97a6e54a12cce
-  data.tar.gz: 636bc3237e0a5048dc8f955d3335d23bd2c7bb45e894597bdc6c936386cb1b44599b0f5433b57b31f921d99cbacc0b748668667b63ce043f15cb0d198614cc32
+  metadata.gz: 037ef7d5bd90239e10bf70596a6bf95041d0b80ca05f3086281e97e117464559ca1607cab6a6a315b541dcfeae46371c3adec06aff60dd4fc835e8d0715ee17d
+  data.tar.gz: 9a81cc375e69f7280ce8e49677582bf3d1cb1d227bf05f37c87ef697d8446af7b1b3ed61571cbc8a8973c128263a95850519ad2bbb3d33d2195515cbba8ba70e

data/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## 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)
+
+### Features
+
+* **api:** api update ([0afbaaf](https://github.com/zavudev/sdk-ruby/commit/0afbaaf775796e6901f790329e5ead6b623fbae6))
+* **api:** api update ([ae16782](https://github.com/zavudev/sdk-ruby/commit/ae16782c53d59b8eb136ed27e9df09b1d889fd2c))
+
+
+### Chores
+
+* **internal:** bound formatter parallelism to CPU count ([40b3e99](https://github.com/zavudev/sdk-ruby/commit/40b3e99d17ef2297beb30ff8af97fd0b43fb0d75))
+
+## 0.14.0 (2026-06-24)
+
+Full Changelog: [v0.13.0...v0.14.0](https://github.com/zavudev/sdk-ruby/compare/v0.13.0...v0.14.0)
+
+### Features
+
+* **api:** api update ([6a691cd](https://github.com/zavudev/sdk-ruby/commit/6a691cd596deb8fa5cb32118684e8f811798cc50))
+* **api:** api update ([91a78af](https://github.com/zavudev/sdk-ruby/commit/91a78af6beed7c6a17abb0928965532976d5eac5))
+
+
+### Bug Fixes
+
+* **client:** send content-type header for requests with an omitted optional body ([73b6654](https://github.com/zavudev/sdk-ruby/commit/73b66544a2756aaf64f189c9eb47ba66cd09f305))
+
 ## 0.13.0 (2026-06-07)
 
 Full Changelog: [v0.12.0...v0.13.0](https://github.com/zavudev/sdk-ruby/compare/v0.12.0...v0.13.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.13.0"
+gem "zavudev", "~> 0.15.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/zavudev/internal/transport/base_client.rb

@@ -306,7 +306,10 @@ module Zavudev
               Zavudev::Internal::Util.deep_merge(*[req[:body], opts[:extra_body]].compact)
             end
 
-          headers.delete("content-type") if body.nil?
+          # Generated methods always pass `req[:body]` for operations that define a
+          # request body, so only elide the content-type header when the operation
+          # has no body at all, not when an optional body param was omitted.
+          headers.delete("content-type") if body.nil? && !req.key?(:body)
 
           url = Zavudev::Internal::Util.join_parsed_uri(
             @base_url_components,

data/lib/zavudev/models/broadcast_channel.rb

@@ -13,6 +13,7 @@ module Zavudev
       TELEGRAM = :telegram
       EMAIL = :email
       INSTAGRAM = :instagram
+      MESSENGER = :messenger
       VOICE = :voice
 
       # @!method self.values

data/lib/zavudev/models/channel.rb

@@ -13,6 +13,7 @@ module Zavudev
       TELEGRAM = :telegram
       EMAIL = :email
       INSTAGRAM = :instagram
+      MESSENGER = :messenger
       VOICE = :voice
 
       # @!method self.values

data/lib/zavudev/models/contact.rb

@@ -131,6 +131,7 @@ module Zavudev
         TELEGRAM = :telegram
         EMAIL = :email
         INSTAGRAM = :instagram
+        MESSENGER = :messenger
         VOICE = :voice
 
         # @!method self.values

data/lib/zavudev/models/contact_channel.rb

@@ -108,6 +108,7 @@ module Zavudev
         WHATSAPP = :whatsapp
         EMAIL = :email
         TELEGRAM = :telegram
+        MESSENGER = :messenger
         VOICE = :voice
 
         # @!method self.values

data/lib/zavudev/models/contact_create_params.rb

@@ -88,6 +88,7 @@ module Zavudev
           WHATSAPP = :whatsapp
           EMAIL = :email
           TELEGRAM = :telegram
+          MESSENGER = :messenger
           VOICE = :voice
 
           # @!method self.values

data/lib/zavudev/models/contact_update_params.rb

@@ -44,6 +44,7 @@ module Zavudev
         TELEGRAM = :telegram
         EMAIL = :email
         INSTAGRAM = :instagram
+        MESSENGER = :messenger
         VOICE = :voice
 
         # @!method self.values

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

@@ -66,6 +66,7 @@ module Zavudev
           WHATSAPP = :whatsapp
           EMAIL = :email
           TELEGRAM = :telegram
+          MESSENGER = :messenger
           VOICE = :voice
 
           # @!method self.values

data/lib/zavudev/models/invitation.rb

@@ -62,6 +62,13 @@ module Zavudev
       #   @return [Time, nil]
       optional :completed_at, Time, api_name: :completedAt, nil?: true
 
+      # @!attribute connection_type
+      #   How the client connects WhatsApp: `whatsapp_waba` (official Cloud API via
+      #   embedded signup) or `whatsapp_alt` (QR-linked).
+      #
+      #   @return [Symbol, Zavudev::Models::Invitation::ConnectionType, nil]
+      optional :connection_type, enum: -> { Zavudev::Invitation::ConnectionType }, api_name: :connectionType
+
       # @!attribute phone_number_id
       #   ID of a pre-assigned Zavu phone number for WhatsApp registration.
       #
@@ -84,7 +91,10 @@ module Zavudev
       #   @return [Time, nil]
       optional :viewed_at, Time, api_name: :viewedAt, nil?: true
 
-      # @!method initialize(id:, token:, created_at:, expires_at:, status:, updated_at:, url:, client_email: nil, client_name: nil, client_phone: nil, completed_at: nil, phone_number_id: nil, sender_id: nil, started_at: nil, viewed_at: nil)
+      # @!method initialize(id:, token:, created_at:, expires_at:, status:, updated_at:, url:, client_email: nil, client_name: nil, client_phone: nil, completed_at: nil, connection_type: nil, phone_number_id: nil, sender_id: nil, started_at: nil, viewed_at: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Zavudev::Models::Invitation} for more details.
+      #
       #   @param id [String]
       #
       #   @param token [String] Unique invitation token.
@@ -107,6 +117,8 @@ module Zavudev
       #
       #   @param completed_at [Time, nil]
       #
+      #   @param connection_type [Symbol, Zavudev::Models::Invitation::ConnectionType] How the client connects WhatsApp: `whatsapp_waba` (official Cloud API via embedd
+      #
       #   @param phone_number_id [String, nil] ID of a pre-assigned Zavu phone number for WhatsApp registration.
       #
       #   @param sender_id [String, nil] ID of the sender created when invitation is completed.
@@ -130,6 +142,20 @@ module Zavudev
         # @!method self.values
         #   @return [Array<Symbol>]
       end
+
+      # How the client connects WhatsApp: `whatsapp_waba` (official Cloud API via
+      # embedded signup) or `whatsapp_alt` (QR-linked).
+      #
+      # @see Zavudev::Models::Invitation#connection_type
+      module ConnectionType
+        extend Zavudev::Internal::Type::Enum
+
+        WHATSAPP_WABA = :whatsapp_waba
+        WHATSAPP_ALT = :whatsapp_alt
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/zavudev/models/invitation_create_params.rb

@@ -33,6 +33,17 @@ module Zavudev
       #   @return [String, nil]
       optional :client_phone, String, api_name: :clientPhone
 
+      # @!attribute connection_type
+      #   How the client connects WhatsApp. `whatsapp_waba` (default) runs Meta's embedded
+      #   signup to link an official WhatsApp Business Account. `whatsapp_alt` links the
+      #   number by scanning a QR code — available only to teams with the WhatsApp
+      #   Alternative feature enabled.
+      #
+      #   @return [Symbol, Zavudev::Models::InvitationCreateParams::ConnectionType, nil]
+      optional :connection_type,
+               enum: -> { Zavudev::InvitationCreateParams::ConnectionType },
+               api_name: :connectionType
+
       # @!attribute expires_in_days
       #   Number of days until the invitation expires.
       #
@@ -46,7 +57,7 @@ module Zavudev
       #   @return [String, nil]
       optional :phone_number_id, String, api_name: :phoneNumberId
 
-      # @!method initialize(allowed_phone_countries: nil, client_email: nil, client_name: nil, client_phone: nil, expires_in_days: nil, phone_number_id: nil, request_options: {})
+      # @!method initialize(allowed_phone_countries: nil, client_email: nil, client_name: nil, client_phone: nil, connection_type: nil, expires_in_days: nil, phone_number_id: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Zavudev::Models::InvitationCreateParams} for more details.
       #
@@ -58,11 +69,27 @@ module Zavudev
       #
       #   @param client_phone [String] Phone number of the client in E.164 format.
       #
+      #   @param connection_type [Symbol, Zavudev::Models::InvitationCreateParams::ConnectionType] How the client connects WhatsApp. `whatsapp_waba` (default) runs Meta's embedded
+      #
       #   @param expires_in_days [Integer] Number of days until the invitation expires.
       #
       #   @param phone_number_id [String] ID of a Zavu phone number to pre-assign for WhatsApp registration. If provided,
       #
       #   @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}]
+
+      # How the client connects WhatsApp. `whatsapp_waba` (default) runs Meta's embedded
+      # signup to link an official WhatsApp Business Account. `whatsapp_alt` links the
+      # number by scanning a QR code — available only to teams with the WhatsApp
+      # Alternative feature enabled.
+      module ConnectionType
+        extend Zavudev::Internal::Type::Enum
+
+        WHATSAPP_WABA = :whatsapp_waba
+        WHATSAPP_ALT = :whatsapp_alt
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/zavudev/models/message_send_params.rb

@@ -8,8 +8,11 @@ module Zavudev
       include Zavudev::Internal::Type::RequestParameters
 
       # @!attribute to
-      #   Recipient phone number in E.164 format, email address, or numeric chat ID (for
-      #   Telegram/Instagram).
+      #   Recipient phone number in E.164 format, email address, WhatsApp business-scoped
+      #   user ID (BSUID, e.g. `US.13491208655302741918`), or numeric chat ID (for
+      #   Telegram/Instagram/Messenger). A BSUID is routed to WhatsApp and sent via the
+      #   `recipient` field; use it to message a contact who adopted a username and whose
+      #   phone number is hidden.
       #
       #   @return [String]
       required :to, String
@@ -101,7 +104,7 @@ module Zavudev
       #   Some parameter documentations has been truncated, see
       #   {Zavudev::Models::MessageSendParams} for more details.
       #
-      #   @param to [String] Recipient phone number in E.164 format, email address, or numeric chat ID (for T
+      #   @param to [String] Recipient phone number in E.164 format, email address, WhatsApp business-scoped
       #
       #   @param attachments [Array<Zavudev::Models::MessageSendParams::Attachment>] Email attachments. Only supported when channel is 'email'. Maximum 40MB total si
       #

data/lib/zavudev/models/webhook_event.rb

@@ -21,7 +21,12 @@ module Zavudev
     #   delivered as `message.inbound` with `messageType='reaction'`. When the contact
     #   replied to (quoted) an earlier message, `data.content` carries the reply
     #   context: `replyToMessageId`, `replyToProviderMessageId`, `replyToFrom`,
-    #   `replyToText`, and `replyToMessageType`.
+    #   `replyToText`, and `replyToMessageType`. `data.providerTimestamp` is the
+    #   provider's original receive time in Unix milliseconds (the moment the channel
+    #   received the message from the contact — WhatsApp, Telegram, Instagram,
+    #   Messenger; `null` for SMS and email). Compare it against the top-level
+    #   `timestamp` (when Zavu dispatched the webhook) to detect and ignore delayed
+    #   deliveries.
     # - `message.unsupported`: Received a message type that is not supported
     #
     # **Broadcast events:**

data/lib/zavudev/resources/invitations.rb

@@ -6,11 +6,20 @@ module Zavudev
       # Some parameter documentations has been truncated, see
       # {Zavudev::Models::InvitationCreateParams} for more details.
       #
-      # Create a partner invitation link for a client to connect their WhatsApp Business
-      # account. The client will complete Meta's embedded signup flow and the resulting
-      # sender will be created in your project.
+      # Create a partner invitation link for a client to connect WhatsApp. The client
+      # opens the returned `url` and connects. Set `connectionType` to choose how they
+      # connect:
       #
-      # @overload create(allowed_phone_countries: nil, client_email: nil, client_name: nil, client_phone: nil, expires_in_days: nil, phone_number_id: nil, request_options: {})
+      # - `whatsapp_waba` (default): the client completes Meta's embedded signup,
+      #   linking an official WhatsApp Business Account.
+      # - `whatsapp_alt`: the client links their number by scanning a QR code. Requires
+      #   the WhatsApp Alternative feature to be enabled for your team (otherwise
+      #   returns 400).
+      #
+      # Either way, the resulting sender is created in your project when the client
+      # completes the flow, and the invitation transitions to `completed`.
+      #
+      # @overload create(allowed_phone_countries: nil, client_email: nil, client_name: nil, client_phone: nil, connection_type: nil, expires_in_days: nil, phone_number_id: nil, request_options: {})
       #
       # @param allowed_phone_countries [Array<String>] ISO country codes for allowed phone numbers.
       #
@@ -20,6 +29,8 @@ module Zavudev
       #
       # @param client_phone [String] Phone number of the client in E.164 format.
       #
+      # @param connection_type [Symbol, Zavudev::Models::InvitationCreateParams::ConnectionType] How the client connects WhatsApp. `whatsapp_waba` (default) runs Meta's embedded
+      #
       # @param expires_in_days [Integer] Number of days until the invitation expires.
       #
       # @param phone_number_id [String] ID of a Zavu phone number to pre-assign for WhatsApp registration. If provided,

data/lib/zavudev/resources/messages.rb

@@ -109,7 +109,7 @@ module Zavudev
       #
       # @overload send_(to:, attachments: nil, channel: nil, content: nil, fallback_enabled: nil, html_body: nil, idempotency_key: nil, message_type: nil, metadata: nil, reply_to: nil, subject: nil, text: nil, voice_language: nil, zavu_sender: nil, request_options: {})
       #
-      # @param to [String] Body param: Recipient phone number in E.164 format, email address, or numeric ch
+      # @param to [String] Body param: Recipient phone number in E.164 format, email address, WhatsApp busi
       #
       # @param attachments [Array<Zavudev::Models::MessageSendParams::Attachment>] Body param: Email attachments. Only supported when channel is 'email'. Maximum 4
       #

data/lib/zavudev/version.rb

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

data/rbi/zavudev/models/broadcast_channel.rbi

@@ -16,6 +16,7 @@ module Zavudev
       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

data/rbi/zavudev/models/channel.rbi

@@ -16,6 +16,7 @@ module Zavudev
       TELEGRAM = T.let(:telegram, Zavudev::Channel::TaggedSymbol)
       EMAIL = T.let(:email, Zavudev::Channel::TaggedSymbol)
       INSTAGRAM = T.let(:instagram, Zavudev::Channel::TaggedSymbol)
+      MESSENGER = T.let(:messenger, Zavudev::Channel::TaggedSymbol)
       VOICE = T.let(:voice, Zavudev::Channel::TaggedSymbol)
 
       sig { override.returns(T::Array[Zavudev::Channel::TaggedSymbol]) }

data/rbi/zavudev/models/contact.rbi

@@ -178,6 +178,8 @@ module Zavudev
         EMAIL = T.let(:email, Zavudev::Contact::DefaultChannel::TaggedSymbol)
         INSTAGRAM =
           T.let(:instagram, Zavudev::Contact::DefaultChannel::TaggedSymbol)
+        MESSENGER =
+          T.let(:messenger, Zavudev::Contact::DefaultChannel::TaggedSymbol)
         VOICE = T.let(:voice, Zavudev::Contact::DefaultChannel::TaggedSymbol)
 
         sig do

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)
+        MESSENGER =
+          T.let(:messenger, Zavudev::ContactChannel::Channel::TaggedSymbol)
         VOICE = T.let(:voice, Zavudev::ContactChannel::Channel::TaggedSymbol)
 
         sig do

data/rbi/zavudev/models/contact_create_params.rbi

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

data/rbi/zavudev/models/contact_update_params.rbi

@@ -95,6 +95,11 @@ module Zavudev
             :instagram,
             Zavudev::ContactUpdateParams::DefaultChannel::TaggedSymbol
           )
+        MESSENGER =
+          T.let(
+            :messenger,
+            Zavudev::ContactUpdateParams::DefaultChannel::TaggedSymbol
+          )
         VOICE =
           T.let(
             :voice,

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

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

data/rbi/zavudev/models/invitation.rbi

@@ -42,6 +42,20 @@ module Zavudev
       sig { returns(T.nilable(Time)) }
       attr_accessor :completed_at
 
+      # How the client connects WhatsApp: `whatsapp_waba` (official Cloud API via
+      # embedded signup) or `whatsapp_alt` (QR-linked).
+      sig do
+        returns(T.nilable(Zavudev::Invitation::ConnectionType::TaggedSymbol))
+      end
+      attr_reader :connection_type
+
+      sig do
+        params(
+          connection_type: Zavudev::Invitation::ConnectionType::OrSymbol
+        ).void
+      end
+      attr_writer :connection_type
+
       # ID of a pre-assigned Zavu phone number for WhatsApp registration.
       sig { returns(T.nilable(String)) }
       attr_accessor :phone_number_id
@@ -69,6 +83,7 @@ module Zavudev
           client_name: T.nilable(String),
           client_phone: T.nilable(String),
           completed_at: T.nilable(Time),
+          connection_type: Zavudev::Invitation::ConnectionType::OrSymbol,
           phone_number_id: T.nilable(String),
           sender_id: T.nilable(String),
           started_at: T.nilable(Time),
@@ -90,6 +105,9 @@ module Zavudev
         client_name: nil,
         client_phone: nil,
         completed_at: nil,
+        # How the client connects WhatsApp: `whatsapp_waba` (official Cloud API via
+        # embedded signup) or `whatsapp_alt` (QR-linked).
+        connection_type: nil,
         # ID of a pre-assigned Zavu phone number for WhatsApp registration.
         phone_number_id: nil,
         # ID of the sender created when invitation is completed.
@@ -113,6 +131,7 @@ module Zavudev
             client_name: T.nilable(String),
             client_phone: T.nilable(String),
             completed_at: T.nilable(Time),
+            connection_type: Zavudev::Invitation::ConnectionType::TaggedSymbol,
             phone_number_id: T.nilable(String),
             sender_id: T.nilable(String),
             started_at: T.nilable(Time),
@@ -144,6 +163,35 @@ module Zavudev
         def self.values
         end
       end
+
+      # How the client connects WhatsApp: `whatsapp_waba` (official Cloud API via
+      # embedded signup) or `whatsapp_alt` (QR-linked).
+      module ConnectionType
+        extend Zavudev::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Zavudev::Invitation::ConnectionType) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        WHATSAPP_WABA =
+          T.let(
+            :whatsapp_waba,
+            Zavudev::Invitation::ConnectionType::TaggedSymbol
+          )
+        WHATSAPP_ALT =
+          T.let(
+            :whatsapp_alt,
+            Zavudev::Invitation::ConnectionType::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[Zavudev::Invitation::ConnectionType::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
     end
   end
 end

data/rbi/zavudev/models/invitation_create_params.rbi

@@ -39,6 +39,25 @@ module Zavudev
       sig { params(client_phone: String).void }
       attr_writer :client_phone
 
+      # How the client connects WhatsApp. `whatsapp_waba` (default) runs Meta's embedded
+      # signup to link an official WhatsApp Business Account. `whatsapp_alt` links the
+      # number by scanning a QR code — available only to teams with the WhatsApp
+      # Alternative feature enabled.
+      sig do
+        returns(
+          T.nilable(Zavudev::InvitationCreateParams::ConnectionType::OrSymbol)
+        )
+      end
+      attr_reader :connection_type
+
+      sig do
+        params(
+          connection_type:
+            Zavudev::InvitationCreateParams::ConnectionType::OrSymbol
+        ).void
+      end
+      attr_writer :connection_type
+
       # Number of days until the invitation expires.
       sig { returns(T.nilable(Integer)) }
       attr_reader :expires_in_days
@@ -60,6 +79,8 @@ module Zavudev
           client_email: String,
           client_name: String,
           client_phone: String,
+          connection_type:
+            Zavudev::InvitationCreateParams::ConnectionType::OrSymbol,
           expires_in_days: Integer,
           phone_number_id: String,
           request_options: Zavudev::RequestOptions::OrHash
@@ -74,6 +95,11 @@ module Zavudev
         client_name: nil,
         # Phone number of the client in E.164 format.
         client_phone: nil,
+        # How the client connects WhatsApp. `whatsapp_waba` (default) runs Meta's embedded
+        # signup to link an official WhatsApp Business Account. `whatsapp_alt` links the
+        # number by scanning a QR code — available only to teams with the WhatsApp
+        # Alternative feature enabled.
+        connection_type: nil,
         # Number of days until the invitation expires.
         expires_in_days: nil,
         # ID of a Zavu phone number to pre-assign for WhatsApp registration. If provided,
@@ -90,6 +116,8 @@ module Zavudev
             client_email: String,
             client_name: String,
             client_phone: String,
+            connection_type:
+              Zavudev::InvitationCreateParams::ConnectionType::OrSymbol,
             expires_in_days: Integer,
             phone_number_id: String,
             request_options: Zavudev::RequestOptions
@@ -98,6 +126,41 @@ module Zavudev
       end
       def to_hash
       end
+
+      # How the client connects WhatsApp. `whatsapp_waba` (default) runs Meta's embedded
+      # signup to link an official WhatsApp Business Account. `whatsapp_alt` links the
+      # number by scanning a QR code — available only to teams with the WhatsApp
+      # Alternative feature enabled.
+      module ConnectionType
+        extend Zavudev::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Zavudev::InvitationCreateParams::ConnectionType)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        WHATSAPP_WABA =
+          T.let(
+            :whatsapp_waba,
+            Zavudev::InvitationCreateParams::ConnectionType::TaggedSymbol
+          )
+        WHATSAPP_ALT =
+          T.let(
+            :whatsapp_alt,
+            Zavudev::InvitationCreateParams::ConnectionType::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Zavudev::InvitationCreateParams::ConnectionType::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
     end
   end
 end

data/rbi/zavudev/models/message_send_params.rbi

@@ -11,8 +11,11 @@ module Zavudev
           T.any(Zavudev::MessageSendParams, Zavudev::Internal::AnyHash)
         end
 
-      # Recipient phone number in E.164 format, email address, or numeric chat ID (for
-      # Telegram/Instagram).
+      # Recipient phone number in E.164 format, email address, WhatsApp business-scoped
+      # user ID (BSUID, e.g. `US.13491208655302741918`), or numeric chat ID (for
+      # Telegram/Instagram/Messenger). A BSUID is routed to WhatsApp and sent via the
+      # `recipient` field; use it to message a contact who adopted a username and whose
+      # phone number is hidden.
       sig { returns(String) }
       attr_accessor :to
 
@@ -138,8 +141,11 @@ module Zavudev
         ).returns(T.attached_class)
       end
       def self.new(
-        # Recipient phone number in E.164 format, email address, or numeric chat ID (for
-        # Telegram/Instagram).
+        # Recipient phone number in E.164 format, email address, WhatsApp business-scoped
+        # user ID (BSUID, e.g. `US.13491208655302741918`), or numeric chat ID (for
+        # Telegram/Instagram/Messenger). A BSUID is routed to WhatsApp and sent via the
+        # `recipient` field; use it to message a contact who adopted a username and whose
+        # phone number is hidden.
         to:,
         # Email attachments. Only supported when channel is 'email'. Maximum 40MB total
         # size.

data/rbi/zavudev/models/webhook_event.rbi

@@ -21,7 +21,12 @@ module Zavudev
     #   delivered as `message.inbound` with `messageType='reaction'`. When the contact
     #   replied to (quoted) an earlier message, `data.content` carries the reply
     #   context: `replyToMessageId`, `replyToProviderMessageId`, `replyToFrom`,
-    #   `replyToText`, and `replyToMessageType`.
+    #   `replyToText`, and `replyToMessageType`. `data.providerTimestamp` is the
+    #   provider's original receive time in Unix milliseconds (the moment the channel
+    #   received the message from the contact — WhatsApp, Telegram, Instagram,
+    #   Messenger; `null` for SMS and email). Compare it against the top-level
+    #   `timestamp` (when Zavu dispatched the webhook) to detect and ignore delayed
+    #   deliveries.
     # - `message.unsupported`: Received a message type that is not supported
     #
     # **Broadcast events:**

data/rbi/zavudev/resources/invitations.rbi

@@ -3,15 +3,26 @@
 module Zavudev
   module Resources
     class Invitations
-      # Create a partner invitation link for a client to connect their WhatsApp Business
-      # account. The client will complete Meta's embedded signup flow and the resulting
-      # sender will be created in your project.
+      # Create a partner invitation link for a client to connect WhatsApp. The client
+      # opens the returned `url` and connects. Set `connectionType` to choose how they
+      # connect:
+      #
+      # - `whatsapp_waba` (default): the client completes Meta's embedded signup,
+      #   linking an official WhatsApp Business Account.
+      # - `whatsapp_alt`: the client links their number by scanning a QR code. Requires
+      #   the WhatsApp Alternative feature to be enabled for your team (otherwise
+      #   returns 400).
+      #
+      # Either way, the resulting sender is created in your project when the client
+      # completes the flow, and the invitation transitions to `completed`.
       sig do
         params(
           allowed_phone_countries: T::Array[String],
           client_email: String,
           client_name: String,
           client_phone: String,
+          connection_type:
+            Zavudev::InvitationCreateParams::ConnectionType::OrSymbol,
           expires_in_days: Integer,
           phone_number_id: String,
           request_options: Zavudev::RequestOptions::OrHash
@@ -26,6 +37,11 @@ module Zavudev
         client_name: nil,
         # Phone number of the client in E.164 format.
         client_phone: nil,
+        # How the client connects WhatsApp. `whatsapp_waba` (default) runs Meta's embedded
+        # signup to link an official WhatsApp Business Account. `whatsapp_alt` links the
+        # number by scanning a QR code — available only to teams with the WhatsApp
+        # Alternative feature enabled.
+        connection_type: nil,
         # Number of days until the invitation expires.
         expires_in_days: nil,
         # ID of a Zavu phone number to pre-assign for WhatsApp registration. If provided,

data/rbi/zavudev/resources/messages.rbi

@@ -94,8 +94,11 @@ module Zavudev
         ).returns(Zavudev::MessageResponse)
       end
       def send_(
-        # Body param: Recipient phone number in E.164 format, email address, or numeric
-        # chat ID (for Telegram/Instagram).
+        # Body param: Recipient phone number in E.164 format, email address, WhatsApp
+        # business-scoped user ID (BSUID, e.g. `US.13491208655302741918`), or numeric chat
+        # ID (for Telegram/Instagram/Messenger). A BSUID is routed to WhatsApp and sent
+        # via the `recipient` field; use it to message a contact who adopted a username
+        # and whose phone number is hidden.
         to:,
         # Body param: Email attachments. Only supported when channel is 'email'. Maximum
         # 40MB total size.

data/sig/zavudev/models/broadcast_channel.rbs

@@ -8,6 +8,7 @@ module Zavudev
       | :telegram
       | :email
       | :instagram
+      | :messenger
       | :voice
 
     module BroadcastChannel
@@ -20,6 +21,7 @@ module Zavudev
       TELEGRAM: :telegram
       EMAIL: :email
       INSTAGRAM: :instagram
+      MESSENGER: :messenger
       VOICE: :voice
 
       def self?.values: -> ::Array[Zavudev::Models::broadcast_channel]

data/sig/zavudev/models/channel.rbs

@@ -8,6 +8,7 @@ module Zavudev
       | :telegram
       | :email
       | :instagram
+      | :messenger
       | :voice
 
     module Channel
@@ -20,6 +21,7 @@ module Zavudev
       TELEGRAM: :telegram
       EMAIL: :email
       INSTAGRAM: :instagram
+      MESSENGER: :messenger
       VOICE: :voice
 
       def self?.values: -> ::Array[Zavudev::Models::channel]

data/sig/zavudev/models/contact.rbs

@@ -109,7 +109,7 @@ module Zavudev
       }
 
       type default_channel =
-        :sms | :whatsapp | :telegram | :email | :instagram | :voice
+        :sms | :whatsapp | :telegram | :email | :instagram | :messenger | :voice
 
       module DefaultChannel
         extend Zavudev::Internal::Type::Enum
@@ -119,6 +119,7 @@ module Zavudev
         TELEGRAM: :telegram
         EMAIL: :email
         INSTAGRAM: :instagram
+        MESSENGER: :messenger
         VOICE: :voice
 
         def self?.values: -> ::Array[Zavudev::Models::Contact::default_channel]

data/sig/zavudev/models/contact_channel.rbs

@@ -85,7 +85,7 @@ module Zavudev
         updated_at: Time
       }
 
-      type channel = :sms | :whatsapp | :email | :telegram | :voice
+      type channel = :sms | :whatsapp | :email | :telegram | :messenger | :voice
 
       module Channel
         extend Zavudev::Internal::Type::Enum
@@ -94,6 +94,7 @@ module Zavudev
         WHATSAPP: :whatsapp
         EMAIL: :email
         TELEGRAM: :telegram
+        MESSENGER: :messenger
         VOICE: :voice
 
         def self?.values: -> ::Array[Zavudev::Models::ContactChannel::channel]

data/sig/zavudev/models/contact_create_params.rbs

@@ -78,7 +78,8 @@ module Zavudev
           label: String
         }
 
-        type channel = :sms | :whatsapp | :email | :telegram | :voice
+        type channel =
+          :sms | :whatsapp | :email | :telegram | :messenger | :voice
 
         module Channel
           extend Zavudev::Internal::Type::Enum
@@ -87,6 +88,7 @@ module Zavudev
           WHATSAPP: :whatsapp
           EMAIL: :email
           TELEGRAM: :telegram
+          MESSENGER: :messenger
           VOICE: :voice
 
           def self?.values: -> ::Array[Zavudev::Models::ContactCreateParams::Channel::channel]

data/sig/zavudev/models/contact_update_params.rbs

@@ -35,7 +35,7 @@ module Zavudev
       }
 
       type default_channel =
-        :sms | :whatsapp | :telegram | :email | :instagram | :voice
+        :sms | :whatsapp | :telegram | :email | :instagram | :messenger | :voice
 
       module DefaultChannel
         extend Zavudev::Internal::Type::Enum
@@ -45,6 +45,7 @@ module Zavudev
         TELEGRAM: :telegram
         EMAIL: :email
         INSTAGRAM: :instagram
+        MESSENGER: :messenger
         VOICE: :voice
 
         def self?.values: -> ::Array[Zavudev::Models::ContactUpdateParams::default_channel]

data/sig/zavudev/models/contacts/channel_add_params.rbs

@@ -54,7 +54,8 @@ module Zavudev
           request_options: Zavudev::RequestOptions
         }
 
-        type channel = :sms | :whatsapp | :email | :telegram | :voice
+        type channel =
+          :sms | :whatsapp | :email | :telegram | :messenger | :voice
 
         module Channel
           extend Zavudev::Internal::Type::Enum
@@ -63,6 +64,7 @@ module Zavudev
           WHATSAPP: :whatsapp
           EMAIL: :email
           TELEGRAM: :telegram
+          MESSENGER: :messenger
           VOICE: :voice
 
           def self?.values: -> ::Array[Zavudev::Models::Contacts::ChannelAddParams::channel]

data/sig/zavudev/models/invitation.rbs

@@ -13,6 +13,7 @@ module Zavudev
         client_name: String?,
         client_phone: String?,
         completed_at: Time?,
+        connection_type: Zavudev::Models::Invitation::connection_type,
         phone_number_id: String?,
         sender_id: String?,
         started_at: Time?,
@@ -42,6 +43,12 @@ module Zavudev
 
       attr_accessor completed_at: Time?
 
+      attr_reader connection_type: Zavudev::Models::Invitation::connection_type?
+
+      def connection_type=: (
+        Zavudev::Models::Invitation::connection_type
+      ) -> Zavudev::Models::Invitation::connection_type
+
       attr_accessor phone_number_id: String?
 
       attr_accessor sender_id: String?
@@ -62,6 +69,7 @@ module Zavudev
         ?client_name: String?,
         ?client_phone: String?,
         ?completed_at: Time?,
+        ?connection_type: Zavudev::Models::Invitation::connection_type,
         ?phone_number_id: String?,
         ?sender_id: String?,
         ?started_at: Time?,
@@ -80,6 +88,7 @@ module Zavudev
         client_name: String?,
         client_phone: String?,
         completed_at: Time?,
+        connection_type: Zavudev::Models::Invitation::connection_type,
         phone_number_id: String?,
         sender_id: String?,
         started_at: Time?,
@@ -99,6 +108,17 @@ module Zavudev
 
         def self?.values: -> ::Array[Zavudev::Models::Invitation::status]
       end
+
+      type connection_type = :whatsapp_waba | :whatsapp_alt
+
+      module ConnectionType
+        extend Zavudev::Internal::Type::Enum
+
+        WHATSAPP_WABA: :whatsapp_waba
+        WHATSAPP_ALT: :whatsapp_alt
+
+        def self?.values: -> ::Array[Zavudev::Models::Invitation::connection_type]
+      end
     end
   end
 end

data/sig/zavudev/models/invitation_create_params.rbs

@@ -6,6 +6,7 @@ module Zavudev
         client_email: String,
         client_name: String,
         client_phone: String,
+        connection_type: Zavudev::Models::InvitationCreateParams::connection_type,
         expires_in_days: Integer,
         phone_number_id: String
       }
@@ -31,6 +32,12 @@ module Zavudev
 
       def client_phone=: (String) -> String
 
+      attr_reader connection_type: Zavudev::Models::InvitationCreateParams::connection_type?
+
+      def connection_type=: (
+        Zavudev::Models::InvitationCreateParams::connection_type
+      ) -> Zavudev::Models::InvitationCreateParams::connection_type
+
       attr_reader expires_in_days: Integer?
 
       def expires_in_days=: (Integer) -> Integer
@@ -44,6 +51,7 @@ module Zavudev
         ?client_email: String,
         ?client_name: String,
         ?client_phone: String,
+        ?connection_type: Zavudev::Models::InvitationCreateParams::connection_type,
         ?expires_in_days: Integer,
         ?phone_number_id: String,
         ?request_options: Zavudev::request_opts
@@ -54,10 +62,22 @@ module Zavudev
         client_email: String,
         client_name: String,
         client_phone: String,
+        connection_type: Zavudev::Models::InvitationCreateParams::connection_type,
         expires_in_days: Integer,
         phone_number_id: String,
         request_options: Zavudev::RequestOptions
       }
+
+      type connection_type = :whatsapp_waba | :whatsapp_alt
+
+      module ConnectionType
+        extend Zavudev::Internal::Type::Enum
+
+        WHATSAPP_WABA: :whatsapp_waba
+        WHATSAPP_ALT: :whatsapp_alt
+
+        def self?.values: -> ::Array[Zavudev::Models::InvitationCreateParams::connection_type]
+      end
     end
   end
 end

data/sig/zavudev/resources/invitations.rbs

@@ -6,6 +6,7 @@ module Zavudev
         ?client_email: String,
         ?client_name: String,
         ?client_phone: String,
+        ?connection_type: Zavudev::Models::InvitationCreateParams::connection_type,
         ?expires_in_days: Integer,
         ?phone_number_id: String,
         ?request_options: Zavudev::request_opts

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: zavudev
 version: !ruby/object:Gem::Version
-  version: 0.13.0
+  version: 0.15.0
 platform: ruby
 authors:
 - Zavudev
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-08 00:00:00.000000000 Z
+date: 2026-07-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi