RubyGems - kapso-client-ruby - Versions diffs - 1.0.1 → 1.0.2 - Mend

kapso-client-ruby 1.0.1 → 1.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (47) hide show

checksums.yaml +4 -4
data/.rubocop.yml +81 -81
data/CHANGELOG.md +262 -91
data/Gemfile +20 -20
data/RAILS_INTEGRATION.md +477 -477
data/README.md +1053 -752
data/Rakefile +40 -40
data/TEMPLATE_TOOLS_GUIDE.md +120 -120
data/WHATSAPP_24_HOUR_GUIDE.md +133 -133
data/examples/advanced_features.rb +352 -349
data/examples/advanced_messaging.rb +241 -0
data/examples/basic_messaging.rb +139 -136
data/examples/enhanced_interactive.rb +400 -0
data/examples/flows_usage.rb +307 -0
data/examples/interactive_messages.rb +343 -0
data/examples/media_management.rb +256 -253
data/examples/rails/jobs.rb +387 -387
data/examples/rails/models.rb +239 -239
data/examples/rails/notifications_controller.rb +226 -226
data/examples/template_management.rb +393 -390
data/kapso-ruby-logo.jpg +0 -0
data/lib/kapso_client_ruby/client.rb +321 -316
data/lib/kapso_client_ruby/errors.rb +348 -329
data/lib/kapso_client_ruby/rails/generators/install_generator.rb +75 -75
data/lib/kapso_client_ruby/rails/generators/templates/env.erb +20 -20
data/lib/kapso_client_ruby/rails/generators/templates/initializer.rb.erb +32 -32
data/lib/kapso_client_ruby/rails/generators/templates/message_service.rb.erb +137 -137
data/lib/kapso_client_ruby/rails/generators/templates/webhook_controller.rb.erb +61 -61
data/lib/kapso_client_ruby/rails/railtie.rb +54 -54
data/lib/kapso_client_ruby/rails/service.rb +188 -188
data/lib/kapso_client_ruby/rails/tasks.rake +166 -166
data/lib/kapso_client_ruby/resources/calls.rb +172 -172
data/lib/kapso_client_ruby/resources/contacts.rb +190 -190
data/lib/kapso_client_ruby/resources/conversations.rb +103 -103
data/lib/kapso_client_ruby/resources/flows.rb +382 -0
data/lib/kapso_client_ruby/resources/media.rb +205 -205
data/lib/kapso_client_ruby/resources/messages.rb +760 -380
data/lib/kapso_client_ruby/resources/phone_numbers.rb +85 -85
data/lib/kapso_client_ruby/resources/templates.rb +283 -283
data/lib/kapso_client_ruby/types.rb +348 -262
data/lib/kapso_client_ruby/version.rb +5 -5
data/lib/kapso_client_ruby.rb +75 -74
data/scripts/.env.example +17 -17
data/scripts/kapso_template_finder.rb +91 -91
data/scripts/sdk_setup.rb +404 -404
data/scripts/test.rb +60 -60
metadata +12 -3

data/lib/kapso_client_ruby/resources/calls.rb CHANGED Viewed

@@ -1,173 +1,173 @@
-# frozen_string_literal: true
-module KapsoClientRuby
-  module Resources
-    class Calls
-      def initialize(client)
-        @client = client
-      end
-      # Initiate a call
-      def connect(phone_number_id:, to:, session: nil, biz_opaque_callback_data: nil)
-        payload = {
-          messaging_product: 'whatsapp',
-          to: to,
-          action: 'connect'
-        }
-        payload[:session] = session if session
-        payload[:biz_opaque_callback_data] = biz_opaque_callback_data if biz_opaque_callback_data
-        response = @client.request(:post, "#{phone_number_id}/calls",
-                                   body: payload.to_json, response_type: :json)
-        Types::CallConnectResponse.new(response)
-      end
-      # Pre-accept a call
-      def pre_accept(phone_number_id:, call_id:, session:)
-        raise ArgumentError, 'call_id cannot be empty' if call_id.nil? || call_id.strip.empty?
-        raise ArgumentError, 'session cannot be nil' if session.nil?
-        payload = {
-          messaging_product: 'whatsapp',
-          call_id: call_id,
-          action: 'pre_accept',
-          session: session
-        }
-        response = @client.request(:post, "#{phone_number_id}/calls",
-                                   body: payload.to_json, response_type: :json)
-        Types::CallActionResponse.new(response)
-      end
-      # Accept a call
-      def accept(phone_number_id:, call_id:, session:, biz_opaque_callback_data: nil)
-        raise ArgumentError, 'call_id cannot be empty' if call_id.nil? || call_id.strip.empty?
-        raise ArgumentError, 'session cannot be nil' if session.nil?
-        payload = {
-          messaging_product: 'whatsapp',
-          call_id: call_id,
-          action: 'accept',
-          session: session
-        }
-        payload[:biz_opaque_callback_data] = biz_opaque_callback_data if biz_opaque_callback_data
-        response = @client.request(:post, "#{phone_number_id}/calls",
-                                   body: payload.to_json, response_type: :json)
-        Types::CallActionResponse.new(response)
-      end
-      # Reject a call
-      def reject(phone_number_id:, call_id:)
-        raise ArgumentError, 'call_id cannot be empty' if call_id.nil? || call_id.strip.empty?
-        payload = {
-          messaging_product: 'whatsapp',
-          call_id: call_id,
-          action: 'reject'
-        }
-        response = @client.request(:post, "#{phone_number_id}/calls",
-                                   body: payload.to_json, response_type: :json)
-        Types::CallActionResponse.new(response)
-      end
-      # Terminate a call
-      def terminate(phone_number_id:, call_id:)
-        raise ArgumentError, 'call_id cannot be empty' if call_id.nil? || call_id.strip.empty?
-        payload = {
-          messaging_product: 'whatsapp',
-          call_id: call_id,
-          action: 'terminate'
-        }
-        response = @client.request(:post, "#{phone_number_id}/calls",
-                                   body: payload.to_json, response_type: :json)
-        Types::CallActionResponse.new(response)
-      end
-      # List calls (Kapso Proxy only)
-      def list(phone_number_id:, direction: nil, status: nil, since: nil,
-               until_time: nil, call_id: nil, limit: nil, after: nil,
-               before: nil, fields: nil)
-        assert_kapso_proxy('Call history API')
-        query_params = {
-          direction: direction,
-          status: status,
-          since: since,
-          until: until_time,
-          call_id: call_id,
-          limit: limit,
-          after: after,
-          before: before,
-          fields: fields
-        }.compact
-        response = @client.request(:get, "#{phone_number_id}/calls",
-                                   query: query_params, response_type: :json)
-        Types::PagedResponse.new(response, Types::CallRecord)
-      end
-      # Get call details (Kapso Proxy only)
-      def get(phone_number_id:, call_id:, fields: nil)
-        assert_kapso_proxy('Call details API')
-        query_params = {}
-        query_params[:fields] = fields if fields
-        response = @client.request(:get, "#{phone_number_id}/calls/#{call_id}",
-                                   query: query_params, response_type: :json)
-        Types::CallRecord.new(response)
-      end
-      # Call permissions management
-      class Permissions
-        def initialize(client)
-          @client = client
-        end
-        # Get call permissions
-        def get(phone_number_id:, user_wa_id:)
-          raise ArgumentError, 'user_wa_id cannot be empty' if user_wa_id.nil? || user_wa_id.strip.empty?
-          query_params = { user_wa_id: user_wa_id }
-          response = @client.request(:get, "#{phone_number_id}/call_permissions",
-                                     query: query_params, response_type: :json)
-          response
-        end
-        # Update call permissions
-        def update(phone_number_id:, user_wa_id:, permission:)
-          raise ArgumentError, 'user_wa_id cannot be empty' if user_wa_id.nil? || user_wa_id.strip.empty?
-          raise ArgumentError, 'permission cannot be empty' if permission.nil?
-          payload = {
-            user_wa_id: user_wa_id,
-            permission: permission
-          }
-          response = @client.request(:post, "#{phone_number_id}/call_permissions",
-                                     body: payload.to_json, response_type: :json)
-          Types::GraphSuccessResponse.new(response)
-        end
-      end
-      def permissions
-        @permissions ||= Permissions.new(@client)
-      end
-      private
-      def assert_kapso_proxy(feature)
-        unless @client.kapso_proxy?
-          raise Errors::KapsoProxyRequiredError.new(feature)
-        end
-      end
-    end
-  end
+# frozen_string_literal: true
+module KapsoClientRuby
+  module Resources
+    class Calls
+      def initialize(client)
+        @client = client
+      end
+      # Initiate a call
+      def connect(phone_number_id:, to:, session: nil, biz_opaque_callback_data: nil)
+        payload = {
+          messaging_product: 'whatsapp',
+          to: to,
+          action: 'connect'
+        }
+        payload[:session] = session if session
+        payload[:biz_opaque_callback_data] = biz_opaque_callback_data if biz_opaque_callback_data
+        response = @client.request(:post, "#{phone_number_id}/calls",
+                                   body: payload.to_json, response_type: :json)
+        Types::CallConnectResponse.new(response)
+      end
+      # Pre-accept a call
+      def pre_accept(phone_number_id:, call_id:, session:)
+        raise ArgumentError, 'call_id cannot be empty' if call_id.nil? || call_id.strip.empty?
+        raise ArgumentError, 'session cannot be nil' if session.nil?
+        payload = {
+          messaging_product: 'whatsapp',
+          call_id: call_id,
+          action: 'pre_accept',
+          session: session
+        }
+        response = @client.request(:post, "#{phone_number_id}/calls",
+                                   body: payload.to_json, response_type: :json)
+        Types::CallActionResponse.new(response)
+      end
+      # Accept a call
+      def accept(phone_number_id:, call_id:, session:, biz_opaque_callback_data: nil)
+        raise ArgumentError, 'call_id cannot be empty' if call_id.nil? || call_id.strip.empty?
+        raise ArgumentError, 'session cannot be nil' if session.nil?
+        payload = {
+          messaging_product: 'whatsapp',
+          call_id: call_id,
+          action: 'accept',
+          session: session
+        }
+        payload[:biz_opaque_callback_data] = biz_opaque_callback_data if biz_opaque_callback_data
+        response = @client.request(:post, "#{phone_number_id}/calls",
+                                   body: payload.to_json, response_type: :json)
+        Types::CallActionResponse.new(response)
+      end
+      # Reject a call
+      def reject(phone_number_id:, call_id:)
+        raise ArgumentError, 'call_id cannot be empty' if call_id.nil? || call_id.strip.empty?
+        payload = {
+          messaging_product: 'whatsapp',
+          call_id: call_id,
+          action: 'reject'
+        }
+        response = @client.request(:post, "#{phone_number_id}/calls",
+                                   body: payload.to_json, response_type: :json)
+        Types::CallActionResponse.new(response)
+      end
+      # Terminate a call
+      def terminate(phone_number_id:, call_id:)
+        raise ArgumentError, 'call_id cannot be empty' if call_id.nil? || call_id.strip.empty?
+        payload = {
+          messaging_product: 'whatsapp',
+          call_id: call_id,
+          action: 'terminate'
+        }
+        response = @client.request(:post, "#{phone_number_id}/calls",
+                                   body: payload.to_json, response_type: :json)
+        Types::CallActionResponse.new(response)
+      end
+      # List calls (Kapso Proxy only)
+      def list(phone_number_id:, direction: nil, status: nil, since: nil,
+               until_time: nil, call_id: nil, limit: nil, after: nil,
+               before: nil, fields: nil)
+        assert_kapso_proxy('Call history API')
+        query_params = {
+          direction: direction,
+          status: status,
+          since: since,
+          until: until_time,
+          call_id: call_id,
+          limit: limit,
+          after: after,
+          before: before,
+          fields: fields
+        }.compact
+        response = @client.request(:get, "#{phone_number_id}/calls",
+                                   query: query_params, response_type: :json)
+        Types::PagedResponse.new(response, Types::CallRecord)
+      end
+      # Get call details (Kapso Proxy only)
+      def get(phone_number_id:, call_id:, fields: nil)
+        assert_kapso_proxy('Call details API')
+        query_params = {}
+        query_params[:fields] = fields if fields
+        response = @client.request(:get, "#{phone_number_id}/calls/#{call_id}",
+                                   query: query_params, response_type: :json)
+        Types::CallRecord.new(response)
+      end
+      # Call permissions management
+      class Permissions
+        def initialize(client)
+          @client = client
+        end
+        # Get call permissions
+        def get(phone_number_id:, user_wa_id:)
+          raise ArgumentError, 'user_wa_id cannot be empty' if user_wa_id.nil? || user_wa_id.strip.empty?
+          query_params = { user_wa_id: user_wa_id }
+          response = @client.request(:get, "#{phone_number_id}/call_permissions",
+                                     query: query_params, response_type: :json)
+          response
+        end
+        # Update call permissions
+        def update(phone_number_id:, user_wa_id:, permission:)
+          raise ArgumentError, 'user_wa_id cannot be empty' if user_wa_id.nil? || user_wa_id.strip.empty?
+          raise ArgumentError, 'permission cannot be empty' if permission.nil?
+          payload = {
+            user_wa_id: user_wa_id,
+            permission: permission
+          }
+          response = @client.request(:post, "#{phone_number_id}/call_permissions",
+                                     body: payload.to_json, response_type: :json)
+          Types::GraphSuccessResponse.new(response)
+        end
+      end
+      def permissions
+        @permissions ||= Permissions.new(@client)
+      end
+      private
+      def assert_kapso_proxy(feature)
+        unless @client.kapso_proxy?
+          raise Errors::KapsoProxyRequiredError.new(feature)
+        end
+      end
+    end
+  end
 end