whatsapp_sdk 1.0.3 → 1.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 68fa7bcce031d800ba3b8c541992921e602fd9266172fda8c2b9db9a0d400efc
-  data.tar.gz: e7922f22f38e79a5e2cca6377c86d0bc5a1a2a26beb859b2311b21f6a9be33e7
+  metadata.gz: 17de6b59f97c39b0d49c911d4e153d241f60d7f92727a10ec895ff4dc4d9822b
+  data.tar.gz: f2f25357ffa9d35972e157f57abfaa4a3ac2b2a9debb0f86fdb15230581c6ce6
 SHA512:
-  metadata.gz: f4ae0d0f4f0fff5d85d22255ed36eb063f7b4a3eac744f4d31dca4fc5c86605116bf34043932e17a4b10e8dba9433cf1a7c2aaca54a0becd5bf13ae8ce00a167
-  data.tar.gz: d0a8e8ef860b48363804833bb518dafc5eb417e09f53d1ffd5cfd797368d9611d040fcdbec55977d886bea265924916c35c65e54c07ba1a41773cb1c2060fa9d
+  metadata.gz: 1ef8af8f454441f188633dab7295b20da476d8692af1bf6602032b7504c08d1931bc9fbb9544452f981b3b58111ed0bec034de6138540c3445d6379a50f813ac
+  data.tar.gz: ead1a38b14a8d5d16539e61ba4b65c36c6652525ca10d7aab554dd3b83a8cd1b11fff52dc38e0c121f574db108ce3ea64546bf62a386b46078dfc369dd559710

data/.rubocop.yml

@@ -8,7 +8,6 @@ AllCops:
     - 'example.rb'
     - 'tmp/*'
     - 'vendor/**/*'
-  TargetRubyVersion: 3.1
 
 Style/HashSyntax:
   Enabled: false

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # 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)
+
 # v 1.0.3
 -  Fix configuration bug setting `api_version` on Configure. @frenesim [#168](https://github.com/ignacio-chiazzo/ruby_whatsapp_sdk/pull/168)
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    whatsapp_sdk (1.0.3)
+    whatsapp_sdk (1.0.5)
       faraday (~> 2.0, > 2.0.1)
       faraday-multipart (~> 1)
       zeitwerk (~> 2)
@@ -16,23 +16,23 @@ GEM
     coderay (1.1.3)
     crack (0.4.5)
       rexml
-    faraday (2.12.0)
-      faraday-net_http (>= 2.0, < 3.4)
+    faraday (2.14.0)
+      faraday-net_http (>= 2.0, < 3.5)
       json
       logger
-    faraday-multipart (1.0.4)
-      multipart-post (~> 2)
-    faraday-net_http (3.3.0)
-      net-http
+    faraday-multipart (1.2.0)
+      multipart-post (~> 2.0)
+    faraday-net_http (3.4.2)
+      net-http (~> 0.5)
     hashdiff (1.0.1)
-    json (2.7.2)
-    logger (1.6.1)
+    json (2.18.0)
+    logger (1.7.0)
     method_source (1.0.0)
     minitest (5.16.1)
     mocha (1.14.0)
     multipart-post (2.4.1)
-    net-http (0.4.1)
-      uri
+    net-http (0.9.1)
+      uri (>= 0.11.1)
     parallel (1.22.1)
     parser (3.1.2.0)
       ast (~> 2.4.1)
@@ -45,7 +45,7 @@ GEM
     rainbow (3.1.1)
     rake (12.3.3)
     regexp_parser (2.5.0)
-    rexml (3.3.9)
+    rexml (3.4.2)
     rubocop (1.30.1)
       parallel (~> 1.10)
       parser (>= 3.1.0.0)
@@ -64,18 +64,20 @@ GEM
       rubocop-ast (>= 0.4.0)
     ruby-progressbar (1.11.0)
     unicode-display_width (2.2.0)
-    uri (0.13.1)
+    uri (1.1.1)
     vcr (6.3.1)
       base64
     webmock (3.18.1)
       addressable (>= 2.8.0)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)
-    zeitwerk (2.6.18)
+    zeitwerk (2.7.4)
 
 PLATFORMS
   arm64-darwin-21
   arm64-darwin-22
+  arm64-darwin-23
+  arm64-darwin-24
   x86_64-darwin-19
   x86_64-darwin-21
   x86_64-linux

data/README.md

@@ -7,6 +7,39 @@
 The SDK provides a set of operations and classes to use the Whatsapp API.
 Send stickers, messages, audio, videos, locations, react and reply to messages or just ask for the phone numbers through this library in a few steps!
 
+## Table of Contents
+
+- [Features](#features)
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [Set up a Meta app](#set-up-a-meta-app)
+- [Usage Overview](#usage-overview)
+- [APIs](#apis)
+  - [Templates](#templates)
+  - [Business Profile API](#business-profile-api)
+  - [Phone numbers API](#phone-numbers-api)
+  - [Media API](#media-api)
+  - [Messages API](#messages-api)
+- [Errors](#errors)
+- [Examples](#examples)
+- [Whatsapp Cloud API](#whatsapp-cloud-api)
+- [Troubleshooting](#troubleshooting)
+- [Development](#development)
+- [Contributing](#contributing)
+- [Changelog](#changelog)
+- [License](#license)
+
+## Features
+
+- **Send Messages**: Text, images, audio, video, documents, stickers, locations, and contacts.
+- **React & Reply**: React to messages with emojis and reply to specific messages.
+- **Message Templates**: Send pre-approved message templates for notifications.
+- **Interactive Messages**: List messages and reply buttons.
+- **Media Management**: Upload, download, and delete media files.
+- **Phone Numbers**: Register, deregister, and query phone numbers.
+- **Business Profile**: Get and update business profile details.
+- **Templates Management**: Create, list, and delete message templates.
+
 ## Demo
 
 https://user-images.githubusercontent.com/11672878/173238826-6fc0a6f8-d0ee-4eae-8947-7dfd3b8b3446.mov
@@ -56,11 +89,10 @@ Available API version can be found [here](https://developers.facebook.com/docs/g
 #### Option 2) Create a `Client` instance :
 
 ```ruby
-
-# without
+# Basic usage
 client = WhatsappSdk::Api::Client.new("<ACCESS TOKEN>") # replace this with a valid access token
 
-# OR optionally use a logger, api_version and
+# With optional logger and API version
 logger = Logger.new(STDOUT)
 logger_options = { bodies: true }
 client = WhatsappSdk::Api::Client.new("<ACCESS TOKEN>", "<API VERSION>", logger, logger_options)
@@ -86,8 +118,6 @@ Try sending a message to your phone in the UI.
 <img width="1010" alt="Screen Shot 2022-09-05 at 11 13 24 AM" src="https://user-images.githubusercontent.com/11672878/188480634-369f8de1-b851-4735-86de-f49e96f78d8c.png">
 </details>
 
-</details>
-
 <details><summary>5) Use the GEM to interact with Whatsapp</summary>
 
 Example:
@@ -131,20 +161,20 @@ Check the [example.rb file](https://github.com/ignacio-chiazzo/ruby_whatsapp_sdk
 
 </details>
 
-## Sneak Peek
+## Usage Overview
 
 ```ruby
 client = WhatsappSdk::Api::Client.new("<ACCESS TOKEN>") # replace this with a valid access token
 
-client.phone_numbers.register_number(SENDER_ID, 123456) # register the phone number to uplaod media and send message from.
+client.phone_numbers.register_number(SENDER_ID, 123456) # register the phone number to upload media and send messages from.
 
 # send a text and a location
-client.messages.send_text(sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER,message: "Hey there! it's Whatsapp Ruby SDK")
+client.messages.send_text(sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, message: "Hey there! it's Whatsapp Ruby SDK")
 
 client.messages.send_location(sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, longitude: -75.6898604, latitude: 45.4192206, name: "Ignacio", address: "My house")
 
 # upload a photo and send it
-image = client.media.upload(sender_id: SENDER_ID, file_path: "test/fixtures/assets/whatsapp.png", type: "image/png")image = client.media.get(media_id: uploaded_media.id)
+image = client.media.upload(sender_id: SENDER_ID, file_path: "test/fixtures/assets/whatsapp.png", type: "image/png")
 client.messages.send_image(sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, image_id: image.id)
 
 # upload a sticker and send it
@@ -166,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",
@@ -183,7 +216,7 @@ client.templates.delete(business_id: BUSINESS_ID, name: "my_name") # delete by n
 
 ```ruby
 # Get the details of your business
-client.business_profiles.get(phone_number_id)
+client.business_profiles.get(SENDER_ID)
 
 # Update the details of your business
 client.business_profiles.update(phone_number_id: SENDER_ID, params: { about: "A very cool business" } )
@@ -196,16 +229,16 @@ client.business_profiles.update(phone_number_id: SENDER_ID, params: { about: "A
 
 ```ruby
 # Get the list of phone numbers registered
-client.phone_numbers.list(business_id)
+client.phone_numbers.list(BUSINESS_ID)
 
-# Get the a phone number by id
-client.phone_numbers.get(phone_number_id)
+# Get a phone number by id
+client.phone_numbers.get(SENDER_ID)
 
 # Register a phone number
-client.phone_numbers.register_number(phone_number_id, pin)
+client.phone_numbers.register_number(SENDER_ID, pin)
 
 # Deregister a phone number
-client.phone_numbers.deregister_number(phone_number_id)
+client.phone_numbers.deregister_number(SENDER_ID)
 ```
 
 </details>
@@ -235,68 +268,68 @@ client.media.delete(media_id: MEDIA_ID)
 
 ```ruby
 # Send a text message
-client.messages.send_text(sender_id: 1234, recipient_number: 112345678, message: "hola")
+client.messages.send_text(sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, message: "hola")
 
 # Read a message
-client.messages.read_message(sender_id: 1234, message_id: "wamid.HBgLMTM0M12345678910=")
+client.messages.read_message(sender_id: SENDER_ID, message_id: "wamid.HBgLMTM0M12345678910=")
 
 # Note: To get the `message_id` you can set up [Webhooks](https://developers.facebook.com/docs/whatsapp/cloud-api/webhooks/components) that will listen and fire an event when a message is received.
 
 # Send a reaction to message
 #   To send a reaction to a message, you need to obtain the message id and look for the emoji's unicode you want to use.
-client.messages.send_reaction(sender_id: 123_123, recipient_number: 56_789, message_id: "12345", emoji: "\u{1f550}")
-client.messages.send_reaction(sender_id: 123_123, recipient_number: 56_789, message_id: "12345", emoji: "⛄️")
+client.messages.send_reaction(sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, message_id: "12345", emoji: "\u{1f550}")
+client.messages.send_reaction(sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, message_id: "12345", emoji: "⛄️")
 
 # Reply to a message
 # To reply to a message, just include the id of the message in the `client.messages` methods. For example, to reply to a text message include the following:
-client.messages.send_text(sender_id: 123_123, recipient_number: 56_789, message: "I'm a reply", message_id: "wamid.1234")
+client.messages.send_text(sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, message: "I'm a reply", message_id: "wamid.1234")
 
 # Send a location message
 client.messages.send_location(
-  sender_id: 123123, recipient_number: 56789,
+  sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER,
   longitude: 45.4215, latitude: 75.6972, name: "nacho", address: "141 cooper street"
 )
 
 # Send an image message
 #  It uses a link or an image_id.
 #  with a link
-client.messages.send_image(sender_id: 123123, recipient_number: 56789, link: "image_link", caption: "Ignacio Chiazzo Profile")
+client.messages.send_image(sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, link: "image_link", caption: "Ignacio Chiazzo Profile")
 
 # with an image id
-client.messages.send_image(sender_id: 123123, recipient_number: 56789, image_id: "1234", caption: "Ignacio Chiazzo Profile")
+client.messages.send_image(sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, image_id: "1234", caption: "Ignacio Chiazzo Profile")
 
 
 # Send an audio message
 # It uses a link or an audio_id.
 # with a link
-client.messages.send_audio(sender_id: 123123, recipient_number: 56789, link: "audio_link")
+client.messages.send_audio(sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, link: "audio_link")
 
 # with an audio id
-client.messages.send_audio(sender_id: 123123, recipient_number: 56789, audio_id: "1234")
+client.messages.send_audio(sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, audio_id: "1234")
 
 # Send a document message
 # It uses a link or a document_id.
 # with a link
-client.messages.send_document(sender_id: 123123, recipient_number: 56789, link: "document_link", caption: "Ignacio Chiazzo")
+client.messages.send_document(sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, link: "document_link", caption: "Ignacio Chiazzo")
 
 # with a document id
-client.messages.send_document(sender_id: 123123, recipient_number: 56789, document_id: "1234", caption: "Ignacio Chiazzo")
-# Note, you can specify the filename via argument [`filename`](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/messages). 
+client.messages.send_document(sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, document_id: "1234", caption: "Ignacio Chiazzo")
+# Note, you can specify the filename via argument [`filename`](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/messages).
 
 # Send a sticker message
 #  It could use a link or a sticker_id.
 #  with a link
-client.messages.send_sticker(sender_id: 123123, recipient_number: 56789, link: "link")
+client.messages.send_sticker(sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, link: "link")
 
 # with a sticker_id
-client.messages.send_sticker(sender_id: 123123, recipient_number: 56789, sticker_id: "1234")
+client.messages.send_sticker(sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, sticker_id: "1234")
 
 # Send contacts message
 # To send a contact, you need to create a Contact instance object that contain objects embedded like `addresses`, `birthday`, `emails`, `name`, `org`. See this [guide](/test/contact_helper.rb) to learn how to create contacts objects.
-client.messages.send_contacts(sender_id: 123123, recipient_number: 56789, contacts: [create_contact(params)])
+client.messages.send_contacts(sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, contacts: [create_contact(params)])
 
 # Alternatively, you could pass a plain json like this:
-client.messages.send_contacts(sender_id: 123123, recipient_number: 56789, contacts_json: {...})
+client.messages.send_contacts(sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, contacts_json: {...})
 
 # Send a template message
 # WhatsApp message templates are specific message formats that businesses use to send out notifications or customer care messages to people that have opted in to notifications. Messages can include appointment reminders, shipping information, issue resolution or payment updates.
@@ -323,7 +356,7 @@ parameter_location = WhatsappSdk::Resource::ParameterObject.new(type: "location"
 header_component = WhatsappSdk::Resource::Component.new(type: "header", parameters: [parameter_image])
 
 body_component = WhatsappSdk::Resource::Component.new(
-  type: "body", 
+  type: "body",
   parameters: [parameter_text, parameter_currency, parameter_date_time]
 )
 
@@ -347,7 +380,7 @@ button_component2 = WhatsappSdk::Resource::Component.new(
 
 location_component = WhatsappSdk::Resource::Component.new(type: "header", parameters: [parameter_location])
 client.messages.send_template(
-  sender_id: 12_345, recipient_number: 12345678, name: "hello_world", language: "en_US", components: [...]
+  sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, name: "hello_world", language: "en_US", components: [...]
 )
 ```
 
@@ -356,7 +389,7 @@ client.messages.send_template(
 Alternatively, you could pass a plain json like this:
 
 ```ruby
-client.messages.send_template(sender_id: 12_345, recipient_number: 12345678, name: "hello_world", language: "en_US", components_json: [{...}])
+client.messages.send_template(sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, name: "hello_world", language: "en_US", components_json: [{...}])
 ```
 
 **Send interactive messages**
@@ -402,7 +435,7 @@ Alternatively, you could pass a plain json like this:
 
 ```ruby
 client.messages.send_interactive_list_messages(
-  sender_id: 12_345, recipient_number: 1234567890
+  sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER
   interactive_json: {...}
 )
 ```
@@ -437,27 +470,27 @@ interactive_reply_buttons = WhatsappSdk::Resource::Interactive.new(
 )
 
 client.messages.send_interactive_reply_buttons(
-  sender_id: 12_345, recipient_number: 1234567890,
+  sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER,
   interactive: interactive_reply_buttons
 )
 ```
 
 </details>
 
-Alternative, you could pass a plain json like this:
+Alternatively, you could pass a plain json like this:
 
 ```ruby
 client.messages.send_interactive_reply_buttons(
-  sender_id: 12_345, recipient_number: 1234567890
+  sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER
   interactive_json: {...}
 )
 ```
 
 </details>
 
-### Errors
+## Errors
 
-If the API returns an error then an exception `WhatsappSdk::Api::Responses::HttpResponseError` is raised. The  object contains information returned by the Cloud API. For more information about the potential error check the [official documentation](https://developers.facebook.com/docs/whatsapp/cloud-api/support/error-codes/).
+If the API returns an error then an exception `WhatsappSdk::Api::Responses::HttpResponseError` is raised. The object contains information returned by the Cloud API. For more information about the potential error check the [official documentation](https://developers.facebook.com/docs/whatsapp/cloud-api/support/error-codes/).
 
 ## Examples
 
@@ -473,7 +506,7 @@ Visit [the example file](/example.rb) with examples to call the API in a single
 If you try to send a text message directly without a message template created and approved in your Meta control panel, you can't start a chat with other people. But if you receive a message before, it's possible to send a message.
 
 If the API response is still `success`, but the message is not delivered:
-  - ensure the device you're sending the message to is using a supported Whatsapp version. [Check documentation](https://developers.facebook.com/docs/whatsapp/cloud-api/support/troubleshooting#message-not-delivered). Try also replying a message to the number you are registered on your Whatsapp.
+- Ensure the device you're sending the message to is using a supported Whatsapp version. [Check documentation](https://developers.facebook.com/docs/whatsapp/cloud-api/support/troubleshooting#message-not-delivered). Try also replying a message to the number you are registered on your Whatsapp.
 - Ensure your Meta App uses an API version greater than or equal to `v.14`.
 - Ensure that the Panel in the Facebook dashboard doesn't display any errors.
 
@@ -483,15 +516,14 @@ Note: Sometimes the messages are delayed; see [Meta documentation](https://devel
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests.
 
-Run ' bundle exec rake install' to install this gem onto your local machine. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+Run `bundle exec rake install` to install this gem onto your local machine. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
 ### Run all the tests
 
 - **Unit tests:** Run `rake test`
-- **Sorbet Typecheck:** run `srb tc`
 - **Linters:** `bundle exec rubocop`
 
-To update the Cloud API version update the version in `lib/whatsapp_sdk/api/api_configuration.rb`. Check the [Cloud API changelog for API udpates](https://developers.facebook.com/docs/whatsapp/business-platform/changelog#api-error-response-behavior).
+To update the Cloud API version update the version in `lib/whatsapp_sdk/api/api_configuration.rb`. Check the [Cloud API changelog for API updates](https://developers.facebook.com/docs/whatsapp/business-platform/changelog#api-error-response-behavior).
 
 ## Contributing
 
@@ -503,6 +535,10 @@ Do you want to contribute and are unsure where to start? Ping me on Twitter, and
 
 Check [Contributing](/CONTRIBUTING.MD) file.
 
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for a list of changes.
+
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

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/client.rb

@@ -7,9 +7,9 @@ module WhatsappSdk
   module Api
     class Client
       API_VERSIONS = [
-        'v21.0', 'v20.0', 'v19.0', 'v18.0', 'v17.0', 'v16.0', 'v15.0', 'v14.0', 'v13.0', 'v12.0',
-        'v11.0', 'v10.0', 'v9.0', 'v8.0', 'v7.0', 'v6.0', 'v5.0', 'v4.0', 'v3.3',
-        'v3.2', 'v3.1', 'v3.0', 'v2.12', 'v2.11', 'v2.10', 'v2.9', 'v2.8', 'v2.7',
+        'v24.0', 'v23.0', 'v22.0', 'v21.0', 'v20.0', 'v19.0', 'v18.0', 'v17.0', 'v16.0', 'v15.0', 'v14.0',
+        'v13.0', 'v12.0', 'v11.0', 'v10.0', 'v9.0', 'v8.0', 'v7.0', 'v6.0', 'v5.0', 'v4.0',
+        'v3.3', 'v3.2', 'v3.1', 'v3.0', 'v2.12', 'v2.11', 'v2.10', 'v2.9', 'v2.8', 'v2.7',
         'v2.6', 'v2.5', 'v2.4', 'v2.3', 'v2.2', 'v2.1'
       ].freeze
 
@@ -50,7 +50,7 @@ module WhatsappSdk
       def send_request(endpoint: "", full_url: nil, http_method: "post", params: {}, headers: {}, multipart: false)
         url = full_url || "#{ApiConfiguration::API_URL}/#{@api_version}/"
 
-        faraday_request = faraday(url:, multipart:)
+        faraday_request = faraday(url: url, multipart: multipart)
 
         response = faraday_request.public_send(http_method, endpoint, request_params(params, headers), headers)
 

data/lib/whatsapp_sdk/api/messages.rb

@@ -411,6 +411,31 @@ module WhatsappSdk
         Api::Responses::MessageDataResponse.build_from_response(response: response)
       end
 
+      # Send typing indicator
+      #
+      # @param sender_id [Integer] Sender' phone number.
+      # @param message_id [String] the id of the message received in the messages webhooks.
+      # @return [Hash] Response object with success status.
+      def send_typing_indicator(sender_id:, message_id:)
+        params = {
+          messaging_product: "whatsapp",
+          recipient_type: "individual",
+          status: "read",
+          message_id: message_id,
+          typing_indicator: {
+            type: "text"
+          }
+        }
+
+        response = send_request(
+          endpoint: endpoint(sender_id),
+          params: params,
+          headers: DEFAULT_HEADERS
+        )
+
+        Api::Responses::SuccessResponse.success_response?(response: response)
+      end
+
       private
 
       def endpoint(sender_id)

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.3"
+  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.3
+  version: 1.0.5
 platform: ruby
 authors:
 - ignacio-chiazzo
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-01-08 00:00:00.000000000 Z
+date: 2026-01-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -208,7 +208,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.3
+rubygems_version: 3.4.1
 signing_key:
 specification_version: 4
 summary: Use the Ruby Whatsapp SDK to communicate with Whatsapp API using the Cloud