whatsapp_sdk 1.0.4 → 1.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c79999d78bf13c93ea72eed223f7206e73578e8e5b55e414697f6245d5f99896
-  data.tar.gz: e0616cb9cc093b931832bdf0e1b0207a2f349a31b7d7e4ad10225d3255638547
+  metadata.gz: 17de6b59f97c39b0d49c911d4e153d241f60d7f92727a10ec895ff4dc4d9822b
+  data.tar.gz: f2f25357ffa9d35972e157f57abfaa4a3ac2b2a9debb0f86fdb15230581c6ce6
 SHA512:
-  metadata.gz: e19b232af56af50e3ed013240af0db6bce6774d8c0fa56ba0d5792d773aa637de67e42077ed994d85c5011bd59fdac970ae6ec68e9c9cdbf82b8815301f9ce59
-  data.tar.gz: 57f65a303fd92a6bd4262a89bc428994b4789563bf8eb9e1abb39e3a9743d06aa4f5a9d7823ad0fdc108e80ea297717c3515bc5338d5eaeb57b214524ba344ee
+  metadata.gz: 1ef8af8f454441f188633dab7295b20da476d8692af1bf6602032b7504c08d1931bc9fbb9544452f981b3b58111ed0bec034de6138540c3445d6379a50f813ac
+  data.tar.gz: ead1a38b14a8d5d16539e61ba4b65c36c6652525ca10d7aab554dd3b83a8cd1b11fff52dc38e0c121f574db108ce3ea64546bf62a386b46078dfc369dd559710

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Unreleased
 
+# v 1.0.5
+- Added GET template endpoint. @osvaldo-santos [185](https://github.com/ignacio-chiazzo/ruby_whatsapp_sdk/pull/185)
+- Adding support for named paremeters in Templates API. @osvaldo-santos [184](https://github.com/ignacio-chiazzo/ruby_whatsapp_sdk/pull/184)
+- Fixed bug for empty templates. @osvaldo-santos [183](https://github.com/ignacio-chiazzo/ruby_whatsapp_sdk/pull/183)
+
 # v 1.0.4
 - Support for version 23 and 24 API. [180](https://github.com/ignacio-chiazzo/ruby_whatsapp_sdk/pull/180)
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    whatsapp_sdk (1.0.4)
+    whatsapp_sdk (1.0.5)
       faraday (~> 2.0, > 2.0.1)
       faraday-multipart (~> 1)
       zeitwerk (~> 2)

data/README.md

@@ -196,6 +196,9 @@ client.templates.list(business_id: BUSINESS_ID)
 # The message template namespace is required to send messages using the message templates.
 client.templates.get_message_template_namespace(business_id: BUSINESS_ID)
 
+# Get template by id
+template = client.templates.get(template_id: id)
+
 # Create a template
 client.templates.create(
   business_id: BUSINESS_ID, name: "seasonal_promotion", language: "en_US", category: "MARKETING",

data/example.rb

@@ -14,6 +14,7 @@ gemfile(true) do
   gem "whatsapp_sdk", path: "../"
   gem "pry"
   gem "pry-nav"
+  gem "debug"
 end
 
 require 'whatsapp_sdk'
@@ -56,12 +57,8 @@ end
 
 client = WhatsappSdk::Api::Client.new
 
-
-
-
 # ############################## Templates API ##############################
 puts "\n\n ------------------ Testing Templates API ------------------------"
-
 # ## Get list of templates
 templates = client.templates.list(business_id: BUSINESS_ID)
 puts "GET Templates list : #{ templates.records.map(&:name) }"
@@ -70,6 +67,13 @@ puts "GET Templates list : #{ templates.records.map(&:name) }"
 template_namespace = client.templates.get_message_template_namespace(business_id: BUSINESS_ID)
 puts "GET template by namespace: #{template_namespace.id}"
 
+## GET
+id = templates.records.first.id
+if id
+  template = client.templates.get(template_id: id)
+  puts "GET template by id: #{template.id}"
+end
+
 # Create a template
 components_json = [
   {

data/lib/whatsapp_sdk/api/templates.rb

@@ -18,6 +18,18 @@ module WhatsappSdk
         end
       end
 
+      # Get a template
+      # @param template_id [String] Required. The template ID.
+      # @return [Template] Template object.
+      def get(template_id:)
+        response = send_request(
+          endpoint: template_id,
+          http_method: "get"
+        )
+
+        Resource::Template.from_hash(response)
+      end
+
       # Create a template
       #
       # @param business_id [Integer] Business Id.
@@ -28,11 +40,13 @@ module WhatsappSdk
       # @param components_json [Component] Components that make up the template. See the list of possible components:
       #   https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates/components
       # @param allow_category_change [Boolean] Optional Allow category change.
+      # @param parameter_format [String] Optional Parameter format. Possible values: named, positional.
       # Set to true to allow us to assign a category based on the template guidelines and the template's contents.
       #   This can prevent your template from being rejected for miscategorization.
       # @return [Template] Template object.
       def create(
-        business_id:, name:, category:, language:, components_json: nil, allow_category_change: nil
+        business_id:, name:, category:, language:, components_json: nil, allow_category_change: nil,
+        parameter_format: nil
       )
         unless WhatsappSdk::Resource::Template::Category.valid?(category)
           raise InvalidCategoryError.new(category: category)
@@ -42,6 +56,10 @@ module WhatsappSdk
           raise WhatsappSdk::Resource::Errors::InvalidLanguageError.new(language: language)
         end
 
+        if parameter_format && !WhatsappSdk::Resource::ParameterObject::Format.valid?(parameter_format)
+          raise WhatsappSdk::Resource::Errors::InvalidParameterFormatError.new(format: parameter_format)
+        end
+
         params = {
           name: name,
           category: category,
@@ -49,6 +67,7 @@ module WhatsappSdk
           components: components_json
         }
         params["allow_category_change"] = allow_category_change if allow_category_change
+        params["parameter_format"] = parameter_format if parameter_format
 
         response = send_request(
           endpoint: "#{business_id}/message_templates",
@@ -77,8 +96,8 @@ module WhatsappSdk
 
         Api::Responses::PaginationRecords.new(
           records: parse_templates(response['data']),
-          before: response['paging']['cursors']['before'],
-          after: response['paging']['cursors']['after']
+          before: response.dig('paging', 'cursors', 'before'),
+          after: response.dig('paging', 'cursors', 'after')
         )
       end
 

data/lib/whatsapp_sdk/resource/errors.rb

@@ -49,6 +49,16 @@ module WhatsappSdk
       class InvalidInteractiveActionSectionRow < Error; end
 
       class InvalidInteractiveFooter < Error; end
+
+      class InvalidParameterFormatError < StandardError
+        attr_reader :format
+
+        def initialize(format:)
+          @format = format
+
+          super("Invalid Parameter Format. The possible values are: named and positional.")
+        end
+      end
     end
   end
 end

data/lib/whatsapp_sdk/resource/parameter_object.rb

@@ -42,6 +42,19 @@ module WhatsappSdk
         end
       end
 
+      module Format
+        NAMED = "named"
+        POSITIONAL = "positional"
+
+        FORMATS = [
+          NAMED,
+          POSITIONAL
+        ].freeze
+
+        def self.valid?(format)
+          FORMATS.include?(format)
+        end
+      end
       # Returns Text string if the parameter object type is text.
       # For the header component, the character limit is 60 characters.
       # For the body component, the character limit is 1024 characters.

data/lib/whatsapp_sdk/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module WhatsappSdk
-  VERSION = "1.0.4"
+  VERSION = "1.0.5"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: whatsapp_sdk
 version: !ruby/object:Gem::Version
-  version: 1.0.4
+  version: 1.0.5
 platform: ruby
 authors:
 - ignacio-chiazzo
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-12-26 00:00:00.000000000 Z
+date: 2026-01-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler