whatsapp_sdk 0.0.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f270a981b63f318f63b07d8d7812e27a925ce5b96e8b46cec457b11647d531e2
-  data.tar.gz: ca9c1316ae6e4df8c01e809bee3693512cafba6840aff6b1ff6d471acc75b63c
+  metadata.gz: f68cc009fe9fd27e79ac8e7f1a128204c66a565f055bce04bf4338f63ccb4f63
+  data.tar.gz: 49c4b5891624196c2557166cce8587e645a12e16716ccbc216c19f048cf2ab41
 SHA512:
-  metadata.gz: 9dd7789b53c1c5b570698a4b03da3726acc899330aa2b123625ef833c410e1d21abe1ed35415abbcd79626b5698b80e64d71dfc98212a4cb4325ddbc555b729a
-  data.tar.gz: adb2fd6df0007660d4e88edc455cc3bf540407820212b4b7b6c7a7d5303da654430e8b29a7bc805e350bdb334e87d72a6d13c0b15c7408ecd094f4450b915a9f
+  metadata.gz: 91204e0864c369777ff18f63c95f846acbcfa6248ed52fa0db6d05f43784be704e124edffcc73f4d3e0d565269b1784058ede119bdd862d067f75a49550d67df
+  data.tar.gz: 606a0b4ab9601388c2c737e47306cbc2432ef763efd82a869dd92be7d23d8fc2a6877573f1db5119b20ff8135523469a47ed02e2f75f857f33b238b6e7e23be5

data/.rubocop.yml

@@ -1,3 +1,6 @@
+AllCops:
+  NewCops: enable
+
 Style/StringLiterals:
   Enabled: false
 
@@ -11,7 +14,10 @@ Layout/LineLength:
   Max: 120
 
 Metrics/MethodLength:
-  Max: 30
+  Max: 40
+
+Naming/VariableNumber:
+  Enabled: false
 
 Metrics/ClassLength:
   Enabled: false
@@ -21,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

@@ -0,0 +1,18 @@
+# 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.
+- Added Media resource.
+- Added Component and ParameterObject resource.
+- Fixed bug in recipient_number in Messages API.
+
+# v 0.0.2
+- Implement read message.
+- Implement Yard doc.

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

@@ -8,7 +8,7 @@ Send stickers, messages, audio, videos, locations or just ask for the phone numb
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'ruby-whatsapp-sdk'
+gem 'whatsapp_sdk'
 ```
 
 And then execute:
@@ -17,7 +17,7 @@ And then execute:
 
 Or install it yourself as:
 
-    $ gem install ruby-whatsapp-sdk
+    $ gem install whatsapp_sdk
 
 ## Quick Start
 
@@ -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**
@@ -117,98 +140,85 @@ messages_api.send_sticker(sender_id: 123123, recipient_number: "56789", sticker_
 ```
 
 **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.
+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.
 
 ```ruby
 contacts = [create_contact(params)]
 messages_api.send_contacts(sender_id: 123123, recipient_number: "56789", contacts: contacts)
 ```
 
-## Example
-
-<details><summary>Example in a single file. </summary>
-    
-1) Copy this code into a file and save it `example.rb`
-2) Replace the `ACCESS_TOKEN` constant with a valid `access_token`. 
-3) Run the file with the command `ruby example.rb`
-
+Alernative, you could pass a plain json like this:
 ```ruby
-# frozen_string_literal: true
-
-require 'bundler/inline'
-
-gemfile(true) do
-  source 'https://rubygems.org'
-
-  git_source(:github) { |repo| "https://github.com/#{repo}.git" }
+messages_api.send_contacts(sender_id: 123123, recipient_number: "56789", contacts_json: {...})
+```
 
-  gem "whatsapp_sdk", path: "/Users/ignaciochiazzo/src/whatsapp_sdk"
-  gem "pry"
-  gem "pry-nav"
-end
+**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.
 
-require 'whatsapp_sdk'
-require "pry"
-require "pry-nav"
+**Before sending a message template, you need to create one.** visit the [Official API Documentation](https://developers.facebook.com/docs/whatsapp/cloud-api/guides/send-message-templates)
 
-ACCESS_TOKEN = "12345" # replace this with a valid access_token
-SENDER_ID = 107878721936019
-RECEIPIENT_NUMBER = "1234"
+<details> <summary>Component's example</summary>
 
-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)
-
-phone_numbers_api.registered_number("107878721936019")
-phone_numbers_api.registered_numbers("114503234599312") 
-
-messages_api.send_text(sender_id: SENDER_ID, recipient_number: RECEIPIENT_NUMBER, message: "hola")
-messages_api.send_location(
-  sender_id: SENDER_ID, recipient_number: RECEIPIENT_NUMBER, 
-  longitude: 45.4215, latitude: 75.6972, name: "nacho", address: "141 cooper street"
+```ruby
+currency = WhatsappSdk::Resource::Currency.new(code: "USD", amount: 1000, fallback_value: "1000")
+date_time = WhatsappSdk::Resource::DateTime.new(fallback_value: "2020-01-01T00:00:00Z")
+image = WhatsappSdk::Resource::Media.new(type: "image", link: "http(s)://URL")
+
+parameter_image = WhatsappSdk::Resource::ParameterObject.new(type: "image", image: image)
+parameter_text = WhatsappSdk::Resource::ParameterObject.new(type: "text", text: "TEXT_STRING")
+parameter_currency = WhatsappSdk::Resource::ParameterObject.new(type: "currency", currency: currency)
+parameter_date_time = WhatsappSdk::Resource::ParameterObject.new(type: "date_time", date_time: date_time)
+
+header_component = WhatsappSdk::Resource::Component.new(
+  type: WhatsappSdk::Resource::Component::Type::HEADER,
+  parameters: [parameter_image]
 )
 
-# Send images
+body_component = WhatsappSdk::Resource::Component.new(
+  type: WhatsappSdk::Resource::Component::Type::BODY,
+  parameters: [parameter_text, parameter_currency, parameter_date_time]
+)
 
-## with a link 
-messages_api.send_image(
-  sender_id: SENDER_ID, recipient_number: RECEIPIENT_NUMBER, link: "image_link", caption: "Ignacio Chiazzo Profile"
+button_component1 = 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")
+  ]
 )
 
-## with an image id 
-messages_api.send_image(
-  sender_id: SENDER_ID, recipient_number: RECEIPIENT_NUMBER, image_id: "1234", caption: "Ignacio Chiazzo Profile"
+button_component2 = 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")
+  ]
 )
+@messages_api.send_template(sender_id: 12_345, recipient_number: "12345678", name: "hello_world", language: "en_US", components_json: [component_1])
+```
 
-# Send audios
-## with a link 
-messages_api.send_audio(sender_id: SENDER_ID, recipient_number: RECEIPIENT_NUMBER, link: "audio_link")
+</details>
 
-## with an audio id 
-messages_api.send_audio(sender_id: SENDER_ID, recipient_number: RECEIPIENT_NUMBER, audio_id: "1234")
+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 documents
-## with a link 
-messages_api.send_document(
-  sender_id: SENDER_ID, recipient_number: RECEIPIENT_NUMBER, link: "document_link", caption: "Ignacio Chiazzo"
-)
+## Example
 
-## with a document id 
-messages_api.send_document(
-  sender_id: SENDER_ID, recipient_number: RECEIPIENT_NUMBER, document_id: "1234", caption: "Ignacio Chiazzo"
-)
+Visit [the example file](/example.rb) with examples to call the API in a single file.
 
-# send stickers
-## with a link 
-messages_api.send_sticker(sender_id: SENDER_ID, recipient_number: RECEIPIENT_NUMBER, link: "link")
 
-## with a sticker_id
-messages_api.send_sticker(sender_id: SENDER_ID, recipient_number: RECEIPIENT_NUMBER, sticker_id: "1234")
-binding.pry
+## Whatsapp Cloud API
 
-```
-</details>
+- 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
 

data/example.rb

@@ -0,0 +1,200 @@
+# frozen_string_literal: true
+
+# 1) Copy this code into a file and save it `example.rb`
+# 2) Replace the `ACCESS_TOKEN` constant with a valid `access_token`.
+# 3) Run the file with the command `ruby example.rb`
+
+require 'bundler/inline'
+
+gemfile(true) do
+  source 'https://rubygems.org'
+
+  git_source(:github) { |repo| "https://github.com/#{repo}.git" }
+
+  gem "whatsapp_sdk", github: "ignacio-chiazzo/whatsapp_sdk", branch: "main"
+  gem "pry"
+  gem "pry-nav"
+end
+
+require 'whatsapp_sdk'
+require "pry"
+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>"
+
+################# 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)
+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 ##############################
+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 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: -75.6898604, latitude: 45.4192206, name: "Ignacio", address: "My house"
+)
+print_message_sent(location_sent)
+
+######### 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)
+
+# Send an image with an id
+messages_api.send_image(
+  sender_id: SENDER_ID, recipient_number: RECIPIENT_NUMBER, image_id: media.id, caption: "Ignacio Chiazzo Profile"
+)
+
+######### SEND AUDIOS
+## with a 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")
+
+######### SEND DOCUMENTS
+## with a link
+# 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"
+# )
+
+######### SEND STICKERS
+## with a 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")
+
+######### SEND A TEMPLATE
+# Note: The template must have been created previously.
+
+# 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.0.1"
+  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