zavudev 0.18.0 → 0.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '0950796060af0403bdc55fe702c2ca0e1dccc89b62dad96f07fd2091c09a8e84'
-  data.tar.gz: '09a3b580f8bfcd5b9c1ebe6fc476c9ecca06a0a43b7bf902c4f4f143c80a5cf2'
+  metadata.gz: ac627d26a28d5901c971cff42e8d371b2d3d7dd0e33cce968fec7ed022b5e313
+  data.tar.gz: 8ae1361683e68009bdf39773686a547d8b52e9f09a03c51bc5cf0760e94cb2cd
 SHA512:
-  metadata.gz: 2b0d38348c027224bcbb54238392f4f923e1b8d904f30048bdceca9bc0a0cc07794c34199c15b9ac9d853877afb02de7197623493e3472c27abc0db0d3f31ca3
-  data.tar.gz: 3f888722850154270aeb1d7dff45e8501f42f4d47293310f64b95a5f71b7892f39b9cc95e1a7bfd0faa58875244199f88a38f283bb0d74f09750de607b70cfd9
+  metadata.gz: 8d404f2e36a900ead47771f278bc535196df248578a09eb2e1f60aee91b748c3715dff3c54b69583d243d8b5f6552eeeb9cc33e47d9d6af432bfce1acb2a7d59
+  data.tar.gz: a1bcb630fc1cd3cd1211d21a2683cc5e643aca7cf13b192df10ec38c42ca806844e4ec5c100c6354c2b141db05b3ba64f1a06c0008a76531df68b0c64e1ca8f1

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 0.19.0 (2026-07-23)
+
+Full Changelog: [v0.18.0...v0.19.0](https://github.com/zavudev/sdk-ruby/compare/v0.18.0...v0.19.0)
+
+### Features
+
+* **api:** api update ([e230076](https://github.com/zavudev/sdk-ruby/commit/e230076406ec38c134526941aaf8c13c0538d3f6))
+* **api:** api update ([901e2c2](https://github.com/zavudev/sdk-ruby/commit/901e2c29b4d1dbd840571683072bebbb17793e34))
+* **api:** api update ([e3e62c2](https://github.com/zavudev/sdk-ruby/commit/e3e62c2e9e5e9b7f1c7ffc15a0fb6553b290d7b3))
+* **stlc:** configurable CI runner and private-production-repo support in workflow templates ([e3cd9e9](https://github.com/zavudev/sdk-ruby/commit/e3cd9e94605059e0af8bef2b856805ef59bcdf30))
+
 ## 0.18.0 (2026-07-15)
 
 Full Changelog: [v0.17.0...v0.18.0](https://github.com/zavudev/sdk-ruby/compare/v0.17.0...v0.18.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.18.0"
+gem "zavudev", "~> 0.19.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/zavudev/models/channel.rb

@@ -2,10 +2,7 @@
 
 module Zavudev
   module Models
-    # 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.
+    # Delivery channel. Use 'auto' for intelligent routing.
     module Channel
       extend Zavudev::Internal::Type::Enum
 
@@ -13,7 +10,6 @@ module Zavudev
       SMS = :sms
       SMS_ONEWAY = :sms_oneway
       WHATSAPP = :whatsapp
-      WHATSAPP_ALT = :whatsapp_alt
       TELEGRAM = :telegram
       EMAIL = :email
       INSTAGRAM = :instagram

data/lib/zavudev/models/invitation.rb

@@ -64,7 +64,7 @@ module Zavudev
 
       # @!attribute connection_type
       #   How the client connects WhatsApp: `whatsapp_waba` (official Cloud API via
-      #   embedded signup) or `whatsapp_alt` (QR-linked).
+      #   embedded signup).
       #
       #   @return [Symbol, Zavudev::Models::Invitation::ConnectionType, nil]
       optional :connection_type, enum: -> { Zavudev::Invitation::ConnectionType }, api_name: :connectionType
@@ -144,14 +144,13 @@ module Zavudev
       end
 
       # How the client connects WhatsApp: `whatsapp_waba` (official Cloud API via
-      # embedded signup) or `whatsapp_alt` (QR-linked).
+      # embedded signup).
       #
       # @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>]

data/lib/zavudev/models/invitation_create_params.rb

@@ -35,9 +35,7 @@ module Zavudev
 
       # @!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.
+      #   signup to link an official WhatsApp Business Account.
       #
       #   @return [Symbol, Zavudev::Models::InvitationCreateParams::ConnectionType, nil]
       optional :connection_type,
@@ -78,14 +76,11 @@ module Zavudev
       #   @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.
+      # signup to link an official WhatsApp Business Account.
       module ConnectionType
         extend Zavudev::Internal::Type::Enum
 
         WHATSAPP_WABA = :whatsapp_waba
-        WHATSAPP_ALT = :whatsapp_alt
 
         # @!method self.values
         #   @return [Array<Symbol>]

data/lib/zavudev/models/message.rb

@@ -10,10 +10,7 @@ module Zavudev
       required :id, String
 
       # @!attribute channel
-      #   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.
+      #   Delivery channel. Use 'auto' for intelligent routing.
       #
       #   @return [Symbol, Zavudev::Models::Channel]
       required :channel, enum: -> { Zavudev::Channel }
@@ -46,6 +43,15 @@ module Zavudev
       #   @return [Zavudev::Models::MessageContent, nil]
       optional :content, -> { Zavudev::MessageContent }
 
+      # @!attribute conversation_id
+      #   ID of the conversation (inbox thread) this message belongs to. Use it to build a
+      #   direct dashboard link:
+      #   `https://dashboard.zavu.dev/{locale}/inbox?conv={conversationId}`. Omitted only
+      #   on legacy messages created before conversation threading.
+      #
+      #   @return [String, nil]
+      optional :conversation_id, String, api_name: :conversationId
+
       # @!attribute cost
       #   Zavu platform charge in USD for this message. Messaging is billed against your
       #   plan's monthly limits plus usage-based overage.
@@ -107,13 +113,13 @@ module Zavudev
       #   @return [Time, nil]
       optional :updated_at, Time, api_name: :updatedAt
 
-      # @!method initialize(id:, channel:, created_at:, message_type:, status:, to:, content: nil, cost: nil, cost_provider: nil, cost_total: nil, error_code: nil, error_message: nil, from: nil, metadata: nil, provider_message_id: nil, sender_id: nil, text: nil, updated_at: nil)
+      # @!method initialize(id:, channel:, created_at:, message_type:, status:, to:, content: nil, conversation_id: nil, cost: nil, cost_provider: nil, cost_total: nil, error_code: nil, error_message: nil, from: nil, metadata: nil, provider_message_id: nil, sender_id: nil, text: nil, updated_at: nil)
       #   Some parameter documentations has been truncated, see {Zavudev::Models::Message}
       #   for more details.
       #
       #   @param id [String]
       #
-      #   @param channel [Symbol, Zavudev::Models::Channel] Delivery channel. Use 'auto' for intelligent routing. `whatsapp_alt` is the QR-l
+      #   @param channel [Symbol, Zavudev::Models::Channel] Delivery channel. Use 'auto' for intelligent routing.
       #
       #   @param created_at [Time]
       #
@@ -125,6 +131,8 @@ module Zavudev
       #
       #   @param content [Zavudev::Models::MessageContent] Content for non-text message types (WhatsApp and Telegram).
       #
+      #   @param conversation_id [String] ID of the conversation (inbox thread) this message belongs to. Use it to build a
+      #
       #   @param cost [Float, nil] Zavu platform charge in USD for this message. Messaging is billed against your p
       #
       #   @param cost_provider [Float, nil] Carrier and delivery cost in USD.

data/lib/zavudev/models/message_send_params.rb

@@ -9,13 +9,10 @@ module Zavudev
 
       # @!attribute to
       #   Recipient phone number in E.164 format, email address, WhatsApp business-scoped
-      #   user ID (BSUID, e.g. `US.13491208655302741918`), WhatsApp group JID
-      #   (`<id>@g.us`, e.g. `120363000000000000@g.us`), or numeric chat ID (for
+      #   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. A group JID is only valid on the `whatsapp_alt` channel
-      #   and supports text and media (image, video, audio, document, sticker, location,
-      #   contact).
+      #   phone number is hidden.
       #
       #   @return [String]
       required :to, String

data/lib/zavudev/models/webhook_event.rb

@@ -17,22 +17,21 @@ module Zavudev
     #
     # **Inbound events:**
     #
-    # - `message.inbound`: New message received from a contact. Reactions are
-    #   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`. `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.status`: A contact posted a WhatsApp status/story (currently WhatsApp
-    #   Alternative only). It is NOT a conversation message and never enters the inbox
-    #   — it is delivered only if you subscribe to `message.status`. `data` carries
-    #   `from` (the author in E.164), `messageType` (`text`, `image`, `video`,
-    #   `audio`), `text` (caption/text when present), `mimetype` (for media stories),
-    #   and `providerTimestamp`. Media bytes are not included.
+    # - `message.inbound`: New message received from a contact. `data.conversationId`
+    #   is the inbox thread id (deep-link with
+    #   `https://dashboard.zavu.dev/{locale}/inbox?conv={conversationId}`); it is
+    #   `null` while the conversation row is still being created (the first message of
+    #   a brand-new thread, or several near-simultaneous first messages), where
+    #   `conversation.new` carries the id instead — `GET /v1/messages/{messageId}`
+    #   always has it. Reactions are 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`. `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:**
@@ -42,7 +41,11 @@ module Zavudev
     #
     # **Other events:**
     #
-    # - `conversation.new`: New conversation started with a contact
+    # - `conversation.new`: New conversation started with a contact. `data` carries
+    #   `conversationId` (the inbox thread id — deep-link with
+    #   `https://dashboard.zavu.dev/{locale}/inbox?conv={conversationId}`), the
+    #   `phoneNumber` or `email` key, `channel`, `firstMessageId`, `firstMessageText`,
+    #   and `profileName`.
     # - `template.status_changed`: WhatsApp template approval status changed
     #
     # **Partner events:**
@@ -65,7 +68,6 @@ module Zavudev
       MESSAGE_READ = :"message.read"
       MESSAGE_FAILED = :"message.failed"
       MESSAGE_INBOUND = :"message.inbound"
-      MESSAGE_STATUS = :"message.status"
       MESSAGE_UNSUPPORTED = :"message.unsupported"
       BROADCAST_STATUS_CHANGED = :"broadcast.status_changed"
       CONVERSATION_NEW = :"conversation.new"

data/lib/zavudev/resources/invitations.rb

@@ -7,17 +7,10 @@ module Zavudev
       # {Zavudev::Models::InvitationCreateParams} for more details.
       #
       # 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`.
+      # opens the returned `url` and completes Meta's embedded signup, linking an
+      # official WhatsApp Business Account. 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: {})
       #

data/lib/zavudev/resources/messages.rb

@@ -107,6 +107,17 @@ module Zavudev
       # - Unverified accounts: 200 messages per channel per day
       # - Complete KYC verification to increase limits to 10,000/day
       #
+      # **Email recipient pre-flight:** Email messages are validated automatically
+      # before dispatch. Sends that would be a guaranteed hard bounce are failed instead
+      # of sent, protecting your bounce rate: the message transitions to `failed`
+      # (visible via `GET /v1/messages/{messageId}` and the `message.failed` webhook)
+      # with `errorCode` set to `EMAIL_INVALID_RECIPIENT` (malformed address),
+      # `EMAIL_DOMAIN_NOT_FOUND` (recipient domain has no MX or A records), or
+      # `EMAIL_RECIPIENT_SUPPRESSED` (address is on your suppression list after a
+      # previous bounce or complaint). Advisory signals (role addresses, disposable
+      # domains) do not block sends — check them beforehand with
+      # `POST /v1/introspect/email`.
+      #
       # @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, WhatsApp busi

data/lib/zavudev/version.rb

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

data/rbi/zavudev/models/channel.rbi

@@ -2,10 +2,7 @@
 
 module Zavudev
   module Models
-    # 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.
+    # Delivery channel. Use 'auto' for intelligent routing.
     module Channel
       extend Zavudev::Internal::Type::Enum
 
@@ -16,7 +13,6 @@ 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/invitation.rbi

@@ -43,7 +43,7 @@ module Zavudev
       attr_accessor :completed_at
 
       # How the client connects WhatsApp: `whatsapp_waba` (official Cloud API via
-      # embedded signup) or `whatsapp_alt` (QR-linked).
+      # embedded signup).
       sig do
         returns(T.nilable(Zavudev::Invitation::ConnectionType::TaggedSymbol))
       end
@@ -106,7 +106,7 @@ module Zavudev
         client_phone: nil,
         completed_at: nil,
         # How the client connects WhatsApp: `whatsapp_waba` (official Cloud API via
-        # embedded signup) or `whatsapp_alt` (QR-linked).
+        # embedded signup).
         connection_type: nil,
         # ID of a pre-assigned Zavu phone number for WhatsApp registration.
         phone_number_id: nil,
@@ -165,7 +165,7 @@ module Zavudev
       end
 
       # How the client connects WhatsApp: `whatsapp_waba` (official Cloud API via
-      # embedded signup) or `whatsapp_alt` (QR-linked).
+      # embedded signup).
       module ConnectionType
         extend Zavudev::Internal::Type::Enum
 
@@ -178,11 +178,6 @@ module Zavudev
             :whatsapp_waba,
             Zavudev::Invitation::ConnectionType::TaggedSymbol
           )
-        WHATSAPP_ALT =
-          T.let(
-            :whatsapp_alt,
-            Zavudev::Invitation::ConnectionType::TaggedSymbol
-          )
 
         sig do
           override.returns(

data/rbi/zavudev/models/invitation_create_params.rbi

@@ -40,9 +40,7 @@ module Zavudev
       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.
+      # signup to link an official WhatsApp Business Account.
       sig do
         returns(
           T.nilable(Zavudev::InvitationCreateParams::ConnectionType::OrSymbol)
@@ -96,9 +94,7 @@ module Zavudev
         # 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.
+        # signup to link an official WhatsApp Business Account.
         connection_type: nil,
         # Number of days until the invitation expires.
         expires_in_days: nil,
@@ -128,9 +124,7 @@ module Zavudev
       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.
+      # signup to link an official WhatsApp Business Account.
       module ConnectionType
         extend Zavudev::Internal::Type::Enum
 
@@ -145,11 +139,6 @@ module Zavudev
             :whatsapp_waba,
             Zavudev::InvitationCreateParams::ConnectionType::TaggedSymbol
           )
-        WHATSAPP_ALT =
-          T.let(
-            :whatsapp_alt,
-            Zavudev::InvitationCreateParams::ConnectionType::TaggedSymbol
-          )
 
         sig do
           override.returns(

data/rbi/zavudev/models/message.rbi

@@ -9,10 +9,7 @@ module Zavudev
       sig { returns(String) }
       attr_accessor :id
 
-      # 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.
+      # Delivery channel. Use 'auto' for intelligent routing.
       sig { returns(Zavudev::Channel::TaggedSymbol) }
       attr_accessor :channel
 
@@ -37,6 +34,16 @@ module Zavudev
       sig { params(content: Zavudev::MessageContent::OrHash).void }
       attr_writer :content
 
+      # ID of the conversation (inbox thread) this message belongs to. Use it to build a
+      # direct dashboard link:
+      # `https://dashboard.zavu.dev/{locale}/inbox?conv={conversationId}`. Omitted only
+      # on legacy messages created before conversation threading.
+      sig { returns(T.nilable(String)) }
+      attr_reader :conversation_id
+
+      sig { params(conversation_id: String).void }
+      attr_writer :conversation_id
+
       # 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)) }
@@ -103,6 +110,7 @@ module Zavudev
           status: Zavudev::MessageStatus::OrSymbol,
           to: String,
           content: Zavudev::MessageContent::OrHash,
+          conversation_id: String,
           cost: T.nilable(Float),
           cost_provider: T.nilable(Float),
           cost_total: T.nilable(Float),
@@ -118,10 +126,7 @@ module Zavudev
       end
       def self.new(
         id:,
-        # 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.
+        # Delivery channel. Use 'auto' for intelligent routing.
         channel:,
         created_at:,
         # Type of message. Non-text types are supported by WhatsApp and Telegram (varies
@@ -131,6 +136,11 @@ module Zavudev
         to:,
         # Content for non-text message types (WhatsApp and Telegram).
         content: nil,
+        # ID of the conversation (inbox thread) this message belongs to. Use it to build a
+        # direct dashboard link:
+        # `https://dashboard.zavu.dev/{locale}/inbox?conv={conversationId}`. Omitted only
+        # on legacy messages created before conversation threading.
+        conversation_id: nil,
         # Zavu platform charge in USD for this message. Messaging is billed against your
         # plan's monthly limits plus usage-based overage.
         cost: nil,
@@ -161,6 +171,7 @@ module Zavudev
             status: Zavudev::MessageStatus::TaggedSymbol,
             to: String,
             content: Zavudev::MessageContent,
+            conversation_id: String,
             cost: T.nilable(Float),
             cost_provider: T.nilable(Float),
             cost_total: T.nilable(Float),

data/rbi/zavudev/models/message_send_params.rbi

@@ -12,13 +12,10 @@ module Zavudev
         end
 
       # Recipient phone number in E.164 format, email address, WhatsApp business-scoped
-      # user ID (BSUID, e.g. `US.13491208655302741918`), WhatsApp group JID
-      # (`<id>@g.us`, e.g. `120363000000000000@g.us`), or numeric chat ID (for
+      # 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. A group JID is only valid on the `whatsapp_alt` channel
-      # and supports text and media (image, video, audio, document, sticker, location,
-      # contact).
+      # phone number is hidden.
       sig { returns(String) }
       attr_accessor :to
 
@@ -145,13 +142,10 @@ module Zavudev
       end
       def self.new(
         # Recipient phone number in E.164 format, email address, WhatsApp business-scoped
-        # user ID (BSUID, e.g. `US.13491208655302741918`), WhatsApp group JID
-        # (`<id>@g.us`, e.g. `120363000000000000@g.us`), or numeric chat ID (for
+        # 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. A group JID is only valid on the `whatsapp_alt` channel
-        # and supports text and media (image, video, audio, document, sticker, location,
-        # contact).
+        # phone number is hidden.
         to:,
         # Email attachments. Only supported when channel is 'email'. Maximum 40MB total
         # size.

data/rbi/zavudev/models/webhook_event.rbi

@@ -17,22 +17,21 @@ module Zavudev
     #
     # **Inbound events:**
     #
-    # - `message.inbound`: New message received from a contact. Reactions are
-    #   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`. `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.status`: A contact posted a WhatsApp status/story (currently WhatsApp
-    #   Alternative only). It is NOT a conversation message and never enters the inbox
-    #   — it is delivered only if you subscribe to `message.status`. `data` carries
-    #   `from` (the author in E.164), `messageType` (`text`, `image`, `video`,
-    #   `audio`), `text` (caption/text when present), `mimetype` (for media stories),
-    #   and `providerTimestamp`. Media bytes are not included.
+    # - `message.inbound`: New message received from a contact. `data.conversationId`
+    #   is the inbox thread id (deep-link with
+    #   `https://dashboard.zavu.dev/{locale}/inbox?conv={conversationId}`); it is
+    #   `null` while the conversation row is still being created (the first message of
+    #   a brand-new thread, or several near-simultaneous first messages), where
+    #   `conversation.new` carries the id instead — `GET /v1/messages/{messageId}`
+    #   always has it. Reactions are 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`. `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:**
@@ -42,7 +41,11 @@ module Zavudev
     #
     # **Other events:**
     #
-    # - `conversation.new`: New conversation started with a contact
+    # - `conversation.new`: New conversation started with a contact. `data` carries
+    #   `conversationId` (the inbox thread id — deep-link with
+    #   `https://dashboard.zavu.dev/{locale}/inbox?conv={conversationId}`), the
+    #   `phoneNumber` or `email` key, `channel`, `firstMessageId`, `firstMessageText`,
+    #   and `profileName`.
     # - `template.status_changed`: WhatsApp template approval status changed
     #
     # **Partner events:**
@@ -72,8 +75,6 @@ module Zavudev
         T.let(:"message.failed", Zavudev::WebhookEvent::TaggedSymbol)
       MESSAGE_INBOUND =
         T.let(:"message.inbound", Zavudev::WebhookEvent::TaggedSymbol)
-      MESSAGE_STATUS =
-        T.let(:"message.status", Zavudev::WebhookEvent::TaggedSymbol)
       MESSAGE_UNSUPPORTED =
         T.let(:"message.unsupported", Zavudev::WebhookEvent::TaggedSymbol)
       BROADCAST_STATUS_CHANGED =

data/rbi/zavudev/resources/invitations.rbi

@@ -4,17 +4,10 @@ module Zavudev
   module Resources
     class Invitations
       # 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`.
+      # opens the returned `url` and completes Meta's embedded signup, linking an
+      # official WhatsApp Business Account. 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],
@@ -38,9 +31,7 @@ module Zavudev
         # 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.
+        # signup to link an official WhatsApp Business Account.
         connection_type: nil,
         # Number of days until the invitation expires.
         expires_in_days: nil,

data/rbi/zavudev/resources/messages.rbi

@@ -75,6 +75,17 @@ module Zavudev
       #
       # - Unverified accounts: 200 messages per channel per day
       # - Complete KYC verification to increase limits to 10,000/day
+      #
+      # **Email recipient pre-flight:** Email messages are validated automatically
+      # before dispatch. Sends that would be a guaranteed hard bounce are failed instead
+      # of sent, protecting your bounce rate: the message transitions to `failed`
+      # (visible via `GET /v1/messages/{messageId}` and the `message.failed` webhook)
+      # with `errorCode` set to `EMAIL_INVALID_RECIPIENT` (malformed address),
+      # `EMAIL_DOMAIN_NOT_FOUND` (recipient domain has no MX or A records), or
+      # `EMAIL_RECIPIENT_SUPPRESSED` (address is on your suppression list after a
+      # previous bounce or complaint). Advisory signals (role addresses, disposable
+      # domains) do not block sends — check them beforehand with
+      # `POST /v1/introspect/email`.
       sig do
         params(
           to: String,
@@ -96,13 +107,10 @@ module Zavudev
       end
       def send_(
         # Body param: Recipient phone number in E.164 format, email address, WhatsApp
-        # business-scoped user ID (BSUID, e.g. `US.13491208655302741918`), WhatsApp group
-        # JID (`<id>@g.us`, e.g. `120363000000000000@g.us`), 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. A group JID is only valid on the `whatsapp_alt` channel
-        # and supports text and media (image, video, audio, document, sticker, location,
-        # contact).
+        # 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/channel.rbs

@@ -5,7 +5,6 @@ module Zavudev
       | :sms
       | :sms_oneway
       | :whatsapp
-      | :whatsapp_alt
       | :telegram
       | :email
       | :instagram
@@ -19,7 +18,6 @@ module Zavudev
       SMS: :sms
       SMS_ONEWAY: :sms_oneway
       WHATSAPP: :whatsapp
-      WHATSAPP_ALT: :whatsapp_alt
       TELEGRAM: :telegram
       EMAIL: :email
       INSTAGRAM: :instagram

data/sig/zavudev/models/invitation.rbs

@@ -109,13 +109,12 @@ module Zavudev
         def self?.values: -> ::Array[Zavudev::Models::Invitation::status]
       end
 
-      type connection_type = :whatsapp_waba | :whatsapp_alt
+      type connection_type = :whatsapp_waba
 
       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

data/sig/zavudev/models/invitation_create_params.rbs

@@ -68,13 +68,12 @@ module Zavudev
         request_options: Zavudev::RequestOptions
       }
 
-      type connection_type = :whatsapp_waba | :whatsapp_alt
+      type connection_type = :whatsapp_waba
 
       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

data/sig/zavudev/models/message.rbs

@@ -9,6 +9,7 @@ module Zavudev
         status: Zavudev::Models::message_status,
         to: String,
         content: Zavudev::MessageContent,
+        conversation_id: String,
         cost: Float?,
         cost_provider: Float?,
         cost_total: Float?,
@@ -39,6 +40,10 @@ module Zavudev
 
       def content=: (Zavudev::MessageContent) -> Zavudev::MessageContent
 
+      attr_reader conversation_id: String?
+
+      def conversation_id=: (String) -> String
+
       attr_accessor cost: Float?
 
       attr_accessor cost_provider: Float?
@@ -81,6 +86,7 @@ module Zavudev
         status: Zavudev::Models::message_status,
         to: String,
         ?content: Zavudev::MessageContent,
+        ?conversation_id: String,
         ?cost: Float?,
         ?cost_provider: Float?,
         ?cost_total: Float?,
@@ -102,6 +108,7 @@ module Zavudev
         status: Zavudev::Models::message_status,
         to: String,
         content: Zavudev::MessageContent,
+        conversation_id: String,
         cost: Float?,
         cost_provider: Float?,
         cost_total: Float?,

data/sig/zavudev/models/webhook_event.rbs

@@ -7,7 +7,6 @@ module Zavudev
       | :"message.read"
       | :"message.failed"
       | :"message.inbound"
-      | :"message.status"
       | :"message.unsupported"
       | :"broadcast.status_changed"
       | :"conversation.new"
@@ -25,7 +24,6 @@ module Zavudev
       MESSAGE_READ: :"message.read"
       MESSAGE_FAILED: :"message.failed"
       MESSAGE_INBOUND: :"message.inbound"
-      MESSAGE_STATUS: :"message.status"
       MESSAGE_UNSUPPORTED: :"message.unsupported"
       BROADCAST_STATUS_CHANGED: :"broadcast.status_changed"
       CONVERSATION_NEW: :"conversation.new"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: zavudev
 version: !ruby/object:Gem::Version
-  version: 0.18.0
+  version: 0.19.0
 platform: ruby
 authors:
 - Zavudev
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-16 00:00:00.000000000 Z
+date: 2026-07-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi