whatsapp_sdk 0.7.2 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 78aea6934c0189c059dbce4818236b2299319a19b41e8c5ca7d0eca21e8facd3
-  data.tar.gz: 1afd90036deb2f2f2010e2925c09f440215f5bad874d1b0038f4f65f110e1002
+  metadata.gz: cf1d072bf1bc9cd834a9917a863177cc0b5b2ddfac0c29b0d4e899ee23cb9c19
+  data.tar.gz: 25dca7a61a5d80d19fcf32fa54e07edcb911901e936c5b315e46488d87c8b900
 SHA512:
-  metadata.gz: fcf1df484e0246c5d78110089208391bda6ffcaca8914b518d7b95f38b0f7ea5fb8be9c251b0cf24cb7276122b1c8ead1031b612c351697bb0cf22e0996f1c97
-  data.tar.gz: b39fb20cc9af081b217e4478432190a3941e2d87f6abe85e69626e6891293d6065b180075160e6cf8c84a1a61442cb585a186740a984bfcefd5d650fce903627
+  metadata.gz: 5a1204308855d7fb8945a5fda9a3939928b0ec5d6cc6e65fe95abfb303eec2f3dfa4f667f6b9cfc3c264144cdf8290eb80e7aa2ed5e60b213da398d1beded5ef
+  data.tar.gz: 82039c3038209445ad552cca6c23755d8acf2662af4ff6c3fb63464979a42533c92d5768cd376c72252e5b4058932b71a8b9d393471aeb7ba4903a1b62358c12

data/.rubocop.yml

@@ -26,7 +26,10 @@ Layout/LineLength:
   Max: 120
 
 Metrics/MethodLength:
-  Max: 40
+  Enabled: false
+
+Metrics/BlockLength:
+  Enabled: false
 
 Naming/VariableNumber:
   Enabled: false

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Unreleased 
 
+# v 0.8.0
+- Added Send interactive message @alienware [#82](https://github.com/ignacio-chiazzo/ruby_whatsapp_sdk/pull/82) 
+- Support JRuby @ignacio-chiazzo [#83](https://github.com/ignacio-chiazzo/ruby_whatsapp_sdk/pull/83)
+- Send interactive Reply Buttons Message @alienware [#79](https://github.com/ignacio-chiazzo/ruby_whatsapp_sdk/pull/79)
+
+# v 0.7.3
+- Added the ability to reply messages. @alienware [#77](https://github.com/ignacio-chiazzo/ruby_whatsapp_sdk/pull/77)
+
 # v 0.7.2
 - Added new fields to phone numbers API. @ignacio-chiazzo [#73](https://github.com/ignacio-chiazzo/ruby_whatsapp_sdk/pull/73)
 - Upgraded API version to v16. @ignacio-chiazzo [#73](https://github.com/ignacio-chiazzo/ruby_whatsapp_sdk/pull/73)

data/Gemfile

@@ -7,7 +7,6 @@ git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
 
 gem("faraday")
 gem("faraday-multipart")
-gem("oj")
 gem("rake", ">= 12.3.3")
 gem('sorbet-runtime')
 gem("zeitwerk", ">= 2.6.0")

data/Gemfile.lock

@@ -1,10 +1,9 @@
 PATH
   remote: .
   specs:
-    whatsapp_sdk (0.7.2)
+    whatsapp_sdk (0.8.0)
       faraday (~> 2.3.0)
       faraday-multipart (~> 1.0.4)
-      oj (~> 3.13.13)
       sorbet-runtime (~> 0.5.1)
       zeitwerk (~> 2.6.0)
 
@@ -30,7 +29,6 @@ GEM
     mocha (1.14.0)
     multipart-post (2.2.3)
     netrc (0.11.0)
-    oj (3.13.14)
     parallel (1.22.1)
     parser (3.1.2.0)
       ast (~> 2.4.1)
@@ -119,7 +117,6 @@ DEPENDENCIES
   faraday-multipart
   minitest (~> 5.0)
   mocha
-  oj
   pry
   pry-nav
   rake (>= 12.3.3)

data/README.md

@@ -4,7 +4,7 @@
 <a href="https://codeclimate.com/github/ignacio-chiazzo/ruby_whatsapp_sdk/maintainability"><img src="https://api.codeclimate.com/v1/badges/169cce95450272e4ad7d/maintainability" /></a>
 
 The SDK provides a set of operations and classes to use the Whatsapp API.
-Send stickers, messages, audio, videos, locations, react to messages or just ask for the phone numbers through this library in a few steps!
+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!
 
 
 ## Demo
@@ -218,6 +218,13 @@ messages_api.send_reaction(sender_id: 123_123, recipient_number: 56_789, message
 messages_api.send_reaction(sender_id: 123_123, recipient_number: 56_789, message_id: "12345", emoji: "⛄️")
 ```
 
+**Reply to a message**
+To reply to a message, just include the id of the message in the `messages_api` methods. For example, to reply to a text message include the following:
+
+```ruby
+messages_api.send_text(sender_id: 123_123, recipient_number: 56_789, message: "I'm a reply", message_id: "wamid.1234")
+```
+
 **Send a location message**
 
 ```ruby
@@ -343,8 +350,125 @@ Alernative, you could pass a plain json like this:
 ```ruby
 @messages_api.send_template(sender_id: 12_345, recipient_number: 12345678, name: "hello_world", language: "en_US", components_json: [{...}])
 ```
+
+**Send interactive messages**
+Visit the [Official API Documentation](https://developers.facebook.com/docs/whatsapp/cloud-api/guides/send-messages#interactive-messages)
+
+<details>
+<summary>List Message's example</summary>
+
+```ruby
+interactive_header = WhatsappSdk::Resource::InteractiveHeader.new(
+  type: WhatsappSdk::Resource::InteractiveHeader::Type::Text,
+  text: "I am the header!"
+)
+
+interactive_body = WhatsappSdk::Resource::InteractiveBody.new(
+  text: "I am the body!"
+)
+
+interactive_footer = WhatsappSdk::Resource::InteractiveFooter.new(
+  text: "I am the footer!"
+)
+
+interactive_action = WhatsappSdk::Resource::InteractiveAction.new(
+  type: WhatsappSdk::Resource::InteractiveAction::Type::ListMessage
+)
+
+interactive_action.button = "I am the button CTA"
+
+interactive_section_1 = WhatsappSdk::Resource::InteractiveActionSection.new(
+  title: "I am the section 1"
+)
+interactive_section_1_row_1 = WhatsappSdk::Resource::InteractiveActionSectionRow.new(
+  title: "I am the row 1 title",
+  id: "section_1_row_1",
+  description: "I am the optional section 1 row 1 description"
+)
+interactive_section_1.add_row(interactive_section_1_row_1)
+interactive_action.add_section(interactive_section_1)
+
+interactive_list_messages = WhatsappSdk::Resource::Interactive.new(
+  type: WhatsappSdk::Resource::Interactive::Type::ListMessage,
+  header: interactive_header,
+  body: interactive_body,
+  footer: interactive_footer,
+  action: interactive_action
+)
+
+messages_api.send_interactive_list_messages(
+  sender_id: 12_345, recipient_number: 1234567890,
+  interactive: interactive_list_messages
+)
+```
+</details>
+
+Alternative, you could pass a plain json like this:
+```ruby
+messages_api.send_interactive_list_messages(
+  sender_id: 12_345, recipient_number: 1234567890
+  interactive_json: {...}
+)
+```
+
+<details>
+<summary>Reply Button's example</summary>
+
+```ruby
+interactive_header = WhatsappSdk::Resource::InteractiveHeader.new(
+  type: WhatsappSdk::Resource::InteractiveHeader::Type::Text,
+  text: "I am the header!"
+)
+
+interactive_body = WhatsappSdk::Resource::InteractiveBody.new(
+  text: "I am the body!"
+)
+
+interactive_footer = WhatsappSdk::Resource::InteractiveFooter.new(
+  text: "I am the footer!"
+)
+
+interactive_action = WhatsappSdk::Resource::InteractiveAction.new(
+  type: WhatsappSdk::Resource::InteractiveAction::Type::ReplyButton
+)
+
+interactive_reply_button_1 = WhatsappSdk::Resource::InteractiveActionReplyButton.new(
+  title: "I am the reply button 1",
+  id: "button_1"
+)
+interactive_action.add_reply_button(interactive_reply_button_1)
+
+interactive_reply_button_2 = WhatsappSdk::Resource::InteractiveActionReplyButton.new(
+  title: "I am the reply button 2",
+  id: "button_2"
+)
+interactive_action.add_reply_button(interactive_reply_button_2)
+
+interactive_reply_buttons = WhatsappSdk::Resource::Interactive.new(
+  type: WhatsappSdk::Resource::Interactive::Type::ReplyButton,
+  header: interactive_header,
+  body: interactive_body,
+  footer: interactive_footer,
+  action: interactive_action
+)
+
+messages_api.send_interactive_reply_buttons(
+  sender_id: 12_345, recipient_number: 1234567890,
+  interactive: interactive_reply_buttons
+)
+```
 </details>
 
+Alternative, you could pass a plain json like this:
+```ruby
+messages_api.send_interactive_reply_buttons(
+  sender_id: 12_345, recipient_number: 1234567890
+  interactive_json: {...}
+)
+```
+</details>
+
+
 ## Examples
 
 Visit [the example file](/example.rb) with examples to call the API in a single file.

data/example.rb

@@ -11,7 +11,7 @@ gemfile(true) do
 
   git_source(:github) { |repo| "https://github.com/#{repo}.git" }
 
-  gem "whatsapp_sdk"
+  gem "whatsapp_sdk", path: "../"
   gem "pry"
   gem "pry-nav"
 end
@@ -22,11 +22,11 @@ require "pry-nav"
 
 ################# UPDATE CONSTANTS #################
 
-ACCESS_TOKEN = "<TODO replace>"
-SENDER_ID = "<TODO replace>"
-RECIPIENT_NUMBER = "<TODO replace>"
-BUSINESS_ID = "<TODO replace>"
-IMAGE_LINK = "<TODO replace>"
+ACCESS_TOKEN = "EAAZAvvr0DZBs0BAIOsVV2FogD1qQhIyIrK9vfM7mmfdTlhbRqFZAZBnS2ciXPD35wb8d69siULaU5cqX9HonDNnZA9YLAbrCLUys1qt1E3n4d69v9RTZCoA8bkz9TZCV2PWzRR9DvBmwUOltCOrZBN0vGQxULlhsJE1mTeUrXlpVfFZCY5sWXCKxe04uyd7dzyK0hMgvkCR97OXi9AI3qJFYo"
+SENDER_ID = 111591145018464
+RECIPIENT_NUMBER = 13437772910
+BUSINESS_ID = 102261539298487
+IMAGE_LINK = "https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png"
 
 if ACCESS_TOKEN == "<TODO replace>"
   puts "\n\n**** Please update the ACCESS_TOKEN constant in this file. ****\n\n"
@@ -92,6 +92,11 @@ message_id = message_sent.data.messages.first.id
 messages_api.send_reaction(sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, message_id: message_id, emoji: "\u{1f550}")
 messages_api.send_reaction(sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, message_id: message_id, emoji: "⛄️")
 
+######### Reply to a message 
+message_to_reply_id = message_sent.data.messages.first.id
+reply = messages_api.send_text(sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, message: "I'm a reply", message_id: message_to_reply_id)
+print_message_sent(reply)
+
 ######### Send location
 location_sent = messages_api.send_location(
   sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER,
@@ -225,3 +230,47 @@ response_with_json = messages_api.send_template(
   ]
 )
 puts response_with_json
+
+######### SEND INTERACTIVE MESSAGES
+## with reply buttons
+interactive_header = WhatsappSdk::Resource::InteractiveHeader.new(
+  type: WhatsappSdk::Resource::InteractiveHeader::Type::Text,
+  text: "I'm the header!"
+)
+
+interactive_body = WhatsappSdk::Resource::InteractiveBody.new(
+  text: "I'm the body!"
+)
+
+interactive_footer = WhatsappSdk::Resource::InteractiveFooter.new(
+  text: "I'm the footer!"
+)
+
+interactive_action = WhatsappSdk::Resource::InteractiveAction.new(
+  type: WhatsappSdk::Resource::InteractiveAction::Type::ReplyButton,
+)
+
+interactive_reply_button_1 = WhatsappSdk::Resource::InteractiveActionReplyButton.new(
+  title: "I'm a reply button 1",
+  id: "button_1"
+)
+interactive_action.add_reply_button(interactive_reply_button_1)
+
+interactive_reply_button_2 = WhatsappSdk::Resource::InteractiveActionReplyButton.new(
+  title: "I'm a reply button 2",
+  id: "button_2"
+)
+interactive_action.add_reply_button(interactive_reply_button_2)
+
+interactive_reply_buttons = WhatsappSdk::Resource::Interactive.new(
+  type: WhatsappSdk::Resource::Interactive::Type::ReplyButton,
+  header: interactive_header,
+  body: interactive_body,
+  footer: interactive_footer,
+  action: interactive_action
+)
+
+messages_api.send_interactive_reply_buttons(
+  sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER,
+  interactive: interactive_reply_buttons
+)

data/lib/whatsapp_sdk/api/client.rb

@@ -3,7 +3,6 @@
 
 require "faraday"
 require "faraday/multipart"
-require "oj"
 
 module WhatsappSdk
   module Api
@@ -31,7 +30,9 @@ module WhatsappSdk
 
         response = faraday_request.public_send(http_method, endpoint, request_params(params, headers), headers)
 
-        Oj.load(response.body)
+        return nil if response.body == ""
+
+        JSON.parse(response.body)
       end
 
       sig { params(url: String, path_to_file_name: T.nilable(String)).returns(Net::HTTPResponse) }

data/lib/whatsapp_sdk/api/messages.rb

@@ -29,9 +29,15 @@ module WhatsappSdk
       # @param sender_id [Integer] Sender' phone number.
       # @param recipient_number [Integer] Recipient' Phone number.
       # @param message [String] Text to send.
+      # @param message_id [String] The id of the message to reply to.
       # @return [WhatsappSdk::Api::Response] Response object.
-      sig { params(sender_id: Integer, recipient_number: Integer, message: String).returns(WhatsappSdk::Api::Response) }
-      def send_text(sender_id:, recipient_number:, message:)
+      sig do
+        params(
+          sender_id: Integer, recipient_number: Integer, message: String,
+          message_id: T.nilable(String)
+        ).returns(WhatsappSdk::Api::Response)
+      end
+      def send_text(sender_id:, recipient_number:, message:, message_id: nil)
         params = {
           messaging_product: "whatsapp",
           to: recipient_number,
@@ -39,6 +45,7 @@ module WhatsappSdk
           type: "text",
           text: { body: message }
         }
+        params[:context] = { message_id: message_id } if message_id
 
         response = send_request(
           endpoint: endpoint(sender_id),
@@ -60,14 +67,18 @@ module WhatsappSdk
       # @param latitude [Float] Location latitude.
       # @param name [String] Location name.
       # @param address [String] Location address.
+      # @param message_id [String] The id of the message to reply to.
       # @return [WhatsappSdk::Api::Response] Response object.
       sig do
         params(
           sender_id: Integer, recipient_number: Integer,
-          longitude: Float, latitude: Float, name: String, address: String
+          longitude: Float, latitude: Float, name: String, address: String,
+          message_id: T.nilable(String)
         ).returns(WhatsappSdk::Api::Response)
       end
-      def send_location(sender_id:, recipient_number:, longitude:, latitude:, name:, address:)
+      def send_location(
+        sender_id:, recipient_number:, longitude:, latitude:, name:, address:, message_id: nil
+      )
         params = {
           messaging_product: "whatsapp",
           to: recipient_number,
@@ -80,6 +91,7 @@ module WhatsappSdk
             address: address
           }
         }
+        params[:context] = { message_id: message_id } if message_id
 
         response = send_request(
           endpoint: endpoint(sender_id),
@@ -100,14 +112,18 @@ module WhatsappSdk
       # @param image_id [String] Image ID.
       # @param link [String] Image link.
       # @param caption [String] Image caption.
+      # @param message_id [String] The id of the message to reply to.
       # @return [WhatsappSdk::Api::Response] Response object.
       sig do
         params(
           sender_id: Integer, recipient_number: Integer, image_id: T.nilable(String),
-          link: T.nilable(String), caption: T.nilable(String)
+          link: T.nilable(String), caption: T.nilable(String),
+          message_id: T.nilable(String)
         ).returns(WhatsappSdk::Api::Response)
       end
-      def send_image(sender_id:, recipient_number:, image_id: nil, link: nil, caption: "")
+      def send_image(
+        sender_id:, recipient_number:, image_id: nil, link: nil, caption: "", message_id: nil
+      )
         raise MissingArgumentError, "image_id or link is required" if !image_id && !link
 
         params = {
@@ -121,6 +137,7 @@ module WhatsappSdk
                          else
                            { id: image_id, caption: caption }
                          end
+        params[:context] = { message_id: message_id } if message_id
 
         response = send_request(
           endpoint: endpoint(sender_id),
@@ -140,13 +157,15 @@ module WhatsappSdk
       # @param recipient_number [Integer] Recipient' Phone number.
       # @param audio_id [String] Audio ID.
       # @param link [String] Audio link.
+      # @param message_id [String] The id of the message to reply to.
       # @return [WhatsappSdk::Api::Response] Response object.
       sig do
         params(
-          sender_id: Integer, recipient_number: Integer, audio_id: T.nilable(String), link: T.nilable(String)
+          sender_id: Integer, recipient_number: Integer, audio_id: T.nilable(String),
+          link: T.nilable(String), message_id: T.nilable(String)
         ).returns(WhatsappSdk::Api::Response)
       end
-      def send_audio(sender_id:, recipient_number:, audio_id: nil, link: nil)
+      def send_audio(sender_id:, recipient_number:, audio_id: nil, link: nil, message_id: nil)
         raise MissingArgumentError, "audio_id or link is required" if !audio_id && !link
 
         params = {
@@ -156,6 +175,7 @@ module WhatsappSdk
           type: "audio"
         }
         params[:audio] = link ? { link: link } : { id: audio_id }
+        params[:context] = { message_id: message_id } if message_id
 
         response = send_request(
           endpoint: endpoint(sender_id),
@@ -176,14 +196,18 @@ module WhatsappSdk
       # @param video_id [String] Video ID.
       # @param link [String] Image link.
       # @param caption [String] Image caption.
+      # @param message_id [String] The id of the message to reply to.
       # @return [WhatsappSdk::Api::Response] Response object.
       sig do
         params(
           sender_id: Integer, recipient_number: Integer,
-          video_id: T.nilable(String), link: T.nilable(String), caption: String
+          video_id: T.nilable(String), link: T.nilable(String), caption: String,
+          message_id: T.nilable(String)
         ).returns(WhatsappSdk::Api::Response)
       end
-      def send_video(sender_id:, recipient_number:, video_id: nil, link: nil, caption: "")
+      def send_video(
+        sender_id:, recipient_number:, video_id: nil, link: nil, caption: "", message_id: nil
+      )
         raise MissingArgumentError, "video_id or link is required" if !video_id && !link
 
         params = {
@@ -197,6 +221,7 @@ module WhatsappSdk
                          else
                            { id: video_id, caption: caption }
                          end
+        params[:context] = { message_id: message_id } if message_id
 
         response = send_request(
           endpoint: endpoint(sender_id),
@@ -217,14 +242,18 @@ module WhatsappSdk
       # @param document_id [String] document ID.
       # @param link [String] Image link.
       # @param caption [String] Image caption.
+      # @param message_id [String] The id of the message to reply to.
       # @return [WhatsappSdk::Api::Response] Response object.
       sig do
         params(
           sender_id: Integer, recipient_number: Integer,
-          document_id: T.nilable(String), link: T.nilable(String), caption: String
+          document_id: T.nilable(String), link: T.nilable(String), caption: String,
+          message_id: T.nilable(String)
         ).returns(WhatsappSdk::Api::Response)
       end
-      def send_document(sender_id:, recipient_number:, document_id: nil, link: nil, caption: "")
+      def send_document(
+        sender_id:, recipient_number:, document_id: nil, link: nil, caption: "", message_id: nil
+      )
         raise MissingArgumentError, "document or link is required" if !document_id && !link
 
         params = {
@@ -238,6 +267,7 @@ module WhatsappSdk
                             else
                               { id: document_id, caption: caption }
                             end
+        params[:context] = { message_id: message_id } if message_id
 
         response = send_request(
           endpoint: endpoint(sender_id),
@@ -257,13 +287,15 @@ module WhatsappSdk
       # @param recipient_number [Integer] Recipient' Phone number.
       # @param sticker_id [String] The sticker ID.
       # @param link [String] Image link.
+      # @param message_id [String] The id of the message to reply to.
       # @return [WhatsappSdk::Api::Response] Response object.
       sig do
         params(
-          sender_id: Integer, recipient_number: Integer, sticker_id: T.nilable(String), link: T.nilable(String)
+          sender_id: Integer, recipient_number: Integer, sticker_id: T.nilable(String),
+          link: T.nilable(String), message_id: T.nilable(String)
         ).returns(WhatsappSdk::Api::Response)
       end
-      def send_sticker(sender_id:, recipient_number:, sticker_id: nil, link: nil)
+      def send_sticker(sender_id:, recipient_number:, sticker_id: nil, link: nil, message_id: nil)
         raise MissingArgumentError, "sticker or link is required" if !sticker_id && !link
 
         params = {
@@ -273,6 +305,7 @@ module WhatsappSdk
           type: Resource::Media::Type::Sticker
         }
         params[:sticker] = link ? { link: link } : { id: sticker_id }
+        params[:context] = { message_id: message_id } if message_id
 
         response = send_request(
           endpoint: endpoint(sender_id),
@@ -293,14 +326,18 @@ module WhatsappSdk
       # @param recipient_number [Integer] Recipient' Phone number.
       # @param contacts [Array<Contact>] Contacts.
       # @param contacts_json [Json] Contacts.
+      # @param message_id [String] The id of the message to reply to.
       # @return [WhatsappSdk::Api::Response] Response object.
       sig do
         params(
           sender_id: Integer, recipient_number: Integer,
-          contacts: T.nilable(T::Array[WhatsappSdk::Resource::Contact]), contacts_json: T::Hash[T.untyped, T.untyped]
+          contacts: T.nilable(T::Array[WhatsappSdk::Resource::Contact]),
+          contacts_json: T::Hash[T.untyped, T.untyped], message_id: T.nilable(String)
         ).returns(WhatsappSdk::Api::Response)
       end
-      def send_contacts(sender_id:, recipient_number:, contacts: nil, contacts_json: {})
+      def send_contacts(
+        sender_id:, recipient_number:, contacts: nil, contacts_json: {}, message_id: nil
+      )
         params = {
           messaging_product: "whatsapp",
           to: recipient_number,
@@ -308,6 +345,7 @@ module WhatsappSdk
           type: "contacts"
         }
         params[:contacts] = contacts ? contacts.map(&:to_h) : contacts_json
+        params[:context] = { message_id: message_id } if message_id
 
         response = send_request(
           endpoint: endpoint(sender_id),
@@ -325,13 +363,57 @@ module WhatsappSdk
       #   # TODO: https://developers.facebook.com/docs/whatsapp_sdk/cloud-api/reference/messages#contacts-object
       # end
 
-      # def send_interactive_reply_buttons
-      #   # TODO: https://developers.facebook.com/docs/whatsapp_sdk/cloud-api/reference/messages#contacts-object
-      # end
+      # Send interactive reply buttons.
+      # https://developers.facebook.com/docs/whatsapp/guides/interactive-messages#reply-buttons
+      # You can either send interactive object or as JSON.
+      #
+      # @param sender_id [Integer] Sender' phone number.
+      # @param recipient_number [Integer] Recipient' Phone number.
+      # @param interactive [Interactive] Interactive.
+      # @param interactive_json [Json] The interactive object as a Json.
+      #    If you pass interactive_json, you can't pass interactive.
+      # @param message_id [String] The id of the message to reply to.
+      # @return [WhatsappSdk::Api::Response] Response object.
+      sig do
+        params(
+          sender_id: Integer, recipient_number: Integer,
+          interactive: T.nilable(WhatsappSdk::Resource::Interactive),
+          interactive_json: T.nilable(T::Hash[T.untyped, T.untyped]), message_id: T.nilable(String)
+        ).returns(WhatsappSdk::Api::Response)
+      end
+      def send_interactive_message(
+        sender_id:, recipient_number:, interactive: nil, interactive_json: nil, message_id: nil
+      )
+        raise MissingArgumentError, "interactive or interactive_json is required" if !interactive && !interactive_json
 
-      # def send_interactive_section
-      #   # TODO: https://developers.facebook.com/docs/whatsapp_sdk/cloud-api/reference/messages#contacts-object
-      # end
+        params = {
+          messaging_product: "whatsapp",
+          to: recipient_number,
+          recipient_type: "individual",
+          type: "interactive"
+        }
+
+        params[:interactive] = if interactive.nil?
+                                 interactive_json
+                               else
+                                 interactive.to_json
+                               end
+        params[:context] = { message_id: message_id } if message_id
+
+        response = send_request(
+          endpoint: endpoint(sender_id),
+          params: params,
+          headers: DEFAULT_HEADERS
+        )
+
+        WhatsappSdk::Api::Response.new(
+          response: response,
+          data_class_type: WhatsappSdk::Api::Responses::MessageDataResponse
+        )
+      end
+
+      alias :send_interactive_reply_buttons :send_interactive_message
+      alias :send_interactive_list_messages :send_interactive_message
 
       # Mark a message as read.
       #
@@ -374,7 +456,9 @@ module WhatsappSdk
           components_json: T.nilable(T::Array[T::Hash[T.untyped, T.untyped]])
         ).returns(WhatsappSdk::Api::Response)
       end
-      def send_template(sender_id:, recipient_number:, name:, language:, components: nil, components_json: nil)
+      def send_template(
+        sender_id:, recipient_number:, name:, language:, components: nil, components_json: nil
+      )
         raise MissingArgumentError, "components or components_json is required" if !components && !components_json
 
         params = {
@@ -415,7 +499,8 @@ module WhatsappSdk
       # @return [WhatsappSdk::Api::Response] Response object.
       sig do
         params(
-          sender_id: Integer, recipient_number: Integer, message_id: String, emoji: T.any(String, Integer)
+          sender_id: Integer, recipient_number: Integer, message_id: String,
+          emoji: T.any(String, Integer)
         ).returns(WhatsappSdk::Api::Response)
       end
       def send_reaction(sender_id:, recipient_number:, message_id:, emoji:)

data/lib/whatsapp_sdk/resource/error.rb

@@ -0,0 +1,39 @@
+# typed: strict
+# frozen_string_literal: true
+
+module WhatsappSdk
+  module Resource
+    module Error
+      class MissingValue < WhatsappSdk::Error
+        extend T::Sig
+
+        sig { returns(String) }
+        attr_reader :field
+
+        sig { returns(String) }
+        attr_reader :message
+
+        sig { params(field: String, message: String).void }
+        def initialize(field, message)
+          @field = field
+          @message = message
+          super(message)
+        end
+      end
+
+      class InvalidField < MissingValue; end
+
+      class InvalidInteractiveBody < WhatsappSdk::Error; end
+
+      class InvalidInteractiveActionReplyButton < WhatsappSdk::Error; end
+
+      class InvalidInteractiveActionButton < WhatsappSdk::Error; end
+
+      class InvalidInteractiveActionSection < WhatsappSdk::Error; end
+
+      class InvalidInteractiveActionSectionRow < WhatsappSdk::Error; end
+
+      class InvalidInteractiveFooter < WhatsappSdk::Error; end
+    end
+  end
+end