zavudev 0.11.0 → 0.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 31fc9cb2bdd57145a425db99ba4a661bee75e90ba40c1e7cc67a162739fe37f9
-  data.tar.gz: eb9e7b3ddd8cb6470d9c3b34f5bf9a53ca8692ae45e4fd36d3c9d328b180e8dd
+  metadata.gz: 7acd7e0349acb65eada647202880714e47e5b9cfcfa12583f77e27db11993f82
+  data.tar.gz: bf70c460648a96d443e2bd79b8be6a678306be02d38fdde537c186aec4ba77d3
 SHA512:
-  metadata.gz: 1242a227dd76d5a43f68581b50f92844963e81b8f392a1e71f613cad7c88f98a1c3b43fc63c1fc130ac23ac9bf7d740d8c0243be6e0ca7292545f6e76ff51942
-  data.tar.gz: ca5d5b577c6210261dd24cae7d95466451134cb4a23e1b71648d64f83fa96ea684b99897afd94138e3d1644e0e425d0d9f7cc59aed7899175aa5a36df7ce3b27
+  metadata.gz: 751db02e34b4d9766f38893a15353ebdca10307eec404418c8ea0a690c0c566f65d1e6fe5d25297872b17a877d0d13c5c230cfc0cd094445c4d97a6e54a12cce
+  data.tar.gz: 636bc3237e0a5048dc8f955d3335d23bd2c7bb45e894597bdc6c936386cb1b44599b0f5433b57b31f921d99cbacc0b748668667b63ce043f15cb0d198614cc32

data/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 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)
+
+### Features
+
+* **api:** api update ([b59db6f](https://github.com/zavudev/sdk-ruby/commit/b59db6f514301863861cc3e0e782ef39e476dbd6))
+
+## 0.12.0 (2026-05-28)
+
+Full Changelog: [v0.11.0...v0.12.0](https://github.com/zavudev/sdk-ruby/compare/v0.11.0...v0.12.0)
+
+### Features
+
+* **api:** api update ([7484922](https://github.com/zavudev/sdk-ruby/commit/7484922e1f6b8f8736e9ab45e562ea2e5a811ac9))
+* **api:** api update ([efcc794](https://github.com/zavudev/sdk-ruby/commit/efcc794e638f0415a78888412f617a10ed16bb8b))
+
 ## 0.11.0 (2026-05-25)
 
 Full Changelog: [v0.10.0...v0.11.0](https://github.com/zavudev/sdk-ruby/compare/v0.10.0...v0.11.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.11.0"
+gem "zavudev", "~> 0.13.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/zavudev/models/broadcast_contact.rb

@@ -66,12 +66,19 @@ module Zavudev
                Zavudev::Internal::Type::HashOf[String],
                api_name: :templateButtonVariables
 
+      # @!attribute template_header_variables
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :template_header_variables,
+               Zavudev::Internal::Type::HashOf[String],
+               api_name: :templateHeaderVariables
+
       # @!attribute template_variables
       #
       #   @return [Hash{Symbol=>String}, nil]
       optional :template_variables, Zavudev::Internal::Type::HashOf[String], api_name: :templateVariables
 
-      # @!method initialize(id:, created_at:, recipient:, recipient_type:, status:, cost: nil, error_code: nil, error_message: nil, message_id: nil, processed_at: nil, template_button_variables: nil, template_variables: nil)
+      # @!method initialize(id:, created_at:, recipient:, recipient_type:, status:, cost: nil, error_code: nil, error_message: nil, message_id: nil, processed_at: nil, template_button_variables: nil, template_header_variables: nil, template_variables: nil)
       #   @param id [String]
       #
       #   @param created_at [Time]
@@ -94,6 +101,8 @@ module Zavudev
       #
       #   @param template_button_variables [Hash{Symbol=>String}]
       #
+      #   @param template_header_variables [Hash{Symbol=>String}]
+      #
       #   @param template_variables [Hash{Symbol=>String}]
 
       # @see Zavudev::Models::BroadcastContact#recipient_type

data/lib/zavudev/models/broadcast_content.rb

@@ -36,6 +36,16 @@ module Zavudev
                Zavudev::Internal::Type::HashOf[String],
                api_name: :templateButtonVariables
 
+      # @!attribute template_header_variables
+      #   Default value for a text-header variable, keyed by `1` (can be overridden per
+      #   contact). If omitted, Zavu resolves the header from `templateVariables` by the
+      #   header placeholder's name.
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :template_header_variables,
+               Zavudev::Internal::Type::HashOf[String],
+               api_name: :templateHeaderVariables
+
       # @!attribute template_id
       #   Template ID for template messages.
       #
@@ -43,13 +53,15 @@ module Zavudev
       optional :template_id, String, api_name: :templateId
 
       # @!attribute template_variables
-      #   Default body variables (can be overridden per contact). Keys are positions (1,
-      #   2, ...).
+      #   Default body variables (can be overridden per contact). Key them to match the
+      #   template body: by position (`1`, `2`, ...) for positional templates, or by name
+      #   (e.g. `customer_name`) for named templates. Zavu detects the template's format
+      #   and sends the correct payload to Meta. Do not mix positional and named keys.
       #
       #   @return [Hash{Symbol=>String}, nil]
       optional :template_variables, Zavudev::Internal::Type::HashOf[String], api_name: :templateVariables
 
-      # @!method initialize(filename: nil, media_id: nil, media_url: nil, mime_type: nil, template_button_variables: nil, template_id: nil, template_variables: nil)
+      # @!method initialize(filename: nil, media_id: nil, media_url: nil, mime_type: nil, template_button_variables: nil, template_header_variables: nil, template_id: nil, template_variables: nil)
       #   Some parameter documentations has been truncated, see
       #   {Zavudev::Models::BroadcastContent} for more details.
       #
@@ -65,9 +77,11 @@ module Zavudev
       #
       #   @param template_button_variables [Hash{Symbol=>String}] Default button variables for dynamic URL/OTP buttons. Keys are the button index
       #
+      #   @param template_header_variables [Hash{Symbol=>String}] Default value for a text-header variable, keyed by `1` (can be overridden per co
+      #
       #   @param template_id [String] Template ID for template messages.
       #
-      #   @param template_variables [Hash{Symbol=>String}] Default body variables (can be overridden per contact). Keys are positions (1, 2
+      #   @param template_variables [Hash{Symbol=>String}] Default body variables (can be overridden per contact). Key them to match the te
     end
   end
 end

data/lib/zavudev/models/broadcasts/contact_add_params.rb

@@ -43,14 +43,25 @@ module Zavudev
                    Zavudev::Internal::Type::HashOf[String],
                    api_name: :templateButtonVariables
 
+          # @!attribute template_header_variables
+          #   Per-contact value for a text-header variable, keyed by `1`. If omitted, Zavu
+          #   resolves the header from `templateVariables` by the header placeholder's name.
+          #
+          #   @return [Hash{Symbol=>String}, nil]
+          optional :template_header_variables,
+                   Zavudev::Internal::Type::HashOf[String],
+                   api_name: :templateHeaderVariables
+
           # @!attribute template_variables
-          #   Per-contact body variables. Keys are positions (1, 2, ...) matching the order
-          #   placeholders appear in the template body.
+          #   Per-contact body variables. Key them to match the template body: by position
+          #   (`1`, `2`, ...) for positional templates, or by name (e.g. `customer_name`) for
+          #   named templates. Zavu detects the template's format and sends the correct
+          #   payload to Meta. Do not mix positional and named keys.
           #
           #   @return [Hash{Symbol=>String}, nil]
           optional :template_variables, Zavudev::Internal::Type::HashOf[String], api_name: :templateVariables
 
-          # @!method initialize(recipient:, template_button_variables: nil, template_variables: nil)
+          # @!method initialize(recipient:, template_button_variables: nil, template_header_variables: nil, template_variables: nil)
           #   Some parameter documentations has been truncated, see
           #   {Zavudev::Models::Broadcasts::ContactAddParams::Contact} for more details.
           #
@@ -58,7 +69,9 @@ module Zavudev
           #
           #   @param template_button_variables [Hash{Symbol=>String}] Per-contact button variables for dynamic URL/OTP buttons. Keys are the button in
           #
-          #   @param template_variables [Hash{Symbol=>String}] Per-contact body variables. Keys are positions (1, 2, ...) matching the order pl
+          #   @param template_header_variables [Hash{Symbol=>String}] Per-contact value for a text-header variable, keyed by `1`. If omitted, Zavu res
+          #
+          #   @param template_variables [Hash{Symbol=>String}] Per-contact body variables. Key them to match the template body: by position (`1
         end
       end
     end

data/lib/zavudev/models/message_content.rb

@@ -120,6 +120,41 @@ module Zavudev
       #   @return [String, nil]
       optional :react_to_message_id, String, api_name: :reactToMessageId
 
+      # @!attribute reply_to_from
+      #   Sender of the quoted message (phone number in E.164 format).
+      #
+      #   @return [String, nil]
+      optional :reply_to_from, String, api_name: :replyToFrom
+
+      # @!attribute reply_to_message_id
+      #   Zavu message ID of the quoted message this message replies to. Present on
+      #   inbound messages that quote an earlier message. Omitted when the quoted message
+      #   is not found in Zavu (e.g. an old or unknown message) — use
+      #   replyToProviderMessageId in that case.
+      #
+      #   @return [String, nil]
+      optional :reply_to_message_id, String, api_name: :replyToMessageId
+
+      # @!attribute reply_to_message_type
+      #   Type of the quoted message (text, image, video, etc.).
+      #
+      #   @return [String, nil]
+      optional :reply_to_message_type, String, api_name: :replyToMessageType
+
+      # @!attribute reply_to_provider_message_id
+      #   Provider message ID (WhatsApp WAMID) of the quoted message. Present whenever an
+      #   inbound message is a reply, even if the quoted message is not stored in Zavu.
+      #
+      #   @return [String, nil]
+      optional :reply_to_provider_message_id, String, api_name: :replyToProviderMessageId
+
+      # @!attribute reply_to_text
+      #   Truncated snippet of the quoted message's text, for display. Empty when the
+      #   quoted message has no text (e.g. media).
+      #
+      #   @return [String, nil]
+      optional :reply_to_text, String, api_name: :replyToText
+
       # @!attribute sections
       #   Sections for list messages.
       #
@@ -147,6 +182,17 @@ module Zavudev
                Zavudev::Internal::Type::HashOf[String],
                api_name: :templateButtonVariables
 
+      # @!attribute template_header_variables
+      #   Value for a text-header variable, keyed by `1` (WhatsApp text headers allow at
+      #   most one variable). Optional override. If omitted, Zavu resolves the header from
+      #   `templateVariables` using the header placeholder's name (e.g. `novios`). Static
+      #   text headers need no value.
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :template_header_variables,
+               Zavudev::Internal::Type::HashOf[String],
+               api_name: :templateHeaderVariables
+
       # @!attribute template_id
       #   Template ID for template messages.
       #
@@ -154,13 +200,16 @@ module Zavudev
       optional :template_id, String, api_name: :templateId
 
       # @!attribute template_variables
-      #   Variables for body placeholders. Keys are positions (1, 2, 3, ...) matching the
-      #   order placeholders appear in the template body.
+      #   Variables for body placeholders. Key them to match the template body: by
+      #   position (`1`, `2`, ...) for positional templates, or by name (e.g.
+      #   `customer_name`) for named templates. Zavu detects the template's format and
+      #   sends the correct payload to Meta. Named keys also resolve a named text-header
+      #   variable. Do not mix positional and named keys in the same request.
       #
       #   @return [Hash{Symbol=>String}, nil]
       optional :template_variables, Zavudev::Internal::Type::HashOf[String], api_name: :templateVariables
 
-      # @!method initialize(buttons: nil, contacts: nil, cta_display_text: nil, cta_header_media_url: nil, cta_header_text: nil, cta_header_type: nil, cta_url: nil, emoji: nil, filename: nil, footer_text: nil, latitude: nil, list_button: nil, location_address: nil, location_name: nil, longitude: nil, media_id: nil, media_url: nil, mime_type: nil, react_to_message_id: nil, sections: nil, template_button_variables: nil, template_id: nil, template_variables: nil)
+      # @!method initialize(buttons: nil, contacts: nil, cta_display_text: nil, cta_header_media_url: nil, cta_header_text: nil, cta_header_type: nil, cta_url: nil, emoji: nil, filename: nil, footer_text: nil, latitude: nil, list_button: nil, location_address: nil, location_name: nil, longitude: nil, media_id: nil, media_url: nil, mime_type: nil, react_to_message_id: nil, reply_to_from: nil, reply_to_message_id: nil, reply_to_message_type: nil, reply_to_provider_message_id: nil, reply_to_text: nil, sections: nil, template_button_variables: nil, template_header_variables: nil, template_id: nil, template_variables: nil)
       #   Some parameter documentations has been truncated, see
       #   {Zavudev::Models::MessageContent} for more details.
       #
@@ -204,13 +253,25 @@ module Zavudev
       #
       #   @param react_to_message_id [String] Message ID to react to.
       #
+      #   @param reply_to_from [String] Sender of the quoted message (phone number in E.164 format).
+      #
+      #   @param reply_to_message_id [String] Zavu message ID of the quoted message this message replies to. Present on inboun
+      #
+      #   @param reply_to_message_type [String] Type of the quoted message (text, image, video, etc.).
+      #
+      #   @param reply_to_provider_message_id [String] Provider message ID (WhatsApp WAMID) of the quoted message. Present whenever an
+      #
+      #   @param reply_to_text [String] Truncated snippet of the quoted message's text, for display. Empty when the quot
+      #
       #   @param sections [Array<Zavudev::Models::MessageContent::Section>] Sections for list messages.
       #
       #   @param template_button_variables [Hash{Symbol=>String}] Variables for dynamic button placeholders (URL buttons and OTP buttons). Keys ar
       #
+      #   @param template_header_variables [Hash{Symbol=>String}] Value for a text-header variable, keyed by `1` (WhatsApp text headers allow at m
+      #
       #   @param template_id [String] Template ID for template messages.
       #
-      #   @param template_variables [Hash{Symbol=>String}] Variables for body placeholders. Keys are positions (1, 2, 3, ...) matching the
+      #   @param template_variables [Hash{Symbol=>String}] Variables for body placeholders. Key them to match the template body: by positio
 
       class Button < Zavudev::Internal::Type::BaseModel
         # @!attribute id

data/lib/zavudev/models/template.rb

@@ -10,8 +10,11 @@ module Zavudev
       required :id, String
 
       # @!attribute body
-      #   Default template body with variables: {{1}}, {{2}}, or named variables like
-      #   {{contact.first_name}}. Used when no channel-specific body is set.
+      #   Default template body with variables: positional ({{1}}, {{2}}) or named
+      #   ({{customer_name}}, {{contact.first_name}}). Templates created in Zavu are
+      #   submitted to Meta as positional; templates imported from a WhatsApp Business
+      #   Account keep their original format (named or positional). Used when no
+      #   channel-specific body is set.
       #
       #   @return [String]
       required :body, String
@@ -123,7 +126,7 @@ module Zavudev
       #
       #   @param id [String]
       #
-      #   @param body [String] Default template body with variables: {{1}}, {{2}}, or named variables like {{co
+      #   @param body [String] Default template body with variables: positional ({{1}}, {{2}}) or named ({{cust
       #
       #   @param category [Symbol, Zavudev::Models::WhatsappCategory] WhatsApp template category.
       #

data/lib/zavudev/models/webhook_event.rb

@@ -18,7 +18,10 @@ module Zavudev
     # **Inbound events:**
     #
     # - `message.inbound`: New message received from a contact. Reactions are
-    #   delivered as `message.inbound` with `messageType='reaction'`
+    #   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`.
     # - `message.unsupported`: Received a message type that is not supported
     #
     # **Broadcast events:**

data/lib/zavudev/version.rb

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

data/rbi/zavudev/models/broadcast_contact.rbi

@@ -58,6 +58,12 @@ module Zavudev
       sig { params(template_button_variables: T::Hash[Symbol, String]).void }
       attr_writer :template_button_variables
 
+      sig { returns(T.nilable(T::Hash[Symbol, String])) }
+      attr_reader :template_header_variables
+
+      sig { params(template_header_variables: T::Hash[Symbol, String]).void }
+      attr_writer :template_header_variables
+
       sig { returns(T.nilable(T::Hash[Symbol, String])) }
       attr_reader :template_variables
 
@@ -77,6 +83,7 @@ module Zavudev
           message_id: String,
           processed_at: Time,
           template_button_variables: T::Hash[Symbol, String],
+          template_header_variables: T::Hash[Symbol, String],
           template_variables: T::Hash[Symbol, String]
         ).returns(T.attached_class)
       end
@@ -94,6 +101,7 @@ module Zavudev
         message_id: nil,
         processed_at: nil,
         template_button_variables: nil,
+        template_header_variables: nil,
         template_variables: nil
       )
       end
@@ -113,6 +121,7 @@ module Zavudev
             message_id: String,
             processed_at: Time,
             template_button_variables: T::Hash[Symbol, String],
+            template_header_variables: T::Hash[Symbol, String],
             template_variables: T::Hash[Symbol, String]
           }
         )

data/rbi/zavudev/models/broadcast_content.rbi

@@ -44,6 +44,15 @@ module Zavudev
       sig { params(template_button_variables: T::Hash[Symbol, String]).void }
       attr_writer :template_button_variables
 
+      # Default value for a text-header variable, keyed by `1` (can be overridden per
+      # contact). If omitted, Zavu resolves the header from `templateVariables` by the
+      # header placeholder's name.
+      sig { returns(T.nilable(T::Hash[Symbol, String])) }
+      attr_reader :template_header_variables
+
+      sig { params(template_header_variables: T::Hash[Symbol, String]).void }
+      attr_writer :template_header_variables
+
       # Template ID for template messages.
       sig { returns(T.nilable(String)) }
       attr_reader :template_id
@@ -51,8 +60,10 @@ module Zavudev
       sig { params(template_id: String).void }
       attr_writer :template_id
 
-      # Default body variables (can be overridden per contact). Keys are positions (1,
-      # 2, ...).
+      # Default body variables (can be overridden per contact). Key them to match the
+      # template body: by position (`1`, `2`, ...) for positional templates, or by name
+      # (e.g. `customer_name`) for named templates. Zavu detects the template's format
+      # and sends the correct payload to Meta. Do not mix positional and named keys.
       sig { returns(T.nilable(T::Hash[Symbol, String])) }
       attr_reader :template_variables
 
@@ -67,6 +78,7 @@ module Zavudev
           media_url: String,
           mime_type: String,
           template_button_variables: T::Hash[Symbol, String],
+          template_header_variables: T::Hash[Symbol, String],
           template_id: String,
           template_variables: T::Hash[Symbol, String]
         ).returns(T.attached_class)
@@ -83,10 +95,16 @@ module Zavudev
         # Default button variables for dynamic URL/OTP buttons. Keys are the button index
         # (0, 1, 2). Per-contact values override these.
         template_button_variables: nil,
+        # Default value for a text-header variable, keyed by `1` (can be overridden per
+        # contact). If omitted, Zavu resolves the header from `templateVariables` by the
+        # header placeholder's name.
+        template_header_variables: nil,
         # Template ID for template messages.
         template_id: nil,
-        # Default body variables (can be overridden per contact). Keys are positions (1,
-        # 2, ...).
+        # Default body variables (can be overridden per contact). Key them to match the
+        # template body: by position (`1`, `2`, ...) for positional templates, or by name
+        # (e.g. `customer_name`) for named templates. Zavu detects the template's format
+        # and sends the correct payload to Meta. Do not mix positional and named keys.
         template_variables: nil
       )
       end
@@ -99,6 +117,7 @@ module Zavudev
             media_url: String,
             mime_type: String,
             template_button_variables: T::Hash[Symbol, String],
+            template_header_variables: T::Hash[Symbol, String],
             template_id: String,
             template_variables: T::Hash[Symbol, String]
           }

data/rbi/zavudev/models/broadcasts/contact_add_params.rbi

@@ -76,8 +76,20 @@ module Zavudev
           end
           attr_writer :template_button_variables
 
-          # Per-contact body variables. Keys are positions (1, 2, ...) matching the order
-          # placeholders appear in the template body.
+          # Per-contact value for a text-header variable, keyed by `1`. If omitted, Zavu
+          # resolves the header from `templateVariables` by the header placeholder's name.
+          sig { returns(T.nilable(T::Hash[Symbol, String])) }
+          attr_reader :template_header_variables
+
+          sig do
+            params(template_header_variables: T::Hash[Symbol, String]).void
+          end
+          attr_writer :template_header_variables
+
+          # Per-contact body variables. Key them to match the template body: by position
+          # (`1`, `2`, ...) for positional templates, or by name (e.g. `customer_name`) for
+          # named templates. Zavu detects the template's format and sends the correct
+          # payload to Meta. Do not mix positional and named keys.
           sig { returns(T.nilable(T::Hash[Symbol, String])) }
           attr_reader :template_variables
 
@@ -88,6 +100,7 @@ module Zavudev
             params(
               recipient: String,
               template_button_variables: T::Hash[Symbol, String],
+              template_header_variables: T::Hash[Symbol, String],
               template_variables: T::Hash[Symbol, String]
             ).returns(T.attached_class)
           end
@@ -97,8 +110,13 @@ module Zavudev
             # Per-contact button variables for dynamic URL/OTP buttons. Keys are the button
             # index (0, 1, 2).
             template_button_variables: nil,
-            # Per-contact body variables. Keys are positions (1, 2, ...) matching the order
-            # placeholders appear in the template body.
+            # Per-contact value for a text-header variable, keyed by `1`. If omitted, Zavu
+            # resolves the header from `templateVariables` by the header placeholder's name.
+            template_header_variables: nil,
+            # Per-contact body variables. Key them to match the template body: by position
+            # (`1`, `2`, ...) for positional templates, or by name (e.g. `customer_name`) for
+            # named templates. Zavu detects the template's format and sends the correct
+            # payload to Meta. Do not mix positional and named keys.
             template_variables: nil
           )
           end
@@ -108,6 +126,7 @@ module Zavudev
               {
                 recipient: String,
                 template_button_variables: T::Hash[Symbol, String],
+                template_header_variables: T::Hash[Symbol, String],
                 template_variables: T::Hash[Symbol, String]
               }
             )

data/rbi/zavudev/models/message_content.rbi

@@ -156,6 +156,46 @@ module Zavudev
       sig { params(react_to_message_id: String).void }
       attr_writer :react_to_message_id
 
+      # Sender of the quoted message (phone number in E.164 format).
+      sig { returns(T.nilable(String)) }
+      attr_reader :reply_to_from
+
+      sig { params(reply_to_from: String).void }
+      attr_writer :reply_to_from
+
+      # Zavu message ID of the quoted message this message replies to. Present on
+      # inbound messages that quote an earlier message. Omitted when the quoted message
+      # is not found in Zavu (e.g. an old or unknown message) — use
+      # replyToProviderMessageId in that case.
+      sig { returns(T.nilable(String)) }
+      attr_reader :reply_to_message_id
+
+      sig { params(reply_to_message_id: String).void }
+      attr_writer :reply_to_message_id
+
+      # Type of the quoted message (text, image, video, etc.).
+      sig { returns(T.nilable(String)) }
+      attr_reader :reply_to_message_type
+
+      sig { params(reply_to_message_type: String).void }
+      attr_writer :reply_to_message_type
+
+      # Provider message ID (WhatsApp WAMID) of the quoted message. Present whenever an
+      # inbound message is a reply, even if the quoted message is not stored in Zavu.
+      sig { returns(T.nilable(String)) }
+      attr_reader :reply_to_provider_message_id
+
+      sig { params(reply_to_provider_message_id: String).void }
+      attr_writer :reply_to_provider_message_id
+
+      # Truncated snippet of the quoted message's text, for display. Empty when the
+      # quoted message has no text (e.g. media).
+      sig { returns(T.nilable(String)) }
+      attr_reader :reply_to_text
+
+      sig { params(reply_to_text: String).void }
+      attr_writer :reply_to_text
+
       # Sections for list messages.
       sig { returns(T.nilable(T::Array[Zavudev::MessageContent::Section])) }
       attr_reader :sections
@@ -187,6 +227,16 @@ module Zavudev
       sig { params(template_button_variables: T::Hash[Symbol, String]).void }
       attr_writer :template_button_variables
 
+      # Value for a text-header variable, keyed by `1` (WhatsApp text headers allow at
+      # most one variable). Optional override. If omitted, Zavu resolves the header from
+      # `templateVariables` using the header placeholder's name (e.g. `novios`). Static
+      # text headers need no value.
+      sig { returns(T.nilable(T::Hash[Symbol, String])) }
+      attr_reader :template_header_variables
+
+      sig { params(template_header_variables: T::Hash[Symbol, String]).void }
+      attr_writer :template_header_variables
+
       # Template ID for template messages.
       sig { returns(T.nilable(String)) }
       attr_reader :template_id
@@ -194,8 +244,11 @@ module Zavudev
       sig { params(template_id: String).void }
       attr_writer :template_id
 
-      # Variables for body placeholders. Keys are positions (1, 2, 3, ...) matching the
-      # order placeholders appear in the template body.
+      # Variables for body placeholders. Key them to match the template body: by
+      # position (`1`, `2`, ...) for positional templates, or by name (e.g.
+      # `customer_name`) for named templates. Zavu detects the template's format and
+      # sends the correct payload to Meta. Named keys also resolve a named text-header
+      # variable. Do not mix positional and named keys in the same request.
       sig { returns(T.nilable(T::Hash[Symbol, String])) }
       attr_reader :template_variables
 
@@ -224,8 +277,14 @@ module Zavudev
           media_url: String,
           mime_type: String,
           react_to_message_id: String,
+          reply_to_from: String,
+          reply_to_message_id: String,
+          reply_to_message_type: String,
+          reply_to_provider_message_id: String,
+          reply_to_text: String,
           sections: T::Array[Zavudev::MessageContent::Section::OrHash],
           template_button_variables: T::Hash[Symbol, String],
+          template_header_variables: T::Hash[Symbol, String],
           template_id: String,
           template_variables: T::Hash[Symbol, String]
         ).returns(T.attached_class)
@@ -272,6 +331,21 @@ module Zavudev
         mime_type: nil,
         # Message ID to react to.
         react_to_message_id: nil,
+        # Sender of the quoted message (phone number in E.164 format).
+        reply_to_from: nil,
+        # Zavu message ID of the quoted message this message replies to. Present on
+        # inbound messages that quote an earlier message. Omitted when the quoted message
+        # is not found in Zavu (e.g. an old or unknown message) — use
+        # replyToProviderMessageId in that case.
+        reply_to_message_id: nil,
+        # Type of the quoted message (text, image, video, etc.).
+        reply_to_message_type: nil,
+        # Provider message ID (WhatsApp WAMID) of the quoted message. Present whenever an
+        # inbound message is a reply, even if the quoted message is not stored in Zavu.
+        reply_to_provider_message_id: nil,
+        # Truncated snippet of the quoted message's text, for display. Empty when the
+        # quoted message has no text (e.g. media).
+        reply_to_text: nil,
         # Sections for list messages.
         sections: nil,
         # Variables for dynamic button placeholders (URL buttons and OTP buttons). Keys
@@ -289,10 +363,18 @@ module Zavudev
         # - Static URL buttons (no placeholder) and `quick_reply` buttons are not included
         #   here.
         template_button_variables: nil,
+        # Value for a text-header variable, keyed by `1` (WhatsApp text headers allow at
+        # most one variable). Optional override. If omitted, Zavu resolves the header from
+        # `templateVariables` using the header placeholder's name (e.g. `novios`). Static
+        # text headers need no value.
+        template_header_variables: nil,
         # Template ID for template messages.
         template_id: nil,
-        # Variables for body placeholders. Keys are positions (1, 2, 3, ...) matching the
-        # order placeholders appear in the template body.
+        # Variables for body placeholders. Key them to match the template body: by
+        # position (`1`, `2`, ...) for positional templates, or by name (e.g.
+        # `customer_name`) for named templates. Zavu detects the template's format and
+        # sends the correct payload to Meta. Named keys also resolve a named text-header
+        # variable. Do not mix positional and named keys in the same request.
         template_variables: nil
       )
       end
@@ -319,8 +401,14 @@ module Zavudev
             media_url: String,
             mime_type: String,
             react_to_message_id: String,
+            reply_to_from: String,
+            reply_to_message_id: String,
+            reply_to_message_type: String,
+            reply_to_provider_message_id: String,
+            reply_to_text: String,
             sections: T::Array[Zavudev::MessageContent::Section],
             template_button_variables: T::Hash[Symbol, String],
+            template_header_variables: T::Hash[Symbol, String],
             template_id: String,
             template_variables: T::Hash[Symbol, String]
           }

data/rbi/zavudev/models/template.rbi

@@ -9,8 +9,11 @@ module Zavudev
       sig { returns(String) }
       attr_accessor :id
 
-      # Default template body with variables: {{1}}, {{2}}, or named variables like
-      # {{contact.first_name}}. Used when no channel-specific body is set.
+      # Default template body with variables: positional ({{1}}, {{2}}) or named
+      # ({{customer_name}}, {{contact.first_name}}). Templates created in Zavu are
+      # submitted to Meta as positional; templates imported from a WhatsApp Business
+      # Account keep their original format (named or positional). Used when no
+      # channel-specific body is set.
       sig { returns(String) }
       attr_accessor :body
 
@@ -146,8 +149,11 @@ module Zavudev
       end
       def self.new(
         id:,
-        # Default template body with variables: {{1}}, {{2}}, or named variables like
-        # {{contact.first_name}}. Used when no channel-specific body is set.
+        # Default template body with variables: positional ({{1}}, {{2}}) or named
+        # ({{customer_name}}, {{contact.first_name}}). Templates created in Zavu are
+        # submitted to Meta as positional; templates imported from a WhatsApp Business
+        # Account keep their original format (named or positional). Used when no
+        # channel-specific body is set.
         body:,
         # WhatsApp template category.
         category:,

data/rbi/zavudev/models/webhook_event.rbi

@@ -18,7 +18,10 @@ module Zavudev
     # **Inbound events:**
     #
     # - `message.inbound`: New message received from a contact. Reactions are
-    #   delivered as `message.inbound` with `messageType='reaction'`
+    #   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`.
     # - `message.unsupported`: Received a message type that is not supported
     #
     # **Broadcast events:**

data/sig/zavudev/models/broadcast_contact.rbs

@@ -13,6 +13,7 @@ module Zavudev
         message_id: String,
         processed_at: Time,
         template_button_variables: ::Hash[Symbol, String],
+        template_header_variables: ::Hash[Symbol, String],
         template_variables: ::Hash[Symbol, String]
       }
 
@@ -51,6 +52,12 @@ module Zavudev
         ::Hash[Symbol, String]
       ) -> ::Hash[Symbol, String]
 
+      attr_reader template_header_variables: ::Hash[Symbol, String]?
+
+      def template_header_variables=: (
+        ::Hash[Symbol, String]
+      ) -> ::Hash[Symbol, String]
+
       attr_reader template_variables: ::Hash[Symbol, String]?
 
       def template_variables=: (
@@ -69,6 +76,7 @@ module Zavudev
         ?message_id: String,
         ?processed_at: Time,
         ?template_button_variables: ::Hash[Symbol, String],
+        ?template_header_variables: ::Hash[Symbol, String],
         ?template_variables: ::Hash[Symbol, String]
       ) -> void
 
@@ -84,6 +92,7 @@ module Zavudev
         message_id: String,
         processed_at: Time,
         template_button_variables: ::Hash[Symbol, String],
+        template_header_variables: ::Hash[Symbol, String],
         template_variables: ::Hash[Symbol, String]
       }
 

data/sig/zavudev/models/broadcast_content.rbs

@@ -7,6 +7,7 @@ module Zavudev
         media_url: String,
         mime_type: String,
         template_button_variables: ::Hash[Symbol, String],
+        template_header_variables: ::Hash[Symbol, String],
         template_id: String,
         template_variables: ::Hash[Symbol, String]
       }
@@ -34,6 +35,12 @@ module Zavudev
         ::Hash[Symbol, String]
       ) -> ::Hash[Symbol, String]
 
+      attr_reader template_header_variables: ::Hash[Symbol, String]?
+
+      def template_header_variables=: (
+        ::Hash[Symbol, String]
+      ) -> ::Hash[Symbol, String]
+
       attr_reader template_id: String?
 
       def template_id=: (String) -> String
@@ -50,6 +57,7 @@ module Zavudev
         ?media_url: String,
         ?mime_type: String,
         ?template_button_variables: ::Hash[Symbol, String],
+        ?template_header_variables: ::Hash[Symbol, String],
         ?template_id: String,
         ?template_variables: ::Hash[Symbol, String]
       ) -> void
@@ -60,6 +68,7 @@ module Zavudev
         media_url: String,
         mime_type: String,
         template_button_variables: ::Hash[Symbol, String],
+        template_header_variables: ::Hash[Symbol, String],
         template_id: String,
         template_variables: ::Hash[Symbol, String]
       }

data/sig/zavudev/models/broadcasts/contact_add_params.rbs

@@ -32,6 +32,7 @@ module Zavudev
           {
             recipient: String,
             template_button_variables: ::Hash[Symbol, String],
+            template_header_variables: ::Hash[Symbol, String],
             template_variables: ::Hash[Symbol, String]
           }
 
@@ -44,6 +45,12 @@ module Zavudev
             ::Hash[Symbol, String]
           ) -> ::Hash[Symbol, String]
 
+          attr_reader template_header_variables: ::Hash[Symbol, String]?
+
+          def template_header_variables=: (
+            ::Hash[Symbol, String]
+          ) -> ::Hash[Symbol, String]
+
           attr_reader template_variables: ::Hash[Symbol, String]?
 
           def template_variables=: (
@@ -53,12 +60,14 @@ module Zavudev
           def initialize: (
             recipient: String,
             ?template_button_variables: ::Hash[Symbol, String],
+            ?template_header_variables: ::Hash[Symbol, String],
             ?template_variables: ::Hash[Symbol, String]
           ) -> void
 
           def to_hash: -> {
             recipient: String,
             template_button_variables: ::Hash[Symbol, String],
+            template_header_variables: ::Hash[Symbol, String],
             template_variables: ::Hash[Symbol, String]
           }
         end

data/sig/zavudev/models/message_content.rbs

@@ -21,8 +21,14 @@ module Zavudev
         media_url: String,
         mime_type: String,
         react_to_message_id: String,
+        reply_to_from: String,
+        reply_to_message_id: String,
+        reply_to_message_type: String,
+        reply_to_provider_message_id: String,
+        reply_to_text: String,
         sections: ::Array[Zavudev::MessageContent::Section],
         template_button_variables: ::Hash[Symbol, String],
+        template_header_variables: ::Hash[Symbol, String],
         template_id: String,
         template_variables: ::Hash[Symbol, String]
       }
@@ -110,6 +116,26 @@ module Zavudev
 
       def react_to_message_id=: (String) -> String
 
+      attr_reader reply_to_from: String?
+
+      def reply_to_from=: (String) -> String
+
+      attr_reader reply_to_message_id: String?
+
+      def reply_to_message_id=: (String) -> String
+
+      attr_reader reply_to_message_type: String?
+
+      def reply_to_message_type=: (String) -> String
+
+      attr_reader reply_to_provider_message_id: String?
+
+      def reply_to_provider_message_id=: (String) -> String
+
+      attr_reader reply_to_text: String?
+
+      def reply_to_text=: (String) -> String
+
       attr_reader sections: ::Array[Zavudev::MessageContent::Section]?
 
       def sections=: (
@@ -122,6 +148,12 @@ module Zavudev
         ::Hash[Symbol, String]
       ) -> ::Hash[Symbol, String]
 
+      attr_reader template_header_variables: ::Hash[Symbol, String]?
+
+      def template_header_variables=: (
+        ::Hash[Symbol, String]
+      ) -> ::Hash[Symbol, String]
+
       attr_reader template_id: String?
 
       def template_id=: (String) -> String
@@ -152,8 +184,14 @@ module Zavudev
         ?media_url: String,
         ?mime_type: String,
         ?react_to_message_id: String,
+        ?reply_to_from: String,
+        ?reply_to_message_id: String,
+        ?reply_to_message_type: String,
+        ?reply_to_provider_message_id: String,
+        ?reply_to_text: String,
         ?sections: ::Array[Zavudev::MessageContent::Section],
         ?template_button_variables: ::Hash[Symbol, String],
+        ?template_header_variables: ::Hash[Symbol, String],
         ?template_id: String,
         ?template_variables: ::Hash[Symbol, String]
       ) -> void
@@ -178,8 +216,14 @@ module Zavudev
         media_url: String,
         mime_type: String,
         react_to_message_id: String,
+        reply_to_from: String,
+        reply_to_message_id: String,
+        reply_to_message_type: String,
+        reply_to_provider_message_id: String,
+        reply_to_text: String,
         sections: ::Array[Zavudev::MessageContent::Section],
         template_button_variables: ::Hash[Symbol, String],
+        template_header_variables: ::Hash[Symbol, String],
         template_id: String,
         template_variables: ::Hash[Symbol, String]
       }

metadata

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