twilio-ruby 5.18.0 → 5.19.0

data/lib/twilio-ruby/rest/api.rb

@@ -84,7 +84,7 @@ module Twilio
       end
 
       ##
-      # @param [String] sid A 34-character string that uniquely identifies the Call
+      # @param [String] sid The unique string that that we created to identify this Call
       #   resource.
       # @return [Twilio::REST::Api::V2010::AccountContext::CallInstance] if sid was passed.
       # @return [Twilio::REST::Api::V2010::AccountContext::CallList]
@@ -93,8 +93,8 @@ module Twilio
       end
 
       ##
-      # @param [String] sid A 34 character string that uniquely identifies this
-      #   conference.
+      # @param [String] sid The unique string that that we created to identify this
+      #   Conference resource.
       # @return [Twilio::REST::Api::V2010::AccountContext::ConferenceInstance] if sid was passed.
       # @return [Twilio::REST::Api::V2010::AccountContext::ConferenceList]
       def conferences(sid=:unset)
@@ -167,7 +167,8 @@ module Twilio
       end
 
       ##
-      # @param [String] sid A 34 character string that uniquely identifies this queue.
+      # @param [String] sid The unique string that that we created to identify this
+      #   Queue resource.
       # @return [Twilio::REST::Api::V2010::AccountContext::QueueInstance] if sid was passed.
       # @return [Twilio::REST::Api::V2010::AccountContext::QueueList]
       def queues(sid=:unset)
@@ -198,8 +199,8 @@ module Twilio
       end
 
       ##
-      # @param [String] sid A 34 character string that uniquely identifies this
-      #   resource.
+      # @param [String] sid The unique string that that we created to identify this
+      #   ShortCode resource.
       # @return [Twilio::REST::Api::V2010::AccountContext::ShortCodeInstance] if sid was passed.
       # @return [Twilio::REST::Api::V2010::AccountContext::ShortCodeList]
       def short_codes(sid=:unset)

data/lib/twilio-ruby/rest/authy/v1.rb

@@ -15,22 +15,8 @@ module Twilio
         def initialize(domain)
           super
           @version = 'v1'
-          @services = nil
           @forms = nil
-        end
-
-        ##
-        # @param [String] sid A 34 character string that uniquely identifies this Service.
-        # @return [Twilio::REST::Authy::V1::ServiceContext] if sid was passed.
-        # @return [Twilio::REST::Authy::V1::ServiceList]
-        def services(sid=:unset)
-          if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @services ||= ServiceList.new self
-          else
-            ServiceContext.new(self, sid)
-          end
+          @services = nil
         end
 
         ##
@@ -48,6 +34,20 @@ module Twilio
           end
         end
 
+        ##
+        # @param [String] sid A 34 character string that uniquely identifies this Service.
+        # @return [Twilio::REST::Authy::V1::ServiceContext] if sid was passed.
+        # @return [Twilio::REST::Authy::V1::ServiceList]
+        def services(sid=:unset)
+          if sid.nil?
+            raise ArgumentError, 'sid cannot be nil'
+          elsif sid == :unset
+            @services ||= ServiceList.new self
+          else
+            ServiceContext.new(self, sid)
+          end
+        end
+
         ##
         # Provide a user friendly representation
         def to_s

data/lib/twilio-ruby/rest/authy.rb

@@ -28,14 +28,6 @@ module Twilio
         @v1 ||= V1.new self
       end
 
-      ##
-      # @param [String] sid A 34 character string that uniquely identifies this Service.
-      # @return [Twilio::REST::Authy::V1::ServiceInstance] if sid was passed.
-      # @return [Twilio::REST::Authy::V1::ServiceList]
-      def services(sid=:unset)
-        self.v1.services(sid)
-      end
-
       ##
       # @param [form.FormTypes] form_type The Type of this Form. One of `form-app-push`,
       #   `form-sms` or `form-totp`.
@@ -45,6 +37,14 @@ module Twilio
         self.v1.forms(form_type)
       end
 
+      ##
+      # @param [String] sid A 34 character string that uniquely identifies this Service.
+      # @return [Twilio::REST::Authy::V1::ServiceInstance] if sid was passed.
+      # @return [Twilio::REST::Authy::V1::ServiceList]
+      def services(sid=:unset)
+        self.v1.services(sid)
+      end
+
       ##
       # Provide a user friendly representation
       def to_s

data/lib/twilio-ruby/rest/client.rb

@@ -47,6 +47,7 @@ module Twilio
         @studio = nil
         @verify = nil
         @voice = nil
+        @insights = nil
       end
 
       ##
@@ -229,6 +230,12 @@ module Twilio
         @voice ||= Voice.new self
       end
 
+      ##
+      # Access the Insights Twilio Domain
+      def insights
+        @insights ||= Insights.new self
+      end
+
       ##
       # @param [String] sid A 34 character string that uniquely identifies this address.
       # @return [Twilio::REST::Api::V2010::AccountContext::AddressInstance] if sid was passed.
@@ -270,7 +277,7 @@ module Twilio
       end
 
       ##
-      # @param [String] sid A 34-character string that uniquely identifies the Call
+      # @param [String] sid The unique string that that we created to identify this Call
       #   resource.
       # @return [Twilio::REST::Api::V2010::AccountContext::CallInstance] if sid was passed.
       # @return [Twilio::REST::Api::V2010::AccountContext::CallList]
@@ -279,8 +286,8 @@ module Twilio
       end
 
       ##
-      # @param [String] sid A 34 character string that uniquely identifies this
-      #   conference.
+      # @param [String] sid The unique string that that we created to identify this
+      #   Conference resource.
       # @return [Twilio::REST::Api::V2010::AccountContext::ConferenceInstance] if sid was passed.
       # @return [Twilio::REST::Api::V2010::AccountContext::ConferenceList]
       def conferences(sid=:unset)
@@ -353,7 +360,8 @@ module Twilio
       end
 
       ##
-      # @param [String] sid A 34 character string that uniquely identifies this queue.
+      # @param [String] sid The unique string that that we created to identify this
+      #   Queue resource.
       # @return [Twilio::REST::Api::V2010::AccountContext::QueueInstance] if sid was passed.
       # @return [Twilio::REST::Api::V2010::AccountContext::QueueList]
       def queues(sid=:unset)
@@ -384,8 +392,8 @@ module Twilio
       end
 
       ##
-      # @param [String] sid A 34 character string that uniquely identifies this
-      #   resource.
+      # @param [String] sid The unique string that that we created to identify this
+      #   ShortCode resource.
       # @return [Twilio::REST::Api::V2010::AccountContext::ShortCodeInstance] if sid was passed.
       # @return [Twilio::REST::Api::V2010::AccountContext::ShortCodeList]
       def short_codes(sid=:unset)

data/lib/twilio-ruby/rest/insights/v1/summary.rb

@@ -0,0 +1,286 @@
+##
+# This code was generated by
+# \ / _    _  _|   _  _
+#  | (_)\/(_)(_|\/| |(/_  v1.0.0
+#       /       /
+# 
+# frozen_string_literal: true
+
+module Twilio
+  module REST
+    class Insights < Domain
+      class V1 < Version
+        ##
+        # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
+        class CallSummaryList < ListResource
+          ##
+          # Initialize the CallSummaryList
+          # @param [Version] version Version that contains the resource
+          # @return [CallSummaryList] CallSummaryList
+          def initialize(version)
+            super(version)
+
+            # Path Solution
+            @solution = {}
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            '#<Twilio.Insights.V1.CallSummaryList>'
+          end
+        end
+
+        ##
+        # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
+        class CallSummaryPage < Page
+          ##
+          # Initialize the CallSummaryPage
+          # @param [Version] version Version that contains the resource
+          # @param [Response] response Response from the API
+          # @param [Hash] solution Path solution for the resource
+          # @return [CallSummaryPage] CallSummaryPage
+          def initialize(version, response, solution)
+            super(version, response)
+
+            # Path Solution
+            @solution = solution
+          end
+
+          ##
+          # Build an instance of CallSummaryInstance
+          # @param [Hash] payload Payload response from the API
+          # @return [CallSummaryInstance] CallSummaryInstance
+          def get_instance(payload)
+            CallSummaryInstance.new(@version, payload, )
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            '<Twilio.Insights.V1.CallSummaryPage>'
+          end
+        end
+
+        ##
+        # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
+        class CallSummaryContext < InstanceContext
+          ##
+          # Initialize the CallSummaryContext
+          # @param [Version] version Version that contains the resource
+          # @param [String] call_sid The call_sid
+          # @return [CallSummaryContext] CallSummaryContext
+          def initialize(version, call_sid)
+            super(version)
+
+            # Path Solution
+            @solution = {call_sid: call_sid, }
+            @uri = "/Voice/#{@solution[:call_sid]}/Summary"
+          end
+
+          ##
+          # Fetch a CallSummaryInstance
+          # @return [CallSummaryInstance] Fetched CallSummaryInstance
+          def fetch
+            params = Twilio::Values.of({})
+
+            payload = @version.fetch(
+                'GET',
+                @uri,
+                params,
+            )
+
+            CallSummaryInstance.new(@version, payload, call_sid: @solution[:call_sid], )
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+            "#<Twilio.Insights.V1.CallSummaryContext #{context}>"
+          end
+        end
+
+        ##
+        # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
+        class CallSummaryInstance < InstanceResource
+          ##
+          # Initialize the CallSummaryInstance
+          # @param [Version] version Version that contains the resource
+          # @param [Hash] payload payload that contains response from Twilio
+          # @param [String] call_sid The call_sid
+          # @return [CallSummaryInstance] CallSummaryInstance
+          def initialize(version, payload, call_sid: nil)
+            super(version)
+
+            # Marshaled Properties
+            @properties = {
+                'account_sid' => payload['account_sid'],
+                'call_sid' => payload['call_sid'],
+                'call_type' => payload['call_type'],
+                'call_state' => payload['call_state'],
+                'processing_state' => payload['processing_state'],
+                'direction' => payload['direction'],
+                'disconnected_by' => payload['disconnected_by'],
+                'start_time' => Twilio.deserialize_iso8601_datetime(payload['start_time']),
+                'end_time' => Twilio.deserialize_iso8601_datetime(payload['end_time']),
+                'duration' => payload['duration'] == nil ? payload['duration'] : payload['duration'].to_i,
+                'connect_duration' => payload['connect_duration'] == nil ? payload['connect_duration'] : payload['connect_duration'].to_i,
+                'from' => payload['from'],
+                'to' => payload['to'],
+                'carrier_edge' => payload['carrier_edge'],
+                'client_edge' => payload['client_edge'],
+                'sip_edge' => payload['sip_edge'],
+                'tags' => payload['tags'],
+                'url' => payload['url'],
+            }
+
+            # Context
+            @instance_context = nil
+            @params = {'call_sid' => call_sid || @properties['call_sid'], }
+          end
+
+          ##
+          # Generate an instance context for the instance, the context is capable of
+          # performing various actions.  All instance actions are proxied to the context
+          # @return [CallSummaryContext] CallSummaryContext for this CallSummaryInstance
+          def context
+            unless @instance_context
+              @instance_context = CallSummaryContext.new(@version, @params['call_sid'], )
+            end
+            @instance_context
+          end
+
+          ##
+          # @return [String] The account_sid
+          def account_sid
+            @properties['account_sid']
+          end
+
+          ##
+          # @return [String] The call_sid
+          def call_sid
+            @properties['call_sid']
+          end
+
+          ##
+          # @return [call_summary.CallType] The call_type
+          def call_type
+            @properties['call_type']
+          end
+
+          ##
+          # @return [call_summary.CallState] The call_state
+          def call_state
+            @properties['call_state']
+          end
+
+          ##
+          # @return [call_summary.ProcessingState] The processing_state
+          def processing_state
+            @properties['processing_state']
+          end
+
+          ##
+          # @return [call_summary.Direction] The direction
+          def direction
+            @properties['direction']
+          end
+
+          ##
+          # @return [call_summary.DisconnectedBy] The disconnected_by
+          def disconnected_by
+            @properties['disconnected_by']
+          end
+
+          ##
+          # @return [Time] The start_time
+          def start_time
+            @properties['start_time']
+          end
+
+          ##
+          # @return [Time] The end_time
+          def end_time
+            @properties['end_time']
+          end
+
+          ##
+          # @return [String] The duration
+          def duration
+            @properties['duration']
+          end
+
+          ##
+          # @return [String] The connect_duration
+          def connect_duration
+            @properties['connect_duration']
+          end
+
+          ##
+          # @return [Hash] The from
+          def from
+            @properties['from']
+          end
+
+          ##
+          # @return [Hash] The to
+          def to
+            @properties['to']
+          end
+
+          ##
+          # @return [Hash] The carrier_edge
+          def carrier_edge
+            @properties['carrier_edge']
+          end
+
+          ##
+          # @return [Hash] The client_edge
+          def client_edge
+            @properties['client_edge']
+          end
+
+          ##
+          # @return [Hash] The sip_edge
+          def sip_edge
+            @properties['sip_edge']
+          end
+
+          ##
+          # @return [String] The tags
+          def tags
+            @properties['tags']
+          end
+
+          ##
+          # @return [String] The url
+          def url
+            @properties['url']
+          end
+
+          ##
+          # Fetch a CallSummaryInstance
+          # @return [CallSummaryInstance] Fetched CallSummaryInstance
+          def fetch
+            context.fetch
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            values = @params.map{|k, v| "#{k}: #{v}"}.join(" ")
+            "<Twilio.Insights.V1.CallSummaryInstance #{values}>"
+          end
+
+          ##
+          # Provide a detailed, user friendly representation
+          def inspect
+            values = @properties.map{|k, v| "#{k}: #{v}"}.join(" ")
+            "<Twilio.Insights.V1.CallSummaryInstance #{values}>"
+          end
+        end
+      end
+    end
+  end
+end