whatsapp_sdk 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b4f5058be0fce569741f60508e508ec0b1cba2eccffbc5f510d7312cb023847b
-  data.tar.gz: 0af25be3aad6fdb5ffc60b014745294a0fa5cf496ce11ce68ebb886a774dfca4
+  metadata.gz: f68cc009fe9fd27e79ac8e7f1a128204c66a565f055bce04bf4338f63ccb4f63
+  data.tar.gz: 49c4b5891624196c2557166cce8587e645a12e16716ccbc216c19f048cf2ab41
 SHA512:
-  metadata.gz: 6f1ede78aafc6391e5de55ac4aa338a3286d5a9eb634a6afac22bf28cf39afa2f8e8356db2f266aa1bb7101ca122497b6036b843146fb77890c6f10d7460f7f8
-  data.tar.gz: 4b7524e665d2c13e4b8561e125b1cdbccbdfc1f95c49b7b465ce0e368918ce239a17afb58d83625b28a3288d803b25680b78167a967e69f3575d27071f7d9d2c
+  metadata.gz: 91204e0864c369777ff18f63c95f846acbcfa6248ed52fa0db6d05f43784be704e124edffcc73f4d3e0d565269b1784058ede119bdd862d067f75a49550d67df
+  data.tar.gz: 606a0b4ab9601388c2c737e47306cbc2432ef763efd82a869dd92be7d23d8fc2a6877573f1db5119b20ff8135523469a47ed02e2f75f857f33b238b6e7e23be5

data/.rubocop.yml

@@ -1,3 +1,6 @@
+AllCops:
+  NewCops: enable
+
 Style/StringLiterals:
   Enabled: false
 
@@ -24,4 +27,4 @@ Metrics/AbcSize:
 
 # Wait until https://github.com/rubocop/rubocop/issues/8761 is fixed
 Gemspec/RequiredRubyVersion:
-  Enabled: false
+  Enabled: false

data/CHANGELOG.md

@@ -1,4 +1,11 @@
 # Unreleased
+
+# v 0.2.0
+- Added Media API
+- Update Facebook API to v14
+- Added error and sucess responses
+- Added faraday-multiplart as part of the library
+ 
 # v 0.1.0
 - Added Message Template API.
 - Added Currency and Datetime resources.

data/Gemfile

@@ -6,6 +6,7 @@ git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
 
 # Specify your gem's dependencies in whatsapp_sdk.gemspec
 gem("faraday")
+gem("faraday-multipart")
 gem("oj")
 
 group(:test) do

data/Gemfile.lock

@@ -1,8 +1,9 @@
 PATH
   remote: .
   specs:
-    whatsapp_sdk (0.0.1)
+    whatsapp_sdk (0.2.0)
       faraday (~> 2.3.0)
+      faraday-multipart (~> 1.0.4)
       oj (~> 3.13.13)
 
 GEM
@@ -13,10 +14,13 @@ GEM
     faraday (2.3.0)
       faraday-net_http (~> 2.0)
       ruby2_keywords (>= 0.0.4)
+    faraday-multipart (1.0.4)
+      multipart-post (~> 2)
     faraday-net_http (2.0.3)
     method_source (1.0.0)
     minitest (5.15.0)
     mocha (1.14.0)
+    multipart-post (2.2.2)
     oj (3.13.13)
     parallel (1.22.1)
     parser (3.1.2.0)
@@ -51,6 +55,7 @@ PLATFORMS
 DEPENDENCIES
   bundler (~> 2.3)
   faraday
+  faraday-multipart
   minitest (~> 5.0)
   mocha
   oj

data/README.md

@@ -38,6 +38,7 @@ First, create the client and then create an instance `WhatsappSdk::Api::Messages
 client = WhatsappSdk::Api::Client.new("<ACCESS TOKEN>") # replace this with a valid access_token
 messages_api = WhatsappSdk::Api::Messages.new(client)
 phone_numbers_api = WhatsappSdk::Api::PhoneNumbers.new(client)
+medias_api = WhatsappSdk::Api::Medias.new(client)
 ```
 
 ### Phone numbers API
@@ -51,6 +52,28 @@ Get the a phone number by id
 phone_numbers_api.registered_numbers("123456") # accepts a phone_number_id
 ```
 
+### Media API
+
+Upload a media
+```ruby
+medias_api.upload(sender_id: SENDER_ID, file_path: "tmp/whatsapp.png", type: "image/png")
+```
+
+Get a media
+```ruby
+media = medias_api.media(media_id: MEDIA_ID)
+```
+
+Download media
+```ruby
+medias_api.download(url: MEDIA_URL, file_path: 'tmp/downloaded_whatsapp.png')
+```
+
+Delete a media
+```ruby
+medias_api.delete(media_id: MEDIA_ID)
+```
+
 ### Messages API
 
 **Send a text message**
@@ -193,6 +216,10 @@ Visit [the example file](/example.rb) with examples to call the API in a single
 - See the [official documentation](https://developers.facebook.com/docs/whatsapp/cloud-api) for the Whatsapp Cloud API.
 - For pricing, refer to the [official documentation](https://developers.facebook.com/docs/whatsapp/pricing/). As of today, Whatsapp offers have 1000 conversations free per month.
 
+## Troubleshooting
+
+- If the API response is success but the message is not delivered, make sure 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)
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests.

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", github: "ignacio-chiazzo/whatsapp_sdk", branch: "main"
   gem "pry"
   gem "pry-nav"
 end
@@ -20,141 +20,181 @@ require 'whatsapp_sdk'
 require "pry"
 require "pry-nav"
 
-ACCESS_TOKEN = "foo" # replace this with a valid access_token
-SENDER_ID = 123
-RECIPIENT_NUMBER = "456"
+################# UPDATE CONSTANTS #################
+
+ACCESS_TOKEN = "<TODO replace>"
+SENDER_ID = "<TODO replace>"
+RECIPIENT_NUMBER = "<TODO replace>"
+BUSINESS_ID = "<TODO replace>"
+IMAGE_LINK = "<TODO replace>"
+
+################# HELPERS ########################
+def print_message_sent(message_response)
+  if message_response.ok?
+    puts "Message sent to: #{message_response.data.contacts.first.input}"
+  else
+    puts "Error: #{message_response.error&.to_s}"
+  end
+end
+##################################################
 
-client = WhatsappSdk::Api::Client.new(ACCESS_TOKEN) # replace this with a valid access_token
+client = WhatsappSdk::Api::Client.new(ACCESS_TOKEN)
+medias_api = WhatsappSdk::Api::Medias.new(client)
 messages_api = WhatsappSdk::Api::Messages.new(client)
 phone_numbers_api = WhatsappSdk::Api::PhoneNumbers.new(client)
 
-phone_numbers_api.registered_number("123")
-phone_numbers_api.registered_numbers("457")
+############################## Phone Numbers API ##############################
+phone_numbers_api.registered_number(SENDER_ID)
+phone_numbers_api.registered_numbers(BUSINESS_ID)
+############################## Media API ##############################
+
+# upload a media
+uploaded_media = medias_api.upload(sender_id: SENDER_ID, file_path: "tmp/whatsapp.png", type: "image/png")
+puts "Uploaded media id: #{uploaded_media.data&.id}"
+
+# get a media
+media = medias_api.media(media_id: uploaded_media.data&.id).data
+puts "Media info: #{media.raw_data_response}"
+
+# download media
+download_image = medias_api.download(url: media&.url, file_path: 'tmp/downloaded_whatsapp.png')
+puts "Downloaded: #{download_image.data.success?}"
+
+# delete a media
+deleted_media = medias_api.delete(media_id: media&.id)
+puts "Deleted: #{deleted_media.data.success?}"
 
-messages_api.send_text(sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, message: "hola")
-messages_api.send_location(
+############################## Messages API ##############################
+
+######### SEND A TEXT MESSAGE
+message_sent = messages_api.send_text(sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER,
+                                      message: "Hey there! it's Whatsapp Ruby SDK")
+print_message_sent(message_sent)
+
+location_sent = messages_api.send_location(
   sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER,
-  longitude: 45.4215, latitude: 75.6972, name: "nacho", address: "141 cooper street"
+  longitude: -75.6898604, latitude: 45.4192206, name: "Ignacio", address: "My house"
 )
+print_message_sent(location_sent)
 
-# Send images
-
-## with a link
-messages_api.send_image(
-  sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, link: "image_link", caption: "Ignacio Chiazzo Profile"
+######### SEND AN IMAGE
+# Send an image with a link
+image_sent = messages_api.send_image(
+  sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, link: media.url, caption: "Ignacio Chiazzo Profile"
 )
+print_message_sent(image_sent)
 
-## with an image id
+# Send an image with an id
 messages_api.send_image(
-  sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, image_id: "1234", caption: "Ignacio Chiazzo Profile"
+  sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, image_id: media.id, caption: "Ignacio Chiazzo Profile"
 )
 
-# Send audios
+######### SEND AUDIOS
 ## with a link
-messages_api.send_audio(sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, link: "audio_link")
+# messages_api.send_audio(sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, link: "audio_link")
 
 ## with an audio id
-messages_api.send_audio(sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, audio_id: "1234")
+# messages_api.send_audio(sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, audio_id: "1234")
 
-# Send documents
+######### SEND DOCUMENTS
 ## with a link
-messages_api.send_document(
-  sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, link: "document_link", caption: "Ignacio Chiazzo"
-)
+# messages_api.send_document(
+#   sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, link: "document_link", caption: "Ignacio Chiazzo"
+# )
 
 ## with a document id
-messages_api.send_document(
-  sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, document_id: "1234", caption: "Ignacio Chiazzo"
-)
+# messages_api.send_document(
+#   sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, document_id: "1234", caption: "Ignacio Chiazzo"
+# )
 
-# send stickers
+######### SEND STICKERS
 ## with a link
-messages_api.send_sticker(sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, link: "link")
+# messages_api.send_sticker(sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, link: "link")
 
 ## with a sticker_id
-messages_api.send_sticker(sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, sticker_id: "1234")
+# messages_api.send_sticker(sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, sticker_id: "1234")
 
-# Send a template.
+######### SEND A TEMPLATE
 # Note: The template must have been created previously.
 
-header_component = WhatsappSdk::Resource::Component.new(
-  type: WhatsappSdk::Resource::Component::Type::HEADER
-)
-
-image = WhatsappSdk::Resource::Media.new(type: "image", link: "http(s)://URL", caption: "caption")
-document = WhatsappSdk::Resource::Media.new(type: "document", link: "http(s)://URL", filename: "txt.rb")
-video = WhatsappSdk::Resource::Media.new(type: "video", id: 123)
-
-parameter_image = WhatsappSdk::Resource::ParameterObject.new(
-  type: "image",
-  image: image
-)
-
-parameter_document = WhatsappSdk::Resource::ParameterObject.new(
-  type: "document",
-  document: document
-)
-
-parameter_video = WhatsappSdk::Resource::ParameterObject.new(
-  type: "video",
-  video: video
-)
-
-parameter_text = WhatsappSdk::Resource::ParameterObject.new(
-  type: "text",
-  text: "I am a text"
-)
-
-header_component.add_parameter(parameter_text)
-header_component.add_parameter(parameter_image)
-header_component.add_parameter(parameter_video)
-header_component.add_parameter(parameter_document)
-header_component.to_json
-
-body_component = WhatsappSdk::Resource::Component.new(
-  type: WhatsappSdk::Resource::Component::Type::BODY
-)
-body_component.add_parameter(parameter_text)
-body_component.add_parameter(parameter_image)
-body_component.add_parameter(parameter_video)
-body_component.add_parameter(parameter_document)
-body_component.to_json
-
-button_component_1 = WhatsappSdk::Resource::Component.new(
-  type: WhatsappSdk::Resource::Component::Type::BUTTON,
-  index: 0,
-  sub_type: WhatsappSdk::Resource::Component::Subtype::QUICK_REPLY,
-  parameters: [WhatsappSdk::Resource::ButtonParameter.new(type: "payload", payload: "payload")]
-)
-
-button_component_2 = WhatsappSdk::Resource::Component.new(
-  type: WhatsappSdk::Resource::Component::Type::BUTTON,
-  index: 1,
-  sub_type: WhatsappSdk::Resource::Component::Subtype::QUICK_REPLY,
-  parameters: [WhatsappSdk::Resource::ButtonParameter.new(type: "payload", payload: "payload")]
-)
-
-# make sure that the template was created
-response_with_json = messages_api.send_template(
-  sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, name: "hello_world", language: "en_US",
-  components_json: [
-    {
-      "type": "header",
-      "parameters": [
-        {
-          "type": "image",
-          "image": {
-            "link": "https://www.google.com/imgres?imgurl=https%3A%2F%2Fqph.cf2.quoracdn.net%2Fmain-qimg-6d977408fdd90a09a1fee7ba9e2f777c-lq&imgrefurl=https%3A%2F%2Fwww.quora.com%2FHow-can-I-find-my-WhatsApp-ID&tbnid=lDAx1vzXwqCakM&vet=12ahUKEwjKupLviJX4AhVrrHIEHQpGD9MQMygAegUIARC9AQ..i&docid=s-DNQVCrZmhJYM&w=602&h=339&q=example%20whatsapp%20image%20id&ved=2ahUKEwjKupLviJX4AhVrrHIEHQpGD9MQMygAegUIARC9AQ"
-          }
-        }
-      ]
-    }
-  ]
-)
-puts response_with_json
-
-response_with_object = messages_api.send_template(
-  sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, name: "hello_world", language: "en_US",
-  components: [header_component, body_component, button_component_1, button_component_2]
-)
+# Send a template with no component
+response_with_object = messages_api.send_template(sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER,
+                                                  name: "hello_world", language: "en_US", components: [])
 puts response_with_object
+
+# Send a template with components. Remember to create the template first.
+# header_component = WhatsappSdk::Resource::Component.new(
+#   type: WhatsappSdk::Resource::Component::Type::HEADER
+# )
+
+# image = WhatsappSdk::Resource::Media.new(type: "image", link: "http(s)://URL", caption: "caption")
+# document = WhatsappSdk::Resource::Media.new(type: "document", link: "http(s)://URL", filename: "txt.rb")
+# video = WhatsappSdk::Resource::Media.new(type: "video", id: 123)
+
+# parameter_image = WhatsappSdk::Resource::ParameterObject.new(
+#   type: "image",
+#   image: image
+# )
+
+# parameter_document = WhatsappSdk::Resource::ParameterObject.new(
+#   type: "document",
+#   document: document
+# )
+
+# parameter_video = WhatsappSdk::Resource::ParameterObject.new(
+#   type: "video",
+#   video: video
+# )
+
+# parameter_text = WhatsappSdk::Resource::ParameterObject.new(
+#   type: "text",
+#   text: "I am a text"
+# )
+
+# header_component.add_parameter(parameter_text)
+# header_component.add_parameter(parameter_image)
+# header_component.add_parameter(parameter_video)
+# header_component.add_parameter(parameter_document)
+# header_component.to_json
+
+# body_component = WhatsappSdk::Resource::Component.new(
+#   type: WhatsappSdk::Resource::Component::Type::BODY
+# )
+# body_component.add_parameter(parameter_text)
+# body_component.add_parameter(parameter_image)
+# body_component.add_parameter(parameter_video)
+# body_component.add_parameter(parameter_document)
+# body_component.to_json
+
+# button_component_1 = WhatsappSdk::Resource::Component.new(
+#   type: WhatsappSdk::Resource::Component::Type::BUTTON,
+#   index: 0,
+#   sub_type: WhatsappSdk::Resource::Component::Subtype::QUICK_REPLY,
+#   parameters: [WhatsappSdk::Resource::ButtonParameter.new(type: "payload", payload: "payload")]
+# )
+
+# button_component_2 = WhatsappSdk::Resource::Component.new(
+#   type: WhatsappSdk::Resource::Component::Type::BUTTON,
+#   index: 1,
+#   sub_type: WhatsappSdk::Resource::Component::Subtype::QUICK_REPLY,
+#   parameters: [WhatsappSdk::Resource::ButtonParameter.new(type: "payload", payload: "payload")]
+# )
+
+# # Send a template with component_json
+# response_with_json = messages_api.send_template(
+#   sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, name: "hello_world", language: "en_US",
+#   components_json: [
+#     {
+#       "type" => "header",
+#       "parameters" => [
+#         {
+#           "type" => "image",
+#           "image" => {
+#             "link" => "https://www.google.com/imgres?imgurl=https%3A%2F%2Fqph.cf2.quoracdn.net%2Fmain-qimg-6d977408fdd90a09a1fee7ba9e2f777c-lq&imgrefurl=https%3A%2F%2Fwww.quora.com%2FHow-can-I-find-my-WhatsApp-ID&tbnid=lDAx1vzXwqCakM&vet=12ahUKEwjKupLviJX4AhVrrHIEHQpGD9MQMygAegUIARC9AQ..i&docid=s-DNQVCrZmhJYM&w=602&h=339&q=example%20whatsapp%20image%20id&ved=2ahUKEwjKupLviJX4AhVrrHIEHQpGD9MQMygAegUIARC9AQ"
+#           }
+#         }
+#       ]
+#     }
+#   ]
+# )
+# puts response_with_json

data/lib/version.rb

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

data/lib/whatsapp_sdk/api/client.rb

@@ -6,25 +6,45 @@ require "oj"
 module WhatsappSdk
   module Api
     class Client
-      API_VERSION = "v13.0"
+      API_VERSION = "v14.0"
       API_CLIENT = "https://graph.facebook.com/#{API_VERSION}/"
 
       def initialize(access_token)
         @access_token = access_token
       end
 
-      def client
-        @client ||= ::Faraday.new(API_CLIENT) do |client|
+      def send_request(endpoint: "", full_url: nil, http_method: "post", params: {})
+        url = full_url || API_CLIENT
+
+        response = faraday(url).public_send(http_method, endpoint, params)
+        Oj.load(response.body)
+      end
+
+      def download_file(url, path_to_file_name = nil)
+        uri = URI.parse(url)
+        request = Net::HTTP::Get.new(uri)
+        request["Authorization"] = "Bearer #{@access_token}"
+        req_options = { use_ssl: uri.scheme == "https" }
+
+        response = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|
+          http.request(request)
+        end
+
+        File.write(path_to_file_name, response.body) if response.code == "200" && path_to_file_name
+
+        response
+      end
+
+      private
+
+      def faraday(url)
+        ::Faraday.new(url) do |client|
+          client.request :multipart
           client.request :url_encoded
           client.adapter ::Faraday.default_adapter
           client.headers['Authorization'] = "Bearer #{@access_token}" unless @access_token.nil?
         end
       end
-
-      def send_request(endpoint:, http_method: "post", params: {})
-        response = client.public_send(http_method, endpoint, params)
-        Oj.load(response.body)
-      end
     end
   end
 end

data/lib/whatsapp_sdk/api/medias.rb

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+require "faraday"
+require "faraday/multipart"
+
+require_relative "request"
+require_relative "response"
+require_relative '../../../lib/whatsapp_sdk/api/responses/media_data_response'
+require_relative '../../../lib/whatsapp_sdk/api/responses/success_response'
+
+module WhatsappSdk
+  module Api
+    class Medias < Request
+      class FileNotFoundError < StandardError
+        attr_reader :file_path
+
+        def initialize(file_path)
+          @file_path = file_path
+          super("Couldn't find file_path: #{file_path}")
+        end
+      end
+
+      # Get Media by ID.
+      #
+      # @param media_id [Integer] Media Id.
+      # @return [WhatsappSdk::Api::Response] Response object.
+      def media(media_id:)
+        response = send_request(
+          http_method: "get",
+          endpoint: "/#{media_id}"
+        )
+
+        WhatsappSdk::Api::Response.new(
+          response: response,
+          data_class_type: WhatsappSdk::Api::Responses::MediaDataResponse
+        )
+      end
+
+      # Download Media by URL.
+      #
+      # @param media_id [Integer] Media Id.
+      # @param file_path [String] The file_path to download the media e.g. "tmp/downloaded_image.png".
+      # @return [WhatsappSdk::Api::Response] Response object.
+      def download(url:, file_path:)
+        response = download_file(url, file_path)
+
+        response = if response.code.to_i == 200
+                     { "success" => true }
+                   else
+                     { "error" => true, "status" => response.code }
+                   end
+
+        WhatsappSdk::Api::Response.new(
+          response: response,
+          data_class_type: WhatsappSdk::Api::Responses::SuccessResponse,
+          error_class_type: WhatsappSdk::Api::Responses::ErrorResponse
+        )
+      end
+
+      # Upload a media.
+      # @param sender_id [Integer] Sender' phone number.
+      # @param file_path [String] Path to the file stored in your local directory. For example: "tmp/whatsapp.png".
+      # @param type [String] Media type e.g. text/plain, video/3gp, image/jpeg, image/png. For more information,
+      # see the official documentation https://developers.facebook.com/docs/whatsapp/cloud-api/reference/media#supported-media-types.
+      #
+      # @return [WhatsappSdk::Api::Response] Response object.
+      def upload(sender_id:, file_path:, type:)
+        raise FileNotFoundError, file_path unless File.file?(file_path)
+
+        params = {
+          messaging_product: "whatsapp",
+          file: Faraday::FilePart.new(file_path, type),
+          type: type
+        }
+
+        response = send_request(http_method: "post", endpoint: "#{sender_id}/media", params: params)
+
+        WhatsappSdk::Api::Response.new(
+          response: response,
+          data_class_type: WhatsappSdk::Api::Responses::MediaDataResponse
+        )
+      end
+
+      # Delete a Media by ID.
+      #
+      # @param media_id [Integer] Media Id.
+      # @return [WhatsappSdk::Api::Response] Response object.
+      def delete(media_id:)
+        response = send_request(
+          http_method: "delete",
+          endpoint: "/#{media_id}"
+        )
+
+        WhatsappSdk::Api::Response.new(
+          response: response,
+          data_class_type: WhatsappSdk::Api::Responses::SuccessResponse
+        )
+      end
+    end
+  end
+end

data/lib/whatsapp_sdk/api/messages.rb

@@ -27,7 +27,7 @@ module WhatsappSdk
           to: recipient_number,
           recipient_type: "individual",
           type: "text",
-          "text": { body: message }
+          text: { body: message }
         }
 
         response = send_request(
@@ -35,7 +35,10 @@ module WhatsappSdk
           params: params
         )
 
-        WhatsappSdk::Api::Response.new(response: response, class_type: WhatsappSdk::Api::Responses::MessageDataResponse)
+        WhatsappSdk::Api::Response.new(
+          response: response,
+          data_class_type: WhatsappSdk::Api::Responses::MessageDataResponse
+        )
       end
 
       # Send location.
@@ -53,11 +56,11 @@ module WhatsappSdk
           to: recipient_number,
           recipient_type: "individual",
           type: "location",
-          "location": {
-            "longitude": longitude,
-            "latitude": latitude,
-            "name": name,
-            "address": address
+          location: {
+            longitude: longitude,
+            latitude: latitude,
+            name: name,
+            address: address
           }
         }
 
@@ -66,7 +69,10 @@ module WhatsappSdk
           params: params
         )
 
-        WhatsappSdk::Api::Response.new(response: response, class_type: WhatsappSdk::Api::Responses::MessageDataResponse)
+        WhatsappSdk::Api::Response.new(
+          response: response,
+          data_class_type: WhatsappSdk::Api::Responses::MessageDataResponse
+        )
       end
 
       # Send an image.
@@ -97,7 +103,10 @@ module WhatsappSdk
           params: params
         )
 
-        WhatsappSdk::Api::Response.new(response: response, class_type: WhatsappSdk::Api::Responses::MessageDataResponse)
+        WhatsappSdk::Api::Response.new(
+          response: response,
+          data_class_type: WhatsappSdk::Api::Responses::MessageDataResponse
+        )
       end
 
       # Send an audio.
@@ -123,7 +132,10 @@ module WhatsappSdk
           params: params
         )
 
-        WhatsappSdk::Api::Response.new(response: response, class_type: WhatsappSdk::Api::Responses::MessageDataResponse)
+        WhatsappSdk::Api::Response.new(
+          response: response,
+          data_class_type: WhatsappSdk::Api::Responses::MessageDataResponse
+        )
       end
 
       # Send a video.
@@ -154,7 +166,10 @@ module WhatsappSdk
           params: params
         )
 
-        WhatsappSdk::Api::Response.new(response: response, class_type: WhatsappSdk::Api::Responses::MessageDataResponse)
+        WhatsappSdk::Api::Response.new(
+          response: response,
+          data_class_type: WhatsappSdk::Api::Responses::MessageDataResponse
+        )
       end
 
       # Send a document.
@@ -185,7 +200,10 @@ module WhatsappSdk
           params: params
         )
 
-        WhatsappSdk::Api::Response.new(response: response, class_type: WhatsappSdk::Api::Responses::MessageDataResponse)
+        WhatsappSdk::Api::Response.new(
+          response: response,
+          data_class_type: WhatsappSdk::Api::Responses::MessageDataResponse
+        )
       end
 
       # Send a document.
@@ -210,7 +228,10 @@ module WhatsappSdk
           params: params
         )
 
-        WhatsappSdk::Api::Response.new(response: response, class_type: WhatsappSdk::Api::Responses::MessageDataResponse)
+        WhatsappSdk::Api::Response.new(
+          response: response,
+          data_class_type: WhatsappSdk::Api::Responses::MessageDataResponse
+        )
       end
 
       # Send contacts.
@@ -235,7 +256,10 @@ module WhatsappSdk
           params: params
         )
 
-        WhatsappSdk::Api::Response.new(response: response, class_type: WhatsappSdk::Api::Responses::MessageDataResponse)
+        WhatsappSdk::Api::Response.new(
+          response: response,
+          data_class_type: WhatsappSdk::Api::Responses::MessageDataResponse
+        )
       end
 
       def send_interactive_button
@@ -269,7 +293,7 @@ module WhatsappSdk
 
         WhatsappSdk::Api::Response.new(
           response: response,
-          class_type: WhatsappSdk::Api::Responses::ReadMessageDataResponse
+          data_class_type: WhatsappSdk::Api::Responses::ReadMessageDataResponse
         )
       end
 
@@ -309,7 +333,7 @@ module WhatsappSdk
 
         WhatsappSdk::Api::Response.new(
           response: response,
-          class_type: WhatsappSdk::Api::Responses::MessageDataResponse
+          data_class_type: WhatsappSdk::Api::Responses::MessageDataResponse
         )
       end
 

data/lib/whatsapp_sdk/api/phone_numbers.rb

@@ -16,8 +16,10 @@ module WhatsappSdk
           endpoint: "#{business_id}/phone_numbers"
         )
 
-        WhatsappSdk::Api::Response.new(response: response,
-                                       class_type: WhatsappSdk::Api::Responses::PhoneNumbersDataResponse)
+        WhatsappSdk::Api::Response.new(
+          response: response,
+          data_class_type: WhatsappSdk::Api::Responses::PhoneNumbersDataResponse
+        )
       end
 
       # Get the registered number id.
@@ -30,8 +32,10 @@ module WhatsappSdk
           endpoint: phone_number_id.to_s
         )
 
-        WhatsappSdk::Api::Response.new(response: response,
-                                       class_type: WhatsappSdk::Api::Responses::PhoneNumberDataResponse)
+        WhatsappSdk::Api::Response.new(
+          response: response,
+          data_class_type: WhatsappSdk::Api::Responses::PhoneNumberDataResponse
+        )
       end
     end
   end

data/lib/whatsapp_sdk/api/request.rb

@@ -10,8 +10,14 @@ module WhatsappSdk
         @client = client
       end
 
-      def send_request(endpoint:, http_method: "post", params: {})
-        @client.send_request(http_method: http_method, endpoint: endpoint, params: params)
+      def download_file(url, path_to_file_name = nil)
+        @client.download_file(url, path_to_file_name)
+      end
+
+      def send_request(endpoint: nil, full_url: nil, http_method: "post", params: {})
+        @client.send_request(
+          http_method: http_method, full_url: full_url, endpoint: endpoint, params: params
+        )
       end
     end
   end

data/lib/whatsapp_sdk/api/response.rb

@@ -4,31 +4,24 @@ require_relative "responses/message_data_response"
 require_relative "responses/phone_number_data_response"
 require_relative "responses/phone_numbers_data_response"
 require_relative "responses/read_message_data_response"
-require_relative "responses/error_response"
+require_relative "responses/message_error_response"
 
 module WhatsappSdk
   module Api
     class Response
       attr_accessor :error, :data
 
-      CLASS_TYPE = {
-        message_data_response: Responses::MessageDataResponse,
-        phone_number_data_response: Responses::PhoneNumberDataResponse,
-        phone_numbers_data_response: Responses::PhoneNumbersDataResponse,
-        read_message_data_response: Responses::ReadMessageDataResponse
-      }.freeze
-
-      def initialize(response:, class_type:)
-        @data = class_type.build_from_response(response: response)
-        @error = Responses::ErrorResponse.build_from_response(response: response)
+      def initialize(response:, data_class_type:, error_class_type: Responses::MessageErrorResponse)
+        @data = data_class_type.build_from_response(response: response)
+        @error = error_class_type.build_from_response(response: response)
       end
 
-      # Whether or not the response is successful.
+      # @return [Boolean] Whether or not the response is successful.
       def ok?
         @error.nil?
       end
 
-      # Whether or not the response has an error.
+      # @return [Boolean] Whether or not the response has an error.
       def error?
         !!@error
       end

data/lib/whatsapp_sdk/api/responses/error_response.rb

@@ -1,32 +1,23 @@
 # frozen_string_literal: true
 
+require_relative "data_response"
+
 module WhatsappSdk
   module Api
     module Responses
-      class ErrorResponse
-        attr_reader :code, :subcode, :message, :type, :data, :fbtrace_id
+      class ErrorResponse < DataResponse
+        attr_accessor :error, :status
 
-        def initialize(code:, subcode:, message:, type:, data:, fbtrace_id:)
-          @code = code
-          @subcode = subcode
-          @message = message
-          @type = type
-          @data = data
-          @fbtrace_id = fbtrace_id
+        def initialize(response:)
+          @error = response["error"]
+          @status = response["status"]
+          super(response)
         end
 
         def self.build_from_response(response:)
-          error_response = response["error"]
-          return unless error_response
+          return unless response["error"]
 
-          new(
-            code: error_response["code"],
-            subcode: error_response["error_subcode"],
-            message: error_response["message"],
-            type: error_response["type"],
-            data: error_response["data"],
-            fbtrace_id: error_response["fbtrace_id"]
-          )
+          new(response: response)
         end
       end
     end

data/lib/whatsapp_sdk/api/responses/media_data_response.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require_relative "data_response"
+
+module WhatsappSdk
+  module Api
+    module Responses
+      class MediaDataResponse < DataResponse
+        attr_accessor :id, :url, :mime_type, :sha256, :file_size, :messaging_product
+
+        def initialize(response)
+          @id = response["id"]
+          @messaging_product = response["messaging_product"]
+          @url = response["url"]
+          @mime_type = response["mime_type"]
+          @sha256 = response["sha256"]
+          @file_size = response["file_size"]
+          super(response)
+        end
+
+        def self.build_from_response(response:)
+          return unless response["id"]
+
+          new(response)
+        end
+      end
+    end
+  end
+end

data/lib/whatsapp_sdk/api/responses/message_error_response.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require_relative "error_response"
+
+module WhatsappSdk
+  module Api
+    module Responses
+      class MessageErrorResponse < ErrorResponse
+        attr_reader :code, :subcode, :message, :type, :data, :fbtrace_id
+
+        def initialize(response:)
+          @code = response["code"]
+          @subcode = response["error_subcode"]
+          @message = response["message"]
+          @type = response["type"]
+          @data = response["data"]
+          @fbtrace_id = response["fbtrace_id"]
+          super(response: response)
+        end
+
+        def self.build_from_response(response:)
+          error_response = response["error"]
+          return unless error_response
+
+          new(response: error_response)
+        end
+      end
+    end
+  end
+end

data/lib/whatsapp_sdk/api/responses/read_message_data_response.rb

@@ -9,10 +9,10 @@ module WhatsappSdk
   module Api
     module Responses
       class ReadMessageDataResponse < DataResponse
-        attr_reader :sucess
+        attr_reader :success
 
         def initialize(response:)
-          @sucess = response["sucess"]
+          @success = response["success"]
           super(response)
         end
 

data/lib/whatsapp_sdk/api/responses/success_response.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require_relative "data_response"
+
+module WhatsappSdk
+  module Api
+    module Responses
+      class SuccessResponse < DataResponse
+        def initialize(response:)
+          @success = response["success"]
+          super(response)
+        end
+
+        def self.build_from_response(response:)
+          return unless response["success"]
+
+          new(response: response)
+        end
+
+        def success?
+          @success
+        end
+      end
+    end
+  end
+end

data/lib/whatsapp_sdk.rb

@@ -3,15 +3,19 @@
 # APIs
 require_relative "whatsapp_sdk/api/phone_numbers"
 require_relative "whatsapp_sdk/api/messages"
+require_relative "whatsapp_sdk/api/medias"
 require_relative "whatsapp_sdk/api/client"
 
 # APIs responses
 require_relative "whatsapp_sdk/api/responses/message_data_response"
 require_relative "whatsapp_sdk/api/responses/phone_number_data_response"
 require_relative "whatsapp_sdk/api/responses/phone_numbers_data_response"
-require_relative "whatsapp_sdk/api/responses/error_response"
+require_relative "whatsapp_sdk/api/responses/message_error_response"
 require_relative "whatsapp_sdk/api/responses/data_response"
 require_relative "whatsapp_sdk/api/responses/read_message_data_response"
+require_relative "whatsapp_sdk/api/responses/media_data_response"
+require_relative "whatsapp_sdk/api/responses/success_response"
+require_relative "whatsapp_sdk/api/responses/error_response"
 
 # Resources
 require_relative "whatsapp_sdk/resource/address"

data/whatsapp_sdk.gemspec

@@ -24,7 +24,7 @@ Gem::Specification.new do |spec|
     spec.metadata["changelog_uri"] = "https://github.com/ignacio-chiazzo/whatsapp_sdk/blob/main/CHANGELOG.md"
   else
     raise "RubyGems 2.0 or newer is required to protect against " \
-      "public gem pushes."
+          "public gem pushes."
   end
 
   # Specify which files should be added to the gem when it is released.
@@ -41,5 +41,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "rake", "~> 10.0"
 
   spec.add_dependency("faraday",  "~> 2.3.0")
+  spec.add_dependency("faraday-multipart", "~> 1.0.4")
   spec.add_dependency("oj", "~> 3.13.13")
+  spec.metadata['rubygems_mfa_required'] = 'true'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: whatsapp_sdk
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - ignacio-chiazzo
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-06-05 00:00:00.000000000 Z
+date: 2022-06-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -66,6 +66,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 2.3.0
+- !ruby/object:Gem::Dependency
+  name: faraday-multipart
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.4
 - !ruby/object:Gem::Dependency
   name: oj
   requirement: !ruby/object:Gem::Requirement
@@ -106,16 +120,20 @@ files:
 - lib/version.rb
 - lib/whatsapp_sdk.rb
 - lib/whatsapp_sdk/api/client.rb
+- lib/whatsapp_sdk/api/medias.rb
 - lib/whatsapp_sdk/api/messages.rb
 - lib/whatsapp_sdk/api/phone_numbers.rb
 - lib/whatsapp_sdk/api/request.rb
 - lib/whatsapp_sdk/api/response.rb
 - lib/whatsapp_sdk/api/responses/data_response.rb
 - lib/whatsapp_sdk/api/responses/error_response.rb
+- lib/whatsapp_sdk/api/responses/media_data_response.rb
 - lib/whatsapp_sdk/api/responses/message_data_response.rb
+- lib/whatsapp_sdk/api/responses/message_error_response.rb
 - lib/whatsapp_sdk/api/responses/phone_number_data_response.rb
 - lib/whatsapp_sdk/api/responses/phone_numbers_data_response.rb
 - lib/whatsapp_sdk/api/responses/read_message_data_response.rb
+- lib/whatsapp_sdk/api/responses/success_response.rb
 - lib/whatsapp_sdk/error.rb
 - lib/whatsapp_sdk/resource/address.rb
 - lib/whatsapp_sdk/resource/button_parameter.rb
@@ -132,6 +150,7 @@ files:
 - lib/whatsapp_sdk/resource/parameter_object.rb
 - lib/whatsapp_sdk/resource/phone_number.rb
 - lib/whatsapp_sdk/resource/url.rb
+- tmp/whatsapp.png
 - whatsapp_sdk.gemspec
 homepage: https://github.com/ignacio-chiazzo/whatsapp_sdk
 licenses:
@@ -140,6 +159,7 @@ metadata:
   homepage_uri: https://github.com/ignacio-chiazzo/whatsapp_sdk
   source_code_uri: https://github.com/ignacio-chiazzo/whatsapp_sdk
   changelog_uri: https://github.com/ignacio-chiazzo/whatsapp_sdk/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []
 require_paths: