twilio-ruby 5.6.0 → 5.33.0

data/lib/twilio-ruby/rest/preview/sync.rb

@@ -3,6 +3,8 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
+#
+# frozen_string_literal: true
 
 module Twilio
   module REST

data/lib/twilio-ruby/rest/preview/trusted_comms/branded_call.rb

@@ -0,0 +1,248 @@
+##
+# This code was generated by
+# \ / _    _  _|   _  _
+#  | (_)\/(_)(_|\/| |(/_  v1.0.0
+#       /       /
+#
+# frozen_string_literal: true
+
+module Twilio
+  module REST
+    class Preview < Domain
+      class TrustedComms < 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 BrandedCallList < ListResource
+          ##
+          # Initialize the BrandedCallList
+          # @param [Version] version Version that contains the resource
+          # @return [BrandedCallList] BrandedCallList
+          def initialize(version)
+            super(version)
+
+            # Path Solution
+            @solution = {}
+            @uri = "/Business/BrandedCalls"
+          end
+
+          ##
+          # Retrieve a single page of BrandedCallInstance records from the API.
+          # Request is executed immediately.
+          # @param [String] from The phone number to use as the caller id, given in [E.164
+          #   format](https://www.twilio.com/docs/glossary/what-e164). It must be a Twilio
+          #   number that has been set up as a Branded Number in the Business Profile section
+          #   for your account.
+          # @param [String] to The terminating Phone Number, given in [E.164
+          #   format](https://www.twilio.com/docs/glossary/what-e164).
+          # @param [String] reason The business reason for this phone call that will appear
+          #   in the terminating device's screen. Max 50 characters.
+          # @param [String] call_sid The Call sid this Branded Call should link to.
+          # @return [BrandedCallInstance] Newly created BrandedCallInstance
+          def create(from: nil, to: nil, reason: nil, call_sid: :unset)
+            data = Twilio::Values.of({'From' => from, 'To' => to, 'Reason' => reason, 'CallSid' => call_sid, })
+
+            payload = @version.create(
+                'POST',
+                @uri,
+                data: data
+            )
+
+            BrandedCallInstance.new(@version, payload, )
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            '#<Twilio.Preview.TrustedComms.BrandedCallList>'
+          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 BrandedCallPage < Page
+          ##
+          # Initialize the BrandedCallPage
+          # @param [Version] version Version that contains the resource
+          # @param [Response] response Response from the API
+          # @param [Hash] solution Path solution for the resource
+          # @return [BrandedCallPage] BrandedCallPage
+          def initialize(version, response, solution)
+            super(version, response)
+
+            # Path Solution
+            @solution = solution
+          end
+
+          ##
+          # Build an instance of BrandedCallInstance
+          # @param [Hash] payload Payload response from the API
+          # @return [BrandedCallInstance] BrandedCallInstance
+          def get_instance(payload)
+            BrandedCallInstance.new(@version, payload, )
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            '<Twilio.Preview.TrustedComms.BrandedCallPage>'
+          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 BrandedCallInstance < InstanceResource
+          ##
+          # Initialize the BrandedCallInstance
+          # @param [Version] version Version that contains the resource
+          # @param [Hash] payload payload that contains response from Twilio
+          # @return [BrandedCallInstance] BrandedCallInstance
+          def initialize(version, payload)
+            super(version)
+
+            # Marshaled Properties
+            @properties = {
+                'account_sid' => payload['account_sid'],
+                'bg_color' => payload['bg_color'],
+                'brand_sid' => payload['brand_sid'],
+                'branded_channel_sid' => payload['branded_channel_sid'],
+                'business_sid' => payload['business_sid'],
+                'call_sid' => payload['call_sid'],
+                'caller' => payload['caller'],
+                'created_at' => Twilio.deserialize_iso8601_datetime(payload['created_at']),
+                'font_color' => payload['font_color'],
+                'from' => payload['from'],
+                'logo' => payload['logo'],
+                'phone_number_sid' => payload['phone_number_sid'],
+                'reason' => payload['reason'],
+                'sid' => payload['sid'],
+                'status' => payload['status'],
+                'to' => payload['to'],
+                'url' => payload['url'],
+                'use_case' => payload['use_case'],
+            }
+          end
+
+          ##
+          # @return [String] Account Sid.
+          def account_sid
+            @properties['account_sid']
+          end
+
+          ##
+          # @return [String] Background color of the current phone call
+          def bg_color
+            @properties['bg_color']
+          end
+
+          ##
+          # @return [String] Brand Sid.
+          def brand_sid
+            @properties['brand_sid']
+          end
+
+          ##
+          # @return [String] Branded Channel Sid.
+          def branded_channel_sid
+            @properties['branded_channel_sid']
+          end
+
+          ##
+          # @return [String] Business Sid.
+          def business_sid
+            @properties['business_sid']
+          end
+
+          ##
+          # @return [String] A string that uniquely identifies this phone call.
+          def call_sid
+            @properties['call_sid']
+          end
+
+          ##
+          # @return [String] Caller name of the current phone call
+          def caller
+            @properties['caller']
+          end
+
+          ##
+          # @return [Time] The date this current phone call was created
+          def created_at
+            @properties['created_at']
+          end
+
+          ##
+          # @return [String] Font color of the current phone call
+          def font_color
+            @properties['font_color']
+          end
+
+          ##
+          # @return [String] The originating phone number
+          def from
+            @properties['from']
+          end
+
+          ##
+          # @return [String] Logo URL of the caller
+          def logo
+            @properties['logo']
+          end
+
+          ##
+          # @return [String] Phone Number Sid.
+          def phone_number_sid
+            @properties['phone_number_sid']
+          end
+
+          ##
+          # @return [String] The business reason for this current phone call
+          def reason
+            @properties['reason']
+          end
+
+          ##
+          # @return [String] A string that uniquely identifies this current branded phone call.
+          def sid
+            @properties['sid']
+          end
+
+          ##
+          # @return [String] The status of the current phone call
+          def status
+            @properties['status']
+          end
+
+          ##
+          # @return [String] The terminating phone number
+          def to
+            @properties['to']
+          end
+
+          ##
+          # @return [String] The URL of this resource.
+          def url
+            @properties['url']
+          end
+
+          ##
+          # @return [String] The use case for the current phone call
+          def use_case
+            @properties['use_case']
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            "<Twilio.Preview.TrustedComms.BrandedCallInstance>"
+          end
+
+          ##
+          # Provide a detailed, user friendly representation
+          def inspect
+            "<Twilio.Preview.TrustedComms.BrandedCallInstance>"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/twilio-ruby/rest/preview/trusted_comms/business/insights/impressions_rate.rb

@@ -0,0 +1,264 @@
+##
+# This code was generated by
+# \ / _    _  _|   _  _
+#  | (_)\/(_)(_|\/| |(/_  v1.0.0
+#       /       /
+#
+# frozen_string_literal: true
+
+module Twilio
+  module REST
+    class Preview < Domain
+      class TrustedComms < Version
+        class BusinessContext < InstanceContext
+          class InsightsList < ListResource
+            ##
+            # 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 ImpressionsRateList < ListResource
+              ##
+              # Initialize the ImpressionsRateList
+              # @param [Version] version Version that contains the resource
+              # @param [String] business_sid A 34 character string that uniquely identifies this
+              #   Business.
+              # @return [ImpressionsRateList] ImpressionsRateList
+              def initialize(version, business_sid: nil)
+                super(version)
+
+                # Path Solution
+                @solution = {business_sid: business_sid}
+              end
+
+              ##
+              # Provide a user friendly representation
+              def to_s
+                '#<Twilio.Preview.TrustedComms.ImpressionsRateList>'
+              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 ImpressionsRatePage < Page
+              ##
+              # Initialize the ImpressionsRatePage
+              # @param [Version] version Version that contains the resource
+              # @param [Response] response Response from the API
+              # @param [Hash] solution Path solution for the resource
+              # @return [ImpressionsRatePage] ImpressionsRatePage
+              def initialize(version, response, solution)
+                super(version, response)
+
+                # Path Solution
+                @solution = solution
+              end
+
+              ##
+              # Build an instance of ImpressionsRateInstance
+              # @param [Hash] payload Payload response from the API
+              # @return [ImpressionsRateInstance] ImpressionsRateInstance
+              def get_instance(payload)
+                ImpressionsRateInstance.new(@version, payload, business_sid: @solution[:business_sid], )
+              end
+
+              ##
+              # Provide a user friendly representation
+              def to_s
+                '<Twilio.Preview.TrustedComms.ImpressionsRatePage>'
+              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 ImpressionsRateContext < InstanceContext
+              ##
+              # Initialize the ImpressionsRateContext
+              # @param [Version] version Version that contains the resource
+              # @param [String] business_sid The unique SID identifier of the Business to filter
+              #   by.
+              # @return [ImpressionsRateContext] ImpressionsRateContext
+              def initialize(version, business_sid)
+                super(version)
+
+                # Path Solution
+                @solution = {business_sid: business_sid, }
+                @uri = "/Businesses/#{@solution[:business_sid]}/Insights/ImpressionsRate"
+              end
+
+              ##
+              # Fetch a ImpressionsRateInstance
+              # @param [String] brand_sid The unique SID identifier of the Brand to filter by.
+              # @param [String] branded_channel_sid The unique SID identifier of the Branded
+              #   Channel to filter by.
+              # @param [String] phone_number_sid The unique SID identifier of the Phone Number
+              #   to filter by.
+              # @param [String] country The 2-letter ISO 3166 code of the Country to filter by.
+              # @param [Time] start The start date that for this Impressions Rate, given in ISO
+              #   8601 format. Default value is 30 days ago.
+              # @param [Time] end_ The end date that for this Impressions Rate, given in ISO
+              #   8601 format. Default value is current timestamp.
+              # @param [impressions_rate.Intervals] interval The Interval of this Impressions
+              #   Rate. One of `minute`, `hour`, `day`, `week` or `month`.
+              # @return [ImpressionsRateInstance] Fetched ImpressionsRateInstance
+              def fetch(brand_sid: :unset, branded_channel_sid: :unset, phone_number_sid: :unset, country: :unset, start: :unset, end_: :unset, interval: :unset)
+                params = Twilio::Values.of({
+                    'BrandSid' => brand_sid,
+                    'BrandedChannelSid' => branded_channel_sid,
+                    'PhoneNumberSid' => phone_number_sid,
+                    'Country' => country,
+                    'Start' => Twilio.serialize_iso8601_datetime(start),
+                    'End' => Twilio.serialize_iso8601_datetime(end_),
+                    'Interval' => interval,
+                })
+
+                payload = @version.fetch(
+                    'GET',
+                    @uri,
+                    params,
+                )
+
+                ImpressionsRateInstance.new(@version, payload, business_sid: @solution[:business_sid], )
+              end
+
+              ##
+              # Provide a user friendly representation
+              def to_s
+                context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+                "#<Twilio.Preview.TrustedComms.ImpressionsRateContext #{context}>"
+              end
+
+              ##
+              # Provide a detailed, user friendly representation
+              def inspect
+                context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+                "#<Twilio.Preview.TrustedComms.ImpressionsRateContext #{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 ImpressionsRateInstance < InstanceResource
+              ##
+              # Initialize the ImpressionsRateInstance
+              # @param [Version] version Version that contains the resource
+              # @param [Hash] payload payload that contains response from Twilio
+              # @param [String] business_sid A 34 character string that uniquely identifies this
+              #   Business.
+              # @return [ImpressionsRateInstance] ImpressionsRateInstance
+              def initialize(version, payload, business_sid: nil)
+                super(version)
+
+                # Marshaled Properties
+                @properties = {
+                    'account_sid' => payload['account_sid'],
+                    'business_sid' => payload['business_sid'],
+                    'end_' => Twilio.deserialize_iso8601_datetime(payload['end']),
+                    'interval' => payload['interval'],
+                    'reports' => payload['reports'],
+                    'start' => Twilio.deserialize_iso8601_datetime(payload['start']),
+                    'url' => payload['url'],
+                }
+
+                # Context
+                @instance_context = nil
+                @params = {'business_sid' => business_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 [ImpressionsRateContext] ImpressionsRateContext for this ImpressionsRateInstance
+              def context
+                unless @instance_context
+                  @instance_context = ImpressionsRateContext.new(@version, @params['business_sid'], )
+                end
+                @instance_context
+              end
+
+              ##
+              # @return [String] Account Sid.
+              def account_sid
+                @properties['account_sid']
+              end
+
+              ##
+              # @return [String] Business Sid.
+              def business_sid
+                @properties['business_sid']
+              end
+
+              ##
+              # @return [Time] The end date that for this Impressions Rate.
+              def end_
+                @properties['end_']
+              end
+
+              ##
+              # @return [impressions_rate.Intervals] The Interval of this Impressions Rate.
+              def interval
+                @properties['interval']
+              end
+
+              ##
+              # @return [Hash] Values of Impressions Rate per interval.
+              def reports
+                @properties['reports']
+              end
+
+              ##
+              # @return [Time] The start date that for this Impressions Rate.
+              def start
+                @properties['start']
+              end
+
+              ##
+              # @return [String] The URL of this resource.
+              def url
+                @properties['url']
+              end
+
+              ##
+              # Fetch a ImpressionsRateInstance
+              # @param [String] brand_sid The unique SID identifier of the Brand to filter by.
+              # @param [String] branded_channel_sid The unique SID identifier of the Branded
+              #   Channel to filter by.
+              # @param [String] phone_number_sid The unique SID identifier of the Phone Number
+              #   to filter by.
+              # @param [String] country The 2-letter ISO 3166 code of the Country to filter by.
+              # @param [Time] start The start date that for this Impressions Rate, given in ISO
+              #   8601 format. Default value is 30 days ago.
+              # @param [Time] end_ The end date that for this Impressions Rate, given in ISO
+              #   8601 format. Default value is current timestamp.
+              # @param [impressions_rate.Intervals] interval The Interval of this Impressions
+              #   Rate. One of `minute`, `hour`, `day`, `week` or `month`.
+              # @return [ImpressionsRateInstance] Fetched ImpressionsRateInstance
+              def fetch(brand_sid: :unset, branded_channel_sid: :unset, phone_number_sid: :unset, country: :unset, start: :unset, end_: :unset, interval: :unset)
+                context.fetch(
+                    brand_sid: brand_sid,
+                    branded_channel_sid: branded_channel_sid,
+                    phone_number_sid: phone_number_sid,
+                    country: country,
+                    start: start,
+                    end_: end_,
+                    interval: interval,
+                )
+              end
+
+              ##
+              # Provide a user friendly representation
+              def to_s
+                values = @params.map{|k, v| "#{k}: #{v}"}.join(" ")
+                "<Twilio.Preview.TrustedComms.ImpressionsRateInstance #{values}>"
+              end
+
+              ##
+              # Provide a detailed, user friendly representation
+              def inspect
+                values = @properties.map{|k, v| "#{k}: #{v}"}.join(" ")
+                "<Twilio.Preview.TrustedComms.ImpressionsRateInstance #{values}>"
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/twilio-ruby/rest/preview/trusted_comms/business/insights.rb

@@ -0,0 +1,111 @@
+##
+# This code was generated by
+# \ / _    _  _|   _  _
+#  | (_)\/(_)(_|\/| |(/_  v1.0.0
+#       /       /
+#
+# frozen_string_literal: true
+
+module Twilio
+  module REST
+    class Preview < Domain
+      class TrustedComms < Version
+        class BusinessContext < InstanceContext
+          ##
+          # 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 InsightsList < ListResource
+            ##
+            # Initialize the InsightsList
+            # @param [Version] version Version that contains the resource
+            # @param [String] business_sid A 34 character string that uniquely identifies this
+            #   Business.
+            # @return [InsightsList] InsightsList
+            def initialize(version, business_sid: nil)
+              super(version)
+
+              # Path Solution
+              @solution = {business_sid: business_sid}
+
+              # Components
+              @impressions_rate = nil
+            end
+
+            ##
+            # Access the impressions_rate
+            # @return [ImpressionsRateList]
+            # @return [ImpressionsRateContext]
+            def impressions_rate
+              return ImpressionsRateContext.new(@version, @solution[:business_sid], )
+
+              @impressions_rate ||= ImpressionsRateList.new(@version, business_sid: @solution[:business_sid], )
+            end
+
+            ##
+            # Provide a user friendly representation
+            def to_s
+              '#<Twilio.Preview.TrustedComms.InsightsList>'
+            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 InsightsPage < Page
+            ##
+            # Initialize the InsightsPage
+            # @param [Version] version Version that contains the resource
+            # @param [Response] response Response from the API
+            # @param [Hash] solution Path solution for the resource
+            # @return [InsightsPage] InsightsPage
+            def initialize(version, response, solution)
+              super(version, response)
+
+              # Path Solution
+              @solution = solution
+            end
+
+            ##
+            # Build an instance of InsightsInstance
+            # @param [Hash] payload Payload response from the API
+            # @return [InsightsInstance] InsightsInstance
+            def get_instance(payload)
+              InsightsInstance.new(@version, payload, business_sid: @solution[:business_sid], )
+            end
+
+            ##
+            # Provide a user friendly representation
+            def to_s
+              '<Twilio.Preview.TrustedComms.InsightsPage>'
+            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 InsightsInstance < InstanceResource
+            ##
+            # Initialize the InsightsInstance
+            # @param [Version] version Version that contains the resource
+            # @param [Hash] payload payload that contains response from Twilio
+            # @param [String] business_sid A 34 character string that uniquely identifies this
+            #   Business.
+            # @return [InsightsInstance] InsightsInstance
+            def initialize(version, payload, business_sid: nil)
+              super(version)
+            end
+
+            ##
+            # Provide a user friendly representation
+            def to_s
+              "<Twilio.Preview.TrustedComms.InsightsInstance>"
+            end
+
+            ##
+            # Provide a detailed, user friendly representation
+            def inspect
+              "<Twilio.Preview.TrustedComms.InsightsInstance>"
+            end
+          end
+        end
+      end
+    end
+  end
+end