ruby-whatsapp 0.6.1 → 0.6.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 65b698016d0bde6643f240f8e78fc598c3ad7bd2f69a0ec6e001d02f2601e565
-  data.tar.gz: 99d27c447f3b17c55bfc4f4f916d1a22a4fcd5572e2bc5d96ef4f7a737463ae1
+  metadata.gz: 5c33c221aee102d5b25468617f808a4f91c2e54a5659922576cd542dff802458
+  data.tar.gz: 10d24cb87f52e82ba182b4360bd25c6e2ae1fe9b8bb78d4d6141c17b2dc6c91f
 SHA512:
-  metadata.gz: 57d5e745fa4255d5bb6125111ad18059b9325c6121eaa1b41482fc9b318e230e2d801cde7e760a4c7fe37922aa8c72fd0a38143f2b7daed91921fdeef98a8707
-  data.tar.gz: df83a3dd120820a8b3ca71986ed5d41bd66487805a1e0fcf5be4ca478be7c0d2aac97ce2b0726e58c438988629de41e213dff093b1db5e3e099c78b73b5ab9d9
+  metadata.gz: bd104f12c9ec44b4b07e5912f18e98ae4646a4eb1f51869b27dcc978b76ee06d385e81a6d41ce449b96460f08e0d2ddfb56b4d57ce410d3493f45e243f71883c
+  data.tar.gz: 79366a3af17543676a403b43b23e2df31b5c4219f2b440a2a438053ee8fa651f6513651e85b237693f30749afe085879d948c828a6090337c5e14508398ba7a3

data/CHANGELOG.md

@@ -1,4 +1,19 @@
-## [0.6.1]
+## [0.6.2] - 2026-10-22
+
+### Fixed
+
+- **A single-section list message no longer needs a section title.** Meta requires
+  `sections[].title` only when a list has more than one section, but
+  `Interactive::ListButtons::Section` demanded one always — `title:` was a required
+  keyword with a presence validation — so a valid single-section list without a title
+  could not be built. `Section` now takes `title:` as optional (still max 24 characters)
+  and omits the key from the payload when it is absent, and `ListButtons` enforces Meta's
+  actual rule: with two or more sections, every one must have a title, otherwise it fails
+  with "Sections must each have a title when there is more than one section". A blank
+  title (`""` or whitespace) is treated as absent — omitted from a single section, and
+  counted as missing when there are several — rather than sent as an empty heading.
+
+## [0.6.1] - 2026-10-21
 
 ### Added
 

data/docs/messages/interactive.md

@@ -116,7 +116,7 @@ Whatsapp::Messages.send_interactive!(
 | --- | --- |
 | `button` | Required, max **20** characters — the label that opens the list |
 | `sections` | **1–10** sections |
-| `sections[].title` | Required, max **24** characters |
+| `sections[].title` | Required only when there is **more than one** section, max **24** characters. A blank title counts as absent and is omitted |
 | `sections[].rows` | **1–10** rows |
 | `rows[].id` | Required, max **200** characters |
 | `rows[].title` | Required, max **24** characters |
@@ -136,6 +136,25 @@ Whatsapp::Messages::Interactive.new(
 #                                      description: "Strong & short" }] }] } } }
 ```
 
+A list with a single section can leave its title out, and the `title` key is then
+omitted from the payload. Once there are two or more sections, each one needs a title:
+
+```ruby
+Whatsapp::Messages::Interactive.new(
+  to: "+15551234567", type: :list_buttons, body: "Pick a time slot",
+  action: { button: "Slots", sections: [
+    { rows: [{ id: "9am", title: "09:00" }, { id: "2pm", title: "14:00" }] },
+  ] }
+).serialize
+# => { ..., interactive: { type: "list", body: { text: "Pick a time slot" },
+#      action: { button: "Slots",
+#                sections: [{ rows: [{ id: "9am", title: "09:00" },
+#                                    { id: "2pm", title: "14:00" }] }] } } }
+
+# Two sections, one untitled:
+# => ActiveModel::ValidationError: Sections must each have a title when there is more than one section
+```
+
 A tap arrives back as a webhook `Message::Interactive` with
 `interactive_type == "list_reply"`.
 

data/lib/ruby/whatsapp/messages/interactive/list_buttons/section.rb

@@ -14,21 +14,26 @@ module Whatsapp
           end
 
           # @!attribute [rw] title
-          #   @return [String]
+          #   @return [String, nil]
           attr_accessor :title
 
           # @!attribute [rw] rows
           #   @return [Array<Hash>]
           attr_accessor :rows
 
-          validates :title, presence: true, length: { maximum: Defaults::MAX_TITLE_LENGTH }
+          # Optional here: Meta requires a title only when the list has more than one
+          # section, which a lone Section cannot see — {ListButtons} enforces that rule.
+          validates :title, length: { maximum: Defaults::MAX_TITLE_LENGTH }, allow_nil: true
           validates :rows, presence: true, length: { minimum: Defaults::MIN_ROWS_LENGTH, maximum: Defaults::MAX_ROWS_LENGTH }
 
-          # @param title [String] The title of the section.
+          # A blank title (`""` or whitespace) is treated as absent, so it is omitted from
+          # the payload rather than sent as an empty heading.
           # @param rows [Array<Hash>] The rows in the section.
+          # @param title [String, nil] The title of the section. Required only when the list
+          #   has more than one section (enforced by {ListButtons}).
           #  @raise [ActiveModel::ValidationError] if validation fails.
-          def initialize(title:, rows:)
-            @title = title
+          def initialize(rows:, title: nil)
+            @title = title.presence
             @rows = rows
 
             validate!
@@ -47,7 +52,7 @@ module Whatsapp
             {
               title:,
               rows: serialized_rows,
-            }
+            }.compact
           end
 
         private

data/lib/ruby/whatsapp/messages/interactive/list_buttons.rb

@@ -23,6 +23,7 @@ module Whatsapp
         validates :button, presence: true, length: { maximum: Defaults::MAX_BUTTON_LENGTH }
         validates :sections, presence: true, length: { minimum: Defaults::MIN_SECTIONS_COUNT,
                                                        maximum: Defaults::MAX_SECTIONS_COUNT, }
+        validate :validate_section_titles
 
         # @param button [String] The text for the list button.
         # @param sections [Array<Hash>] The sections of the list button.
@@ -52,6 +53,17 @@ module Whatsapp
 
       private
 
+        # Meta requires `sections[].title` only once a list has more than one section, so
+        # {Section} leaves it optional and the rule lives here, where the count is known.
+        # A blank title counts as missing, matching {Section}, which omits it.
+        # @return [void]
+        def validate_section_titles
+          return if sections.blank? || sections.size <= 1
+          return if sections.all? { |section| section[:title].present? }
+
+          errors.add(:sections, "must each have a title when there is more than one section")
+        end
+
         # @return [Array<Hash>] Serialized sections.
         #   @raise [ActiveModel::ValidationError] if validation fails.
         def serialized_sections

data/lib/ruby/whatsapp/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Whatsapp
-  VERSION = "0.6.1"
+  VERSION = "0.6.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby-whatsapp
 version: !ruby/object:Gem::Version
-  version: 0.6.1
+  version: 0.6.2
 platform: ruby
 authors:
 - Raniery