vonage 7.26.0 → 7.27.1

data/lib/vonage/proactive_connect/item.rb

@@ -13,6 +13,8 @@ module Vonage
 
     # Create a list item
     #
+    # @deprecated
+    #
     # @example
     #   response = proactive_connect.item.create(list_id: 'e546eebe-8e23-4e4d-bb7c-29d4700c9865', data: {name: 'Joe Bloggs', email: 'joe@email.com'})
     #
@@ -25,6 +27,7 @@ module Vonage
     # @see https://developer.vonage.com/en/api/proactive-connect#itemsCreate
     #
     def create(list_id:, data:)
+      logger.info('This method is deprecated and will be removed in a future release.')
       raise ArgumentError.new(":data must be a Hash") unless data.is_a? Hash
       request(
         "/v0.1/bulk/lists/#{list_id}/items",
@@ -35,6 +38,8 @@ module Vonage
 
     # Get list item by id
     #
+    # @deprecated
+    #
     # @example
     #   response = proactive_connect.item.find(list_id: 'e546eebe-8e23-4e4d-bb7c-29d4700c9865', item_id: 'd97ebf20-e4de-4e50-921a-7bb4dceb373a')
     #
@@ -47,11 +52,14 @@ module Vonage
     # @see https://developer.vonage.com/en/api/proactive-connect#itemsGet
     #
     def find(list_id:, item_id:)
+      logger.info('This method is deprecated and will be removed in a future release.')
       request("/v0.1/bulk/lists/#{list_id}/items/#{item_id}")
     end
 
     # Update list item
     #
+    # @deprecated
+    #
     # @example
     #   response = proactive_connect.item.create(
     #     list_id: 'e546eebe-8e23-4e4d-bb7c-29d4700c9865',
@@ -73,6 +81,7 @@ module Vonage
     # @see https://developer.vonage.com/en/api/proactive-connect#itemsUpdate
     #
     def update(list_id:, item_id:, data:)
+      logger.info('This method is deprecated and will be removed in a future release.')
       raise ArgumentError.new(":data must be a Hash") unless data.is_a? Hash
       request(
         "/v0.1/bulk/lists/#{list_id}/items/#{item_id}",
@@ -83,6 +92,8 @@ module Vonage
 
     #  Delete list item
     #
+    # @deprecated
+    #
     # @example
     #   response = proactive_connect.item.delete(list_id: 'e546eebe-8e23-4e4d-bb7c-29d4700c9865', item_id: 'd97ebf20-e4de-4e50-921a-7bb4dceb373a')
     #
@@ -95,6 +106,7 @@ module Vonage
     # @see https://developer.vonage.com/en/api/proactive-connect#itemsDelete
     #
     def delete(list_id:, item_id:)
+      logger.info('This method is deprecated and will be removed in a future release.')
       request(
         "/v0.1/bulk/lists/#{list_id}/items/#{item_id}",
         type: Delete

data/lib/vonage/proactive_connect/items.rb

@@ -11,6 +11,8 @@ module Vonage
 
     # Find all list items
     #
+    # @deprecated
+    #
     # @example
     #   response = proactive_connect.items.list(list_id: 'e546eebe-8e23-4e4d-bb7c-29d4700c9865')
     #
@@ -29,6 +31,7 @@ module Vonage
     # @see https://developer.vonage.com/en/api/proactive-connect#itemsFindAll
     #
     def list(list_id:, **params)
+      logger.info('This method is deprecated and will be removed in a future release.')
       path = "/v0.1/bulk/lists/#{list_id}/items"
       path += "?#{Params.encode(params)}" unless params.empty?
 
@@ -37,6 +40,8 @@ module Vonage
 
     # Download list items as a CSV file format
     #
+    # @deprecated
+    #
     # @example
     #   response = proactive_connect.items.download_csv(list_id: 'e546eebe-8e23-4e4d-bb7c-29d4700c9865')
     #
@@ -64,6 +69,7 @@ module Vonage
     # @see https://developer.vonage.com/en/api/proactive-connect#itemsDownload
     #
     def download_csv(list_id:, order: 'asc', **params)
+      logger.info('This method is deprecated and will be removed in a future release.')
       response = request("/v0.1/bulk/lists/#{list_id}/items/download?order=#{order}", response_class: FileResponse)
 
       response.filename = params[:filename] if params[:filename]
@@ -74,6 +80,8 @@ module Vonage
 
     # Import list items from a CSV file
     #
+    # @deprecated
+    #
     # @example
     #   response = proactive_connect.items.upload_csv(list_id: 'e546eebe-8e23-4e4d-bb7c-29d4700c9865', filepath: '/files/import.csv')
     #
@@ -96,6 +104,7 @@ module Vonage
     # @see https://developer.vonage.com/en/api/proactive-connect#itemsImport
     #
     def upload_csv(list_id:, filepath:)
+      logger.info('This method is deprecated and will be removed in a future release.')
       pn = Pathname.new(filepath)
       raise ArgumentError, ':filepath not for a file' unless pn.file?
       raise ArgumentError, 'file at :filepath not readable' unless pn.readable?

data/lib/vonage/proactive_connect/list.rb

@@ -13,6 +13,8 @@ module Vonage
 
     # Create list
     #
+    # @deprecated
+    #
     # @example
     #   response = proactive_connect.list.create(name: 'List Number 1')
     #
@@ -47,6 +49,7 @@ module Vonage
     # @see https://developer.vonage.com/en/api/proactive-connect#listsCreate
     #
     def create(name:, **params)
+      logger.info('This method is deprecated and will be removed in a future release.')
       request(
         "/v0.1/bulk/lists",
         params: params.merge({ name: name }),
@@ -56,6 +59,8 @@ module Vonage
 
     # Get list by id
     #
+    # @deprecated
+    #
     # @example
     #   response = proactive_connect.list.find(id: 'e546eebe-8e23-4e4d-bb7c-29d4700c9865')
     #
@@ -65,11 +70,14 @@ module Vonage
     # @see https://developer.vonage.com/en/api/proactive-connect#listsGet
     #
     def find(id:)
+      logger.info('This method is deprecated and will be removed in a future release.')
       request("/v0.1/bulk/lists/#{id}")
     end
 
     # Update list
     #
+    # @deprecated
+    #
     # @example
     #   response = proactive_connect.list.update(name: 'List Number 1')
     #
@@ -107,6 +115,7 @@ module Vonage
     # @see https://developer.vonage.com/en/api/proactive-connect#listsUpdate
     #
     def update(id:, name:, **params)
+      logger.info('This method is deprecated and will be removed in a future release.')
       request(
         "/v0.1/bulk/lists/#{id}",
         params: params.merge({ name: name }),
@@ -116,6 +125,8 @@ module Vonage
 
     # Delete a list by id
     #
+    # @deprecated
+    #
     # @example
     #   response = proactive_connect.list.delete(id: '74ea1ecf-06c9-4072-a285-61677bd353e8')
     #
@@ -125,6 +136,7 @@ module Vonage
     # @see https://developer.vonage.com/en/api/proactive-connect#listsDelete
     #
     def delete(id:)
+      logger.info('This method is deprecated and will be removed in a future release.')
       request(
         "/v0.1/bulk/lists/#{id}",
         type: Delete
@@ -133,6 +145,8 @@ module Vonage
 
     # Clear list by deleting all items
     #
+    # @deprecated
+    #
     # @example
     #   response = proactive_connect.list.clear_items(id: 'e546eebe-8e23-4e4d-bb7c-29d4700c9865')
     #
@@ -142,6 +156,7 @@ module Vonage
     # @see https://developer.vonage.com/en/api/proactive-connect#listsClear
     #
     def clear_items(id:)
+      logger.info('This method is deprecated and will be removed in a future release.')
       request(
         "/v0.1/bulk/lists/#{id}/clear",
         type: Post
@@ -150,6 +165,8 @@ module Vonage
 
     # Fetch and replace all items from datasource
     #
+    # @deprecated
+    #
     # @example
     #   response = proactive_connect.list.fetch_and_replace_items(id: 'e546eebe-8e23-4e4d-bb7c-29d4700c9865')
     #
@@ -159,6 +176,7 @@ module Vonage
     # @see https://developer.vonage.com/en/api/proactive-connect#listsFetch
     #
     def fetch_and_replace_items(id:)
+      logger.info('This method is deprecated and will be removed in a future release.')
       request(
         "/v0.1/bulk/lists/#{id}/fetch",
         type: Post

data/lib/vonage/proactive_connect/lists.rb

@@ -11,6 +11,8 @@ module Vonage
 
     # Find all lists
     #
+    # @deprecated
+    #
     # @example
     #   response = proactive_connect.lists.list
     #
@@ -26,6 +28,7 @@ module Vonage
     # @see https://developer.vonage.com/en/api/proactive-connect#listsFindAll
     #
     def list(**params)
+      logger.info('This method is deprecated and will be removed in a future release.')
       path = "/v0.1/bulk/lists"
       path += "?#{Params.encode(params)}" unless params.empty?
 

data/lib/vonage/proactive_connect.rb

@@ -5,28 +5,38 @@ module Vonage
   class ProactiveConnect < Namespace
     extend T::Sig
 
+    # @deprecated
     sig { returns(T.nilable(Vonage::ProactiveConnect::Lists)) }
     def lists
+      logger.info('This method is deprecated and will be removed in a future release.')
       @lists ||= Lists.new(@config)
     end
 
+    # @deprecated
     sig { returns(T.nilable(Vonage::ProactiveConnect::List)) }
     def list
+      logger.info('This method is deprecated and will be removed in a future release.')
       @list ||= List.new(@config)
     end
 
+    # @deprecated
     sig { returns(T.nilable(Vonage::ProactiveConnect::Items)) }
     def items
+      logger.info('This method is deprecated and will be removed in a future release.')
       @items ||= Items.new(@config)
     end
 
+    # @deprecated
     sig { returns(T.nilable(Vonage::ProactiveConnect::Item)) }
     def item
+      logger.info('This method is deprecated and will be removed in a future release.')
       @item ||= Item.new(@config)
     end
 
+    # @deprecated
     sig { returns(T.nilable(Vonage::ProactiveConnect::Events)) }
     def events
+      logger.info('This method is deprecated and will be removed in a future release.')
       @events ||= Events.new(@config)
     end
   end

data/lib/vonage/version.rb

@@ -1,5 +1,5 @@
 # typed: strong
 
 module Vonage
-  VERSION = '7.26.0'
+  VERSION = '7.27.1'
 end

data/lib/vonage/voice/actions/connect.rb

@@ -107,9 +107,13 @@ module Vonage
     end
 
     def verify_event_url
-      uri = URI.parse(self.eventUrl)
+      unless self.eventUrl.is_a?(Array) && self.eventUrl.length == 1 && self.eventUrl[0].is_a?(String)
+        raise ClientError.new("Expected 'eventUrl' parameter to be an Array containing a single string item")
+      end
+
+      uri = URI.parse(self.eventUrl[0])
 
-      raise ClientError.new("Invalid 'eventUrl' value, must be a valid URL") unless uri.kind_of?(URI::HTTP) || uri.kind_of?(URI::HTTPS)
+      raise ClientError.new("Invalid 'eventUrl' value, array must contain a valid URL") unless uri.kind_of?(URI::HTTP) || uri.kind_of?(URI::HTTPS)
 
       self.eventUrl
     end

data/lib/vonage/voice/actions/conversation.rb

@@ -49,9 +49,15 @@ module Vonage
     end
 
     def verify_music_on_hold_url
-      uri = URI.parse(self.musicOnHoldUrl)
+      music_on_hold_url = self.musicOnHoldUrl
 
-      raise ClientError.new("Invalid 'musicOnHoldUrl' value, must be a valid URL") unless uri.kind_of?(URI::HTTP) || uri.kind_of?(URI::HTTPS)
+      unless music_on_hold_url.is_a?(Array) && music_on_hold_url.length == 1 && music_on_hold_url[0].is_a?(String)
+        raise ClientError.new("Expected 'musicOnHoldUrl' parameter to be an Array containing a single string item")
+      end
+
+      uri = URI.parse(music_on_hold_url[0])
+
+      raise ClientError.new("Invalid 'musicOnHoldUrl' value, array must contain a valid URL") unless uri.kind_of?(URI::HTTP) || uri.kind_of?(URI::HTTPS)
 
       self.musicOnHoldUrl
     end

data/lib/vonage/voice/actions/input.rb

@@ -3,7 +3,7 @@
 
 module Vonage
   class Voice::Actions::Input
-    attr_accessor :type, :dtmf, :speech, :eventUrl, :eventMethod
+    attr_accessor :type, :dtmf, :speech, :eventUrl, :eventMethod, :mode
 
     def initialize(attributes = {})
       @type = attributes.fetch(:type)
@@ -11,6 +11,7 @@ module Vonage
       @speech = attributes.fetch(:speech, nil)
       @eventUrl = attributes.fetch(:eventUrl, nil)
       @eventMethod = attributes.fetch(:eventMethod, nil)
+      @mode = attributes.fetch(:mode, nil)
 
       after_initialize!
     end
@@ -33,6 +34,10 @@ module Vonage
       if self.eventMethod
         validate_event_method
       end
+
+      if self.mode
+        validate_mode
+      end
     end
 
     def validate_type
@@ -83,9 +88,13 @@ module Vonage
     end
 
     def validate_event_url
-      uri = URI.parse(self.eventUrl)
+      unless self.eventUrl.is_a?(Array) && self.eventUrl.length == 1 && self.eventUrl[0].is_a?(String)
+        raise ClientError.new("Expected 'eventUrl' parameter to be an Array containing a single string item")
+      end
+
+      uri = URI.parse(self.eventUrl[0])
 
-      raise ClientError.new("Invalid 'eventUrl' value, must be a valid URL") unless uri.kind_of?(URI::HTTP) || uri.kind_of?(URI::HTTPS)
+      raise ClientError.new("Invalid 'eventUrl' value, array must contain a valid URL") unless uri.kind_of?(URI::HTTP) || uri.kind_of?(URI::HTTPS)
 
       self.eventUrl
     end
@@ -96,6 +105,12 @@ module Vonage
       raise ClientError.new("Invalid 'eventMethod' value. must be either: 'GET' or 'POST'") unless valid_methods.include?(self.eventMethod.upcase)
     end
 
+    def validate_mode
+      valid_modes = ['asyncronous']
+
+      raise ClientError.new("Invalid 'mode' value, must be asyncronous'") unless valid_modes.include?(self.mode)
+    end
+
     def action
       create_input!(self)
     end
@@ -112,6 +127,7 @@ module Vonage
       ncco[0].merge!(speech: builder.speech) if builder.speech
       ncco[0].merge!(eventUrl: builder.eventUrl) if builder.eventUrl
       ncco[0].merge!(eventMethod: builder.eventMethod) if builder.eventMethod
+      ncco[0].merge!(mode: builder.mode) if builder.mode
 
       ncco
     end

data/lib/vonage/voice/actions/notify.rb

@@ -22,10 +22,15 @@ module Vonage
     end
 
     def validate_event_url
-      uri = URI.parse(self.eventUrl[0])
+      event_url = self.eventUrl
 
-      raise ClientError.new("Expected 'eventUrl' value to be an Array with a single string") unless self.eventUrl.is_a?(Array)
-      raise ClientError.new("Invalid 'eventUrl' value, must be a valid URL") unless uri.kind_of?(URI::HTTP) || uri.kind_of?(URI::HTTPS)
+      unless event_url.is_a?(Array) && event_url.length == 1 && event_url[0].is_a?(String)
+        raise ClientError.new("Expected 'eventUrl' parameter to be an Array containing a single string item")
+      end
+
+      uri = URI.parse(event_url[0])
+
+      raise ClientError.new("Invalid 'eventUrl' value, array must contain a valid URL") unless uri.kind_of?(URI::HTTP) || uri.kind_of?(URI::HTTPS)
 
       self.eventUrl
     end

data/lib/vonage/voice/actions/record.rb

@@ -3,7 +3,7 @@
 
 module Vonage
   class Voice::Actions::Record
-    attr_accessor :format, :split, :channels, :endOnSilence, :endOnKey, :timeOut, :beepStart, :eventUrl, :eventMethod
+    attr_accessor :format, :split, :channels, :endOnSilence, :endOnKey, :timeOut, :beepStart, :eventUrl, :eventMethod, :transcription
 
     def initialize(attributes = {})
       @format = attributes.fetch(:format, nil)
@@ -15,6 +15,7 @@ module Vonage
       @beepStart = attributes.fetch(:beepStart, nil)
       @eventUrl = attributes.fetch(:eventUrl, nil)
       @eventMethod = attributes.fetch(:eventMethod, nil)
+      @transcription = attributes.fetch(:transcription, nil)
 
       after_initialize!
     end
@@ -55,6 +56,10 @@ module Vonage
       if self.eventMethod
         validate_event_method
       end
+
+      if self.transcription
+        validate_transcription
+      end
     end
 
     def validate_format
@@ -90,9 +95,13 @@ module Vonage
     end
 
     def validate_event_url
-      uri = URI.parse(self.eventUrl)
+      unless self.eventUrl.is_a?(Array) && self.eventUrl.length == 1 && self.eventUrl[0].is_a?(String)
+        raise ClientError.new("Expected 'eventUrl' parameter to be an Array containing a single string item")
+      end
 
-      raise ClientError.new("Invalid 'eventUrl' value, must be a valid URL") unless uri.kind_of?(URI::HTTP) || uri.kind_of?(URI::HTTPS)
+      uri = URI.parse(self.eventUrl[0])
+
+      raise ClientError.new("Invalid 'eventUrl' value, array must contain a valid URL") unless uri.kind_of?(URI::HTTP) || uri.kind_of?(URI::HTTPS)
 
       self.eventUrl
     end
@@ -100,7 +109,45 @@ module Vonage
     def validate_event_method
       valid_methods = ['GET', 'POST']
 
-      raise ClientError.new("Invalid 'eventMethod' value. must be either: 'GET' or 'POST'") unless valid_methods.include?(self.eventMethod.upcase)
+      raise ClientError.new("Invalid 'eventMethod' value. Must be either: 'GET' or 'POST'") unless valid_methods.include?(self.eventMethod.upcase)
+    end
+
+    def validate_transcription
+      raise ClientError.new("Expected 'transcription' parameter to be a Hash") unless self.transcription.is_a?(Hash)
+
+      if self.transcription[:language]
+        raise ClientError.new("Invalid 'language' value, must be a String") unless self.transcription[:language].is_a?(String)
+      end
+
+      if self.transcription[:eventUrl]
+        event_url = self.transcription[:eventUrl]
+
+        unless event_url.is_a?(Array) && event_url.length == 1 && event_url[0].is_a?(String)
+          raise ClientError.new("Expected 'eventUrl' parameter to be an Array containing a single string item")
+        end
+
+        uri = URI.parse(event_url[0])
+
+        raise ClientError.new("Invalid 'eventUrl' value, array must contain a valid URL") unless uri.kind_of?(URI::HTTP) || uri.kind_of?(URI::HTTPS)
+      end
+
+      if self.transcription[:eventMethod]
+        event_method = self.transcription[:eventMethod]
+        raise ClientError.new("Invalid 'eventMethod' value, must be either: 'GET' or 'POST'") unless ['GET', 'POST'].include?(event_method.upcase)
+      end
+
+      if self.transcription[:sentimentAnalysis]
+        sentiment_analysis = self.transcription[:sentimentAnalysis]
+        raise ClientError.new("Invalid 'sentimentAnalysis' value, must be a Boolean") unless sentiment_analysis == true || sentiment_analysis == false
+      end
+
+      # if self.dtmf[:maxDigits]
+      #   raise ClientError.new("Expected 'maxDigits' to not be more than 22") if self.dtmf[:maxDigits] > 22
+      # end
+
+      # if self.dtmf[:submitOnHash]
+      #   raise ClientError.new("Invalid 'submitOnHash' value, must be a Boolean") unless self.dtmf[:submitOnHash] == true || self.dtmf[:submitOnHash] == false
+      # end
     end
 
     def action
@@ -123,6 +170,7 @@ module Vonage
       ncco[0].merge!(beepStart: builder.beepStart) if builder.beepStart
       ncco[0].merge!(eventUrl: builder.eventUrl) if builder.eventUrl
       ncco[0].merge!(eventMethod: builder.eventMethod) if builder.eventMethod
+      ncco[0].merge!(transcription: builder.transcription) if builder.transcription
 
       ncco
     end

data/lib/vonage/voice/actions/stream.rb

@@ -3,13 +3,16 @@
 
 module Vonage
   class Voice::Actions::Stream
-    attr_accessor :streamUrl, :level, :bargeIn, :loop
+    attr_accessor :streamUrl, :level, :bargeIn, :loop, :eventOnCompletion, :eventUrl, :eventMethod
 
     def initialize(attributes = {})
       @streamUrl = attributes.fetch(:streamUrl)
       @level = attributes.fetch(:level, nil)
       @bargeIn = attributes.fetch(:bargeIn, nil)
       @loop = attributes.fetch(:loop, nil)
+      @eventOnCompletion = attributes.fetch(:eventOnCompletion, nil)
+      @eventUrl = attributes.fetch(:eventUrl, nil)
+      @eventMethod = attributes.fetch(:eventMethod, nil)
 
       after_initialize!
     end
@@ -28,12 +31,28 @@ module Vonage
       if self.loop
         verify_loop
       end
+
+      if self.eventOnCompletion || self.eventOnCompletion == false
+        verify_event_on_completion
+      end
+
+      if self.eventUrl
+        verify_event_url
+      end
+
+      if self.eventMethod
+        verify_event_method
+      end
     end
 
     def verify_stream_url
-      raise ClientError.new("Expected 'streamUrl' parameter to be an Array containing a single string item") unless self.streamUrl.is_a?(Array)
+      stream_url = self.streamUrl
+
+      unless stream_url.is_a?(Array) && stream_url.length == 1 && stream_url[0].is_a?(String)
+        raise ClientError.new("Expected 'streamUrl' parameter to be an Array containing a single string item")
+      end
 
-      uri = URI.parse(self.streamUrl[0])
+      uri = URI.parse(stream_url[0])
 
       raise ClientError.new("Invalid 'streamUrl' value, must be a valid URL") unless uri.kind_of?(URI::HTTP) || uri.kind_of?(URI::HTTPS)
     end
@@ -47,7 +66,29 @@ module Vonage
     end
 
     def verify_loop
-      raise ClientError.new("Expected 'loop' value to be either 1 or 0") unless self.loop == 1 || self.loop == 0
+      raise ClientError.new("Expected 'loop' value to be either 0 or a positive integer") unless self.loop >= 0
+    end
+
+    def verify_event_on_completion
+      raise ClientError.new("Expected 'eventOnCompletion' value to be a Boolean") unless self.eventOnCompletion == true || self.eventOnCompletion == false
+    end
+
+    def verify_event_url
+      unless self.eventUrl.is_a?(Array) && self.eventUrl.length == 1 && self.eventUrl[0].is_a?(String)
+        raise ClientError.new("Expected 'eventUrl' parameter to be an Array containing a single string item")
+      end
+
+      uri = URI.parse(self.eventUrl[0])
+
+      raise ClientError.new("Invalid 'eventUrl' value, array must contain a valid URL") unless uri.kind_of?(URI::HTTP) || uri.kind_of?(URI::HTTPS)
+
+      self.eventUrl
+    end
+
+    def verify_event_method
+      valid_methods = ['GET', 'POST']
+
+      raise ClientError.new("Invalid 'eventMethod' value. must be either: 'GET' or 'POST'") unless valid_methods.include?(self.eventMethod.upcase)
     end
 
     def action
@@ -65,6 +106,9 @@ module Vonage
       ncco[0].merge!(level: builder.level) if builder.level
       ncco[0].merge!(bargeIn: builder.bargeIn) if (builder.bargeIn || builder.bargeIn == false)
       ncco[0].merge!(loop: builder.loop) if builder.loop
+      ncco[0].merge!(eventOnCompletion: builder.eventOnCompletion) if (builder.eventOnCompletion || builder.eventOnCompletion == false)
+      ncco[0].merge!(eventUrl: builder.eventUrl) if builder.eventUrl
+      ncco[0].merge!(eventMethod: builder.eventMethod) if builder.eventMethod
 
       ncco
     end

data/lib/vonage/voice/actions/talk.rb

@@ -2,7 +2,7 @@
 # frozen_string_literal: true
 module Vonage
   class Voice::Actions::Talk
-    attr_accessor :text, :bargeIn, :loop, :level, :language, :style, :premium
+    attr_accessor :text, :bargeIn, :loop, :level, :language, :style, :premium, :eventOnCompletion, :eventUrl, :eventMethod
 
     def initialize(attributes= {})
       @text = attributes.fetch(:text)
@@ -12,12 +12,15 @@ module Vonage
       @language = attributes.fetch(:language, nil)
       @style = attributes.fetch(:style, nil)
       @premium = attributes.fetch(:premium, nil)
+      @eventOnCompletion = attributes.fetch(:eventOnCompletion, nil)
+      @eventUrl = attributes.fetch(:eventUrl, nil)
+      @eventMethod = attributes.fetch(:eventMethod, nil)
 
       after_initialize!
     end
 
     def after_initialize!
-      if self.bargeIn
+      if self.bargeIn || self.bargeIn == false
         verify_barge_in
       end
 
@@ -33,9 +36,21 @@ module Vonage
         verify_style
       end
 
-      if self.premium
+      if self.premium || self.premium == false
         verify_premium
       end
+
+      if self.eventOnCompletion || self.eventOnCompletion == false
+        verify_event_on_completion
+      end
+
+      if self.eventUrl
+        verify_event_url
+      end
+
+      if self.eventMethod
+        verify_event_method
+      end
     end
 
     def verify_barge_in
@@ -43,7 +58,7 @@ module Vonage
     end
 
     def verify_loop
-      raise ClientError.new("Expected 'loop' value to be either 1 or 0") unless self.loop == 1 || self.loop == 0
+      raise ClientError.new("Expected 'loop' value to be either 0 or a positive integer") unless self.loop >= 0
     end
 
     def verify_level
@@ -58,6 +73,28 @@ module Vonage
       raise ClientError.new("Expected 'premium' value to be a Boolean") unless self.premium == true || self.premium == false
     end
 
+    def verify_event_on_completion
+      raise ClientError.new("Expected 'eventOnCompletion' value to be a Boolean") unless self.eventOnCompletion == true || self.eventOnCompletion == false
+    end
+
+    def verify_event_url
+      unless self.eventUrl.is_a?(Array) && self.eventUrl.length == 1 && self.eventUrl[0].is_a?(String)
+        raise ClientError.new("Expected 'eventUrl' parameter to be an Array containing a single string item")
+      end
+
+      uri = URI.parse(self.eventUrl[0])
+
+      raise ClientError.new("Invalid 'eventUrl' value, array must contain a valid URL") unless uri.kind_of?(URI::HTTP) || uri.kind_of?(URI::HTTPS)
+
+      self.eventUrl
+    end
+
+    def verify_event_method
+      valid_methods = ['GET', 'POST']
+
+      raise ClientError.new("Invalid 'eventMethod' value. must be either: 'GET' or 'POST'") unless valid_methods.include?(self.eventMethod.upcase)
+    end
+
     def action
       create_talk!(self)
     end
@@ -75,6 +112,10 @@ module Vonage
       ncco[0].merge!(level: builder.level) if builder.level
       ncco[0].merge!(language: builder.language) if builder.language
       ncco[0].merge!(style: builder.style) if builder.style
+      ncco[0].merge!(premium: builder.premium) if (builder.bargeIn || builder.bargeIn == false)
+      ncco[0].merge!(eventOnCompletion: builder.eventOnCompletion) if (builder.eventOnCompletion || builder.eventOnCompletion == false)
+      ncco[0].merge!(eventUrl: builder.eventUrl) if builder.eventUrl
+      ncco[0].merge!(eventMethod: builder.eventMethod) if builder.eventMethod
 
       ncco
     end