whatsapp_sdk 0.9.2 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: acff9c2aa69b398017bced8fbbf81d3d82eb4088f91b2dda24e3638da6c2240a
-  data.tar.gz: '0269bed60b15e5c8f1f1e4057f7683f5fe2ea8d931549390037f040530f125ad'
+  metadata.gz: 3afc828e9c913c0aa1988b1ec75dcbd6453f13f67d46f3a25c77ef2558aacf8c
+  data.tar.gz: 64d8ea9e6c36c6d37c8dad014ee1dab10d906df4dcb7777206f6fc7300af44b6
 SHA512:
-  metadata.gz: 70225a9c4b03a4c80e5c300d04eb61b8db45e0933a3aaef35fee71562c021adf80e33e3917b5439946b1d5690820ed4348e108f95692a8e614b221a7010761a1
-  data.tar.gz: b0ce380977fc51bf9f79f5fdd40c75ae533239ee78e40a15081b9f9bc19c827b94399373d979b82ad940fd9ac0a3d1ad4b3493ce27ae6f021e4df04d7c834d66
+  metadata.gz: 4c4e910413ddf8366abd12b1aaed78e8a47d69b1cc979f7afaae00fc644ff9f735f6c1f594749de242fc87c70f6c2c7c9ccf6c215c2e85bda40f0f6540fc3a55
+  data.tar.gz: 5a2bac9b5b4f416af7abbfbdf07c91717b517f7c030fcb47c767c4d2863c538e2b03402ff3a0968b7a889b4748f3c5a14d1e4b75f1cbc75f238a1888d5cc78d1

data/CHANGELOG.md

@@ -1,4 +1,14 @@
-# Unreleased 
+# Unreleased
+
+# v 0.11.0
+- Bumped API version to v19. @paulomcnally  https://github.com/ignacio-chiazzo/ruby_whatsapp_sdk/pull/116
+
+# v 0.10.0
+- Implement Templates API @emersonu, @ignacio-chiazzo [#90](https://github.com/ignacio-chiazzo/ruby_whatsapp_sdk/pull/90)
+- Using compatible Gem versions instead of fixed dependency versions @nbluis [#108](https://github.com/ignacio-chiazzo/ruby_whatsapp_sdk/pull/108)
+- [Breaking Change] Rename `error` module with `errors`. @ignacio-chiazzo [#101](https://github.com/ignacio-chiazzo/ruby_whatsapp_sdk/pull/101)
+
+If you are calling an error using `WhatsappSdk::Resource::Error`, you should update it to `WhatsappSdk::Resource::Errors`, e.g. `WhatsappSdk::Resource::Errors::MissingArgumentError`
 
 # v 0.9.2
 - Add Support to image/webp sticker media. @renatovico [#94](https://github.com/ignacio-chiazzo/ruby_whatsapp_sdk/issues/94)

data/Gemfile

@@ -5,12 +5,6 @@ source "https://rubygems.org"
 
 git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
 
-gem("faraday")
-gem("faraday-multipart")
-gem("rake", ">= 12.3.3")
-gem('sorbet-runtime')
-gem("zeitwerk", ">= 2.6.0")
-
 group(:test) do
   gem('mocha')
   gem('rubocop', require: false)

data/Gemfile.lock

@@ -1,11 +1,11 @@
 PATH
   remote: .
   specs:
-    whatsapp_sdk (0.9.1)
-      faraday (~> 2.3.0)
-      faraday-multipart (~> 1.0.4)
-      sorbet-runtime (~> 0.5.1)
-      zeitwerk (~> 2.6.0)
+    whatsapp_sdk (0.11.0)
+      faraday (~> 2)
+      faraday-multipart (~> 1)
+      sorbet-runtime (~> 0.5)
+      zeitwerk (~> 2)
 
 GEM
   remote: https://rubygems.org/
@@ -13,21 +13,23 @@ GEM
     addressable (2.8.1)
       public_suffix (>= 2.0.2, < 6.0)
     ast (2.4.2)
+    base64 (0.2.0)
     coderay (1.1.3)
     crack (0.4.5)
       rexml
     diff-lcs (1.5.0)
-    faraday (2.3.0)
-      faraday-net_http (~> 2.0)
+    faraday (2.7.12)
+      base64
+      faraday-net_http (>= 2.0, < 3.1)
       ruby2_keywords (>= 0.0.4)
     faraday-multipart (1.0.4)
       multipart-post (~> 2)
-    faraday-net_http (2.1.0)
+    faraday-net_http (3.0.2)
     hashdiff (1.0.1)
     method_source (1.0.0)
     minitest (5.16.1)
     mocha (1.14.0)
-    multipart-post (2.2.3)
+    multipart-post (2.3.0)
     netrc (0.11.0)
     parallel (1.22.1)
     parser (3.1.2.0)
@@ -39,7 +41,7 @@ GEM
       pry (>= 0.9.10, < 0.15)
     public_suffix (5.0.0)
     rainbow (3.1.1)
-    rake (13.0.6)
+    rake (12.3.3)
     rbi (0.0.15)
       ast
       parser (>= 2.6.4.0)
@@ -70,6 +72,7 @@ GEM
     sorbet (0.5.10346)
       sorbet-static (= 0.5.10346)
     sorbet-runtime (0.5.10346)
+    sorbet-static (0.5.10346-universal-darwin-19)
     sorbet-static (0.5.10346-universal-darwin-21)
     sorbet-static (0.5.10346-x86_64-linux)
     sorbet-static-and-runtime (0.5.10346)
@@ -104,33 +107,30 @@ GEM
     yard-sorbet (0.7.0)
       sorbet-runtime (>= 0.5)
       yard (>= 0.9)
-    zeitwerk (2.6.0)
+    zeitwerk (2.6.12)
 
 PLATFORMS
   arm64-darwin-21
+  x86_64-darwin-19
   x86_64-darwin-21
   x86_64-linux
 
 DEPENDENCIES
   bundler (~> 2.3)
-  faraday
-  faraday-multipart
   minitest (~> 5.0)
   mocha
   pry
   pry-nav
-  rake (>= 12.3.3)
+  rake (~> 12.3)
   rubocop
   rubocop-minitest
   rubocop-performance
   rubocop-sorbet
   sorbet
-  sorbet-runtime
   spoom
   tapioca
   webmock
   whatsapp_sdk!
-  zeitwerk (>= 2.6.0)
 
 BUNDLED WITH
    2.3.22

data/README.md

@@ -124,12 +124,31 @@ messages_api = WhatsappSdk::Api::Messages.new
 phone_numbers_api = WhatsappSdk::Api::PhoneNumbers.new
 medias_api = WhatsappSdk::Api::Medias.new
 business_profile_api = WhatsappSdk::Api::BusinessProfile.new
+templates_api = WhatsappSdk::Api::Templates.new
 ```
 
 Note: Remember to initialize the client first!
 
 ## APIs
 
+### Templates
+<details>
+
+```ruby
+# Get list of templates
+templates_api.templates(business_id: BUSINESS_ID)
+
+# Create a template
+new_template = templates_api.create(
+  business_id: BUSINESS_ID, name: "seasonal_promotion", language: "en_US", category: "MARKETING",
+  components_json: components_json, allow_category_change: true
+) 
+
+# Delete a template
+templates_api.delete(business_id: BUSINESS_ID, name: "my_name") # delete by name
+```
+</details>
+
 ### Business Profile API
 <details>
 

data/example.rb

@@ -48,10 +48,76 @@ def print_message_sent(message_response)
 end
 ##################################################
 
+
 medias_api = WhatsappSdk::Api::Medias.new
 messages_api = WhatsappSdk::Api::Messages.new
 phone_numbers_api = WhatsappSdk::Api::PhoneNumbers.new
 business_profile_api = WhatsappSdk::Api::BusinessProfile.new
+templates_api = WhatsappSdk::Api::Templates.new
+
+############################## Templates API ##############################
+
+## Get list of templates
+templates_api.templates(business_id: BUSINESS_ID)
+
+## Get message templates namespace
+templates_api.get_message_template_namespace(business_id: BUSINESS_ID)
+
+# Create a template
+components_json = [
+  {
+    "type": "BODY",
+    "text": "Thank you for your order, {{1}}! Your confirmation number is {{2}}. If you have any questions, please use the buttons below to contact support. Thank you for being a customer!",
+    "example": {
+      "body_text": [
+        [
+          "Ignacio","860198-230332"
+        ]
+      ]
+    }
+  },
+  {
+    "type": "BUTTONS",
+    "buttons": [
+      {
+        "type": "PHONE_NUMBER",
+        "text": "Call",
+        "phone_number": "59898400766"
+      },
+      {
+        "type": "URL",
+        "text": "Contact Support",
+        "url": "https://www.luckyshrub.com/support"
+      }
+    ]
+  }
+]
+
+new_template = templates_api.create(
+  business_id: BUSINESS_ID, name: "seasonal_promotion", language: "ka", category: "MARKETING",
+  components_json: components_json, allow_category_change: true
+)
+
+# Update a template
+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"
+        }
+      }
+    ]
+  }
+]
+templates_api.update(template_id: "1624560287967996", category: "UTILITY")
+
+## Delete a template
+templates_api.delete(business_id: BUSINESS_ID, name: "seasonal_promotion") # delete by name
+# templates_api.delete(business_id: BUSINESS_ID, name: "name2", hsm_id: "243213188351928") # delete by name and id
+
 ############################## Business API ##############################
 business_profile = business_profile_api.details(SENDER_ID)
 business_profile_api.update(phone_number_id: SENDER_ID, params: { about: "A very cool business" } )
@@ -107,7 +173,7 @@ 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 
+######### 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)

data/lib/whatsapp_sdk/api/api_configuration.rb

@@ -6,7 +6,7 @@ module WhatsappSdk
     module ApiConfiguration
       extend T::Sig
 
-      API_VERSION = T.let("v16.0", String)
+      API_VERSION = T.let("v19.0", String)
       API_URL = T.let("https://graph.facebook.com/#{API_VERSION}/", String)
     end
   end

data/lib/whatsapp_sdk/api/business_profile.rb

@@ -12,17 +12,17 @@ module WhatsappSdk
       # Get the details of business profile.
       #
       # @param phone_number_id [Integer] Phone Number Id.
-      # @return [WhatsappSdk::Api::Response] Response object.
-      sig { params(phone_number_id: Integer).returns(WhatsappSdk::Api::Response) }
+      # @return [Api::Response] Response object.
+      sig { params(phone_number_id: Integer).returns(Api::Response) }
       def details(phone_number_id)
         response = send_request(
           http_method: "get",
           endpoint: "#{phone_number_id}/whatsapp_business_profile?fields=#{DEFAULT_FIELDS}"
         )
 
-        WhatsappSdk::Api::Response.new(
+        Api::Response.new(
           response: response,
-          data_class_type: WhatsappSdk::Api::Responses::BusinessProfileDataResponse
+          data_class_type: Api::Responses::BusinessProfileDataResponse
         )
       end
 
@@ -30,11 +30,11 @@ module WhatsappSdk
       #
       # @param phone_number_id [Integer] Phone Number Id.
       # @param params [Hash] Params to update.
-      # @return [WhatsappSdk::Api::Response] Response object.
+      # @return [Api::Response] Response object.
       sig do
         params(
           phone_number_id: Integer, params: T::Hash[T.untyped, T.untyped]
-        ).returns(WhatsappSdk::Api::Response)
+        ).returns(Api::Response)
       end
       def update(phone_number_id:, params:)
         # this is a required field
@@ -46,9 +46,9 @@ module WhatsappSdk
           params: params
         )
 
-        WhatsappSdk::Api::Response.new(
+        Api::Response.new(
           response: response,
-          data_class_type: WhatsappSdk::Api::Responses::SuccessResponse
+          data_class_type: Api::Responses::SuccessResponse
         )
       end
     end

data/lib/whatsapp_sdk/api/medias.rb

@@ -46,17 +46,17 @@ module WhatsappSdk
       # Get Media by ID.
       #
       # @param media_id [String] Media Id.
-      # @return [WhatsappSdk::Api::Response] Response object.
-      sig { params(media_id: String).returns(WhatsappSdk::Api::Response) }
+      # @return [Api::Response] Response object.
+      sig { params(media_id: String).returns(Api::Response) }
       def media(media_id:)
         response = send_request(
           http_method: "get",
           endpoint: "/#{media_id}"
         )
 
-        WhatsappSdk::Api::Response.new(
+        Api::Response.new(
           response: response,
-          data_class_type: WhatsappSdk::Api::Responses::MediaDataResponse
+          data_class_type: Api::Responses::MediaDataResponse
         )
       end
 
@@ -66,8 +66,8 @@ module WhatsappSdk
       # @param file_path [String] The file_path to download the media e.g. "tmp/downloaded_image.png".
       # @param media_type [String] The media type e.g. "audio/mp4". See the supported types in the official
       #  documentation https://developers.facebook.com/docs/whatsapp/cloud-api/reference/media#supported-media-types.
-      # @return [WhatsappSdk::Api::Response] Response object.
-      sig { params(url: String, file_path: String, media_type: String).returns(WhatsappSdk::Api::Response) }
+      # @return [Api::Response] Response object.
+      sig { params(url: String, file_path: String, media_type: String).returns(Api::Response) }
       def download(url:, file_path:, media_type:)
         raise InvalidMediaTypeError.new(media_type: media_type) unless valid_media_type?(media_type)
 
@@ -80,10 +80,10 @@ module WhatsappSdk
                      { "error" => true, "status" => response.code }
                    end
 
-        WhatsappSdk::Api::Response.new(
+        Api::Response.new(
           response: response,
-          data_class_type: WhatsappSdk::Api::Responses::SuccessResponse,
-          error_class_type: WhatsappSdk::Api::Responses::ErrorResponse
+          data_class_type: Api::Responses::SuccessResponse,
+          error_class_type: Api::Responses::ErrorResponse
         )
       end
 
@@ -93,8 +93,8 @@ module WhatsappSdk
       # @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.
-      sig { params(sender_id: Integer, file_path: String, type: String).returns(WhatsappSdk::Api::Response) }
+      # @return [Api::Response] Response object.
+      sig { params(sender_id: Integer, file_path: String, type: String).returns(Api::Response) }
       def upload(sender_id:, file_path:, type:)
         raise FileNotFoundError.new(file_path: file_path) unless File.file?(file_path)
 
@@ -106,26 +106,26 @@ module WhatsappSdk
 
         response = send_request(http_method: "post", endpoint: "#{sender_id}/media", params: params)
 
-        WhatsappSdk::Api::Response.new(
+        Api::Response.new(
           response: response,
-          data_class_type: WhatsappSdk::Api::Responses::MediaDataResponse
+          data_class_type: Api::Responses::MediaDataResponse
         )
       end
 
       # Delete a Media by ID.
       #
       # @param media_id [String] Media Id.
-      # @return [WhatsappSdk::Api::Response] Response object.
-      sig { params(media_id: String).returns(WhatsappSdk::Api::Response) }
+      # @return [Api::Response] Response object.
+      sig { params(media_id: String).returns(Api::Response) }
       def delete(media_id:)
         response = send_request(
           http_method: "delete",
           endpoint: "/#{media_id}"
         )
 
-        WhatsappSdk::Api::Response.new(
+        Api::Response.new(
           response: response,
-          data_class_type: WhatsappSdk::Api::Responses::SuccessResponse
+          data_class_type: Api::Responses::SuccessResponse
         )
       end
 
@@ -140,7 +140,7 @@ module WhatsappSdk
       end
 
       def valid_media_type?(media_type)
-        WhatsappSdk::Resource::MediaTypes::SUPPORTED_MEDIA_TYPES.include?(media_type)
+        Resource::MediaTypes::SUPPORTED_MEDIA_TYPES.include?(media_type)
       end
     end
   end