twilio-ruby 5.50.0 → 5.51.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f7085537c4bc32f13dec0386382dcc5d1d06d5e54e8d2cb68d248a14333c5cbc
-  data.tar.gz: 4040e5e1656acea416f745a91d6bcd7fe804b0bbc48c00c60c6f81d294420d3a
+  metadata.gz: fe0a077fb4499a65063ab675b16e0f03e36020d23e08472076177070fca80fb7
+  data.tar.gz: a44a751b49ef24c9101dd277f8a210e1e0473bc1a71184e7926765e493329a3f
 SHA512:
-  metadata.gz: e2385b8246c00836a3628f996c8318bcd4314d8987e2792cc48e084627a2cdf2ad9ff1bc3eff48b762d18d3afda374c58d6f8b70ead78b4951082a528dbf98d0
-  data.tar.gz: decfc8a842d6e461c3bcfe4cecf8b810b3d78e0daa396b043102c49930bbc2f40d18394a0174834e2cc0a56b52a176970b3c613ee8b5c1ba13028cf08d19db37
+  metadata.gz: d582b7d61865ef2951ddc1822f7645a72d6a30c7a5cfbf8bb131076c1569bd24f4da0b7ee31d709c9e1d30cb595d3678fed85e467f99b232abcc4cc5d2c669f5
+  data.tar.gz: 855ce01fe7b39596b6b717a97720ab796864eab3e22fbd3a90cac9e5617dca8c9d9ea8dd0cf2f672af0f8d164ad1bc17a831046de84f86abdb83f507c25d7159

data/CHANGES.md

@@ -1,6 +1,38 @@
 twilio-ruby changelog
 =====================
 
+[2021-04-07] Version 5.51.0
+---------------------------
+**Library - Chore**
+- [PR #551](https://github.com/twilio/twilio-ruby/pull/551): omit spec/ from .gem file. Thanks to [@mroach](https://github.com/mroach)!
+
+**Api**
+- Added `announcement` event to conference status callback events
+- Removed optional property `time_limit` in the call create request. **(breaking change)**
+
+**Messaging**
+- Add rate_limits field to Messaging Services US App To Person API
+- Add usecase field in Service API for fetch, create, update, read
+- Add us app to person api and us app to person usecase api as dependents in service
+- Add us_app_to_person_registered field in service api for fetch, read, create, update
+- Add us app to person api
+- Add us app to person usecase api
+- Add A2P external campaign api
+- Add Usecases API
+
+**Supersim**
+- Add Create endpoint to Sims resource
+
+**Verify**
+- The `Binding` field is now returned when creating a `Factor`. This value won't be returned for other endpoints.
+
+**Video**
+- [Rooms] max_concurrent_published_tracks has got GA maturity
+
+**Twiml**
+- Add `announcement` event to `statusCallbackEvent` for `<Conference>`.
+
+
 [2021-03-24] Version 5.50.0
 ---------------------------
 **Api**

data/README.md

@@ -34,13 +34,13 @@ This library supports the following Ruby implementations:
 To install using [Bundler][bundler] grab the latest stable version:
 
 ```ruby
-gem 'twilio-ruby', '~> 5.50.0'
+gem 'twilio-ruby', '~> 5.51.0'
 ```
 
 To manually install `twilio-ruby` via [Rubygems][rubygems] simply gem install:
 
 ```bash
-gem install twilio-ruby -v 5.50.0
+gem install twilio-ruby -v 5.51.0
 ```
 
 To build and install the development branch yourself from the latest source:

data/lib/twilio-ruby/rest/api/v2010/account/call.rb

@@ -151,8 +151,6 @@ module Twilio
             #   `inbound`, `outbound` or `both`. The default is `both`. `inbound` records the
             #   audio that is received by Twilio. `outbound` records the audio that is generated
             #   from Twilio. `both` records the audio that is received and generated by Twilio.
-            # @param [String] time_limit The maximum duration of the call in seconds.
-            #   Constraints depend on account and configuration.
             # @param [String] url The absolute URL that returns the TwiML instructions for the
             #   call. We will call this URL using the `method` when the call connects. For more
             #   information, see the {Url
@@ -164,7 +162,7 @@ module Twilio
             # @param [String] application_sid The SID of the Application resource that will
             #   handle the call, if the call will be handled by an application.
             # @return [CallInstance] Created CallInstance
-            def create(to: nil, from: nil, method: :unset, fallback_url: :unset, fallback_method: :unset, status_callback: :unset, status_callback_event: :unset, status_callback_method: :unset, send_digits: :unset, timeout: :unset, record: :unset, recording_channels: :unset, recording_status_callback: :unset, recording_status_callback_method: :unset, sip_auth_username: :unset, sip_auth_password: :unset, machine_detection: :unset, machine_detection_timeout: :unset, recording_status_callback_event: :unset, trim: :unset, caller_id: :unset, machine_detection_speech_threshold: :unset, machine_detection_speech_end_threshold: :unset, machine_detection_silence_timeout: :unset, async_amd: :unset, async_amd_status_callback: :unset, async_amd_status_callback_method: :unset, byoc: :unset, call_reason: :unset, call_token: :unset, recording_track: :unset, time_limit: :unset, url: :unset, twiml: :unset, application_sid: :unset)
+            def create(to: nil, from: nil, method: :unset, fallback_url: :unset, fallback_method: :unset, status_callback: :unset, status_callback_event: :unset, status_callback_method: :unset, send_digits: :unset, timeout: :unset, record: :unset, recording_channels: :unset, recording_status_callback: :unset, recording_status_callback_method: :unset, sip_auth_username: :unset, sip_auth_password: :unset, machine_detection: :unset, machine_detection_timeout: :unset, recording_status_callback_event: :unset, trim: :unset, caller_id: :unset, machine_detection_speech_threshold: :unset, machine_detection_speech_end_threshold: :unset, machine_detection_silence_timeout: :unset, async_amd: :unset, async_amd_status_callback: :unset, async_amd_status_callback_method: :unset, byoc: :unset, call_reason: :unset, call_token: :unset, recording_track: :unset, url: :unset, twiml: :unset, application_sid: :unset)
               data = Twilio::Values.of({
                   'To' => to,
                   'From' => from,
@@ -200,7 +198,6 @@ module Twilio
                   'CallReason' => call_reason,
                   'CallToken' => call_token,
                   'RecordingTrack' => recording_track,
-                  'TimeLimit' => time_limit,
               })
 
               payload = @version.create('POST', @uri, data: data)

data/lib/twilio-ruby/rest/api/v2010/account/conference/participant.rb

@@ -107,8 +107,8 @@ module Twilio
               #   `POST`.
               # @param [Array[String]] conference_status_callback_event The conference state
               #   changes that should generate a call to `conference_status_callback`. Can be:
-              #   `start`, `end`, `join`, `leave`, `mute`, `hold`, and `speaker`. Separate
-              #   multiple values with a space. Defaults to `start end`.
+              #   `start`, `end`, `join`, `leave`, `mute`, `hold`, `speaker`, and `announcement`.
+              #   Separate multiple values with a space. Defaults to `start end`.
               # @param [String] recording_channels The recording channels for the final
               #   recording. Can be: `mono` or `dual` and the default is `mono`.
               # @param [String] recording_status_callback The URL that we should call using the

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

@@ -42,6 +42,12 @@ module Twilio
         self.v1.deactivations()
       end
 
+      ##
+      # @return [Twilio::REST::Messaging::V1::ExternalCampaignInstance]
+      def external_campaign
+        self.v1.external_campaign()
+      end
+
       ##
       # @param [String] sid The unique string that we created to identify the Service
       #   resource.
@@ -51,6 +57,12 @@ module Twilio
         self.v1.services(sid)
       end
 
+      ##
+      # @return [Twilio::REST::Messaging::V1::UsecaseInstance]
+      def usecases
+        self.v1.usecases()
+      end
+
       ##
       # Provide a user friendly representation
       def to_s

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

@@ -17,7 +17,9 @@ module Twilio
           @version = 'v1'
           @brand_registrations = nil
           @deactivations = nil
+          @external_campaign = nil
           @services = nil
+          @usecases = nil
         end
 
         ##
@@ -41,6 +43,12 @@ module Twilio
           @deactivations ||= DeactivationsContext.new self
         end
 
+        ##
+        # @return [Twilio::REST::Messaging::V1::ExternalCampaignContext]
+        def external_campaign
+          @external_campaign ||= ExternalCampaignList.new self
+        end
+
         ##
         # @param [String] sid The SID of the Service resource to fetch.
         # @return [Twilio::REST::Messaging::V1::ServiceContext] if sid was passed.
@@ -56,6 +64,12 @@ module Twilio
           end
         end
 
+        ##
+        # @return [Twilio::REST::Messaging::V1::UsecaseContext]
+        def usecases
+          @usecases ||= UsecaseList.new self
+        end
+
         ##
         # Provide a user friendly representation
         def to_s

data/lib/twilio-ruby/rest/messaging/v1/external_campaign.rb

@@ -0,0 +1,143 @@
+##
+# This code was generated by
+# \ / _    _  _|   _  _
+#  | (_)\/(_)(_|\/| |(/_  v1.0.0
+#       /       /
+#
+# frozen_string_literal: true
+
+module Twilio
+  module REST
+    class Messaging < Domain
+      class V1 < Version
+        ##
+        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+        class ExternalCampaignList < ListResource
+          ##
+          # Initialize the ExternalCampaignList
+          # @param [Version] version Version that contains the resource
+          # @return [ExternalCampaignList] ExternalCampaignList
+          def initialize(version)
+            super(version)
+
+            # Path Solution
+            @solution = {}
+            @uri = "/Services/PreregisteredUsa2p"
+          end
+
+          ##
+          # Create the ExternalCampaignInstance
+          # @param [String] campaign_id ID of the preregistered campaign.
+          # @param [String] messaging_service_sid The SID of the {Messaging
+          #   Service}[https://www.twilio.com/docs/messaging/services/api] that the resource
+          #   is associated with.
+          # @return [ExternalCampaignInstance] Created ExternalCampaignInstance
+          def create(campaign_id: nil, messaging_service_sid: nil)
+            data = Twilio::Values.of({
+                'CampaignId' => campaign_id,
+                'MessagingServiceSid' => messaging_service_sid,
+            })
+
+            payload = @version.create('POST', @uri, data: data)
+
+            ExternalCampaignInstance.new(@version, payload, )
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            '#<Twilio.Messaging.V1.ExternalCampaignList>'
+          end
+        end
+
+        ##
+        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+        class ExternalCampaignPage < Page
+          ##
+          # Initialize the ExternalCampaignPage
+          # @param [Version] version Version that contains the resource
+          # @param [Response] response Response from the API
+          # @param [Hash] solution Path solution for the resource
+          # @return [ExternalCampaignPage] ExternalCampaignPage
+          def initialize(version, response, solution)
+            super(version, response)
+
+            # Path Solution
+            @solution = solution
+          end
+
+          ##
+          # Build an instance of ExternalCampaignInstance
+          # @param [Hash] payload Payload response from the API
+          # @return [ExternalCampaignInstance] ExternalCampaignInstance
+          def get_instance(payload)
+            ExternalCampaignInstance.new(@version, payload, )
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            '<Twilio.Messaging.V1.ExternalCampaignPage>'
+          end
+        end
+
+        ##
+        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+        class ExternalCampaignInstance < InstanceResource
+          ##
+          # Initialize the ExternalCampaignInstance
+          # @param [Version] version Version that contains the resource
+          # @param [Hash] payload payload that contains response from Twilio
+          # @return [ExternalCampaignInstance] ExternalCampaignInstance
+          def initialize(version, payload)
+            super(version)
+
+            # Marshaled Properties
+            @properties = {
+                'account_sid' => payload['account_sid'],
+                'campaign_id' => payload['campaign_id'],
+                'messaging_service_sid' => payload['messaging_service_sid'],
+                'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']),
+            }
+          end
+
+          ##
+          # @return [String] The SID of the Account that created the resource
+          def account_sid
+            @properties['account_sid']
+          end
+
+          ##
+          # @return [String] ID of the preregistered campaign.
+          def campaign_id
+            @properties['campaign_id']
+          end
+
+          ##
+          # @return [String] The SID of the Messaging Service the resource is associated with
+          def messaging_service_sid
+            @properties['messaging_service_sid']
+          end
+
+          ##
+          # @return [Time] The ISO 8601 date and time in GMT when the resource was created
+          def date_created
+            @properties['date_created']
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            "<Twilio.Messaging.V1.ExternalCampaignInstance>"
+          end
+
+          ##
+          # Provide a detailed, user friendly representation
+          def inspect
+            "<Twilio.Messaging.V1.ExternalCampaignInstance>"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/twilio-ruby/rest/messaging/v1/service.rb

@@ -223,6 +223,8 @@ module Twilio
             @phone_numbers = nil
             @short_codes = nil
             @alpha_senders = nil
+            @us_app_to_person = nil
+            @us_app_to_person_usecases = nil
           end
 
           ##
@@ -356,6 +358,33 @@ module Twilio
             @alpha_senders
           end
 
+          ##
+          # Access the us_app_to_person
+          # @return [UsAppToPersonList]
+          # @return [UsAppToPersonContext]
+          def us_app_to_person
+            unless @us_app_to_person
+              @us_app_to_person = UsAppToPersonList.new(@version, messaging_service_sid: @solution[:sid], )
+            end
+
+            @us_app_to_person
+          end
+
+          ##
+          # Access the us_app_to_person_usecases
+          # @return [UsAppToPersonUsecaseList]
+          # @return [UsAppToPersonUsecaseContext]
+          def us_app_to_person_usecases
+            unless @us_app_to_person_usecases
+              @us_app_to_person_usecases = UsAppToPersonUsecaseList.new(
+                  @version,
+                  messaging_service_sid: @solution[:sid],
+              )
+            end
+
+            @us_app_to_person_usecases
+          end
+
           ##
           # Provide a user friendly representation
           def to_s
@@ -635,6 +664,20 @@ module Twilio
             context.alpha_senders
           end
 
+          ##
+          # Access the us_app_to_person
+          # @return [us_app_to_person] us_app_to_person
+          def us_app_to_person
+            context.us_app_to_person
+          end
+
+          ##
+          # Access the us_app_to_person_usecases
+          # @return [us_app_to_person_usecases] us_app_to_person_usecases
+          def us_app_to_person_usecases
+            context.us_app_to_person_usecases
+          end
+
           ##
           # Provide a user friendly representation
           def to_s

data/lib/twilio-ruby/rest/messaging/v1/service/us_app_to_person.rb

@@ -0,0 +1,266 @@
+##
+# This code was generated by
+# \ / _    _  _|   _  _
+#  | (_)\/(_)(_|\/| |(/_  v1.0.0
+#       /       /
+#
+# frozen_string_literal: true
+
+module Twilio
+  module REST
+    class Messaging < Domain
+      class V1 < Version
+        class ServiceContext < InstanceContext
+          ##
+          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+          class UsAppToPersonList < ListResource
+            ##
+            # Initialize the UsAppToPersonList
+            # @param [Version] version Version that contains the resource
+            # @param [String] messaging_service_sid The SID of the {Messaging
+            #   Service}[https://www.twilio.com/docs/messaging/services/api] that the resource
+            #   is associated with.
+            # @return [UsAppToPersonList] UsAppToPersonList
+            def initialize(version, messaging_service_sid: nil)
+              super(version)
+
+              # Path Solution
+              @solution = {messaging_service_sid: messaging_service_sid}
+              @uri = "/Services/#{@solution[:messaging_service_sid]}/Compliance/Usa2p"
+            end
+
+            ##
+            # Create the UsAppToPersonInstance
+            # @param [String] brand_registration_sid A2P Brand Registration SID
+            # @param [String] description A short description of what this SMS campaign does.
+            # @param [Array[String]] message_samples Message samples, up to 5 sample messages,
+            #   <=1024 chars each.
+            # @param [String] us_app_to_person_usecase A2P Campaign Use Case. Examples: [ 2FA,
+            #   EMERGENCY, MARKETING..]
+            # @param [Boolean] has_embedded_links Indicates that this SMS campaign will send
+            #   messages that contain links.
+            # @param [Boolean] has_embedded_phone Indicates that this SMS campaign will send
+            #   messages that contain phone numbers.
+            # @return [UsAppToPersonInstance] Created UsAppToPersonInstance
+            def create(brand_registration_sid: nil, description: nil, message_samples: nil, us_app_to_person_usecase: nil, has_embedded_links: nil, has_embedded_phone: nil)
+              data = Twilio::Values.of({
+                  'BrandRegistrationSid' => brand_registration_sid,
+                  'Description' => description,
+                  'MessageSamples' => Twilio.serialize_list(message_samples) { |e| e },
+                  'UsAppToPersonUsecase' => us_app_to_person_usecase,
+                  'HasEmbeddedLinks' => has_embedded_links,
+                  'HasEmbeddedPhone' => has_embedded_phone,
+              })
+
+              payload = @version.create('POST', @uri, data: data)
+
+              UsAppToPersonInstance.new(
+                  @version,
+                  payload,
+                  messaging_service_sid: @solution[:messaging_service_sid],
+              )
+            end
+
+            ##
+            # Delete the UsAppToPersonInstance
+            # @return [Boolean] true if delete succeeds, false otherwise
+            def delete
+               @version.delete('DELETE', @uri)
+            end
+
+            ##
+            # Fetch the UsAppToPersonInstance
+            # @return [UsAppToPersonInstance] Fetched UsAppToPersonInstance
+            def fetch
+              payload = @version.fetch('GET', @uri)
+
+              UsAppToPersonInstance.new(
+                  @version,
+                  payload,
+                  messaging_service_sid: @solution[:messaging_service_sid],
+              )
+            end
+
+            ##
+            # Provide a user friendly representation
+            def to_s
+              '#<Twilio.Messaging.V1.UsAppToPersonList>'
+            end
+          end
+
+          ##
+          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+          class UsAppToPersonPage < Page
+            ##
+            # Initialize the UsAppToPersonPage
+            # @param [Version] version Version that contains the resource
+            # @param [Response] response Response from the API
+            # @param [Hash] solution Path solution for the resource
+            # @return [UsAppToPersonPage] UsAppToPersonPage
+            def initialize(version, response, solution)
+              super(version, response)
+
+              # Path Solution
+              @solution = solution
+            end
+
+            ##
+            # Build an instance of UsAppToPersonInstance
+            # @param [Hash] payload Payload response from the API
+            # @return [UsAppToPersonInstance] UsAppToPersonInstance
+            def get_instance(payload)
+              UsAppToPersonInstance.new(
+                  @version,
+                  payload,
+                  messaging_service_sid: @solution[:messaging_service_sid],
+              )
+            end
+
+            ##
+            # Provide a user friendly representation
+            def to_s
+              '<Twilio.Messaging.V1.UsAppToPersonPage>'
+            end
+          end
+
+          ##
+          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
+          class UsAppToPersonInstance < InstanceResource
+            ##
+            # Initialize the UsAppToPersonInstance
+            # @param [Version] version Version that contains the resource
+            # @param [Hash] payload payload that contains response from Twilio
+            # @param [String] messaging_service_sid The SID of the {Messaging
+            #   Service}[https://www.twilio.com/docs/messaging/services/api] that the resource
+            #   is associated with.
+            # @return [UsAppToPersonInstance] UsAppToPersonInstance
+            def initialize(version, payload, messaging_service_sid: nil)
+              super(version)
+
+              # Marshaled Properties
+              @properties = {
+                  'account_sid' => payload['account_sid'],
+                  'brand_registration_sid' => payload['brand_registration_sid'],
+                  'messaging_service_sid' => payload['messaging_service_sid'],
+                  'description' => payload['description'],
+                  'message_samples' => payload['message_samples'],
+                  'us_app_to_person_usecase' => payload['us_app_to_person_usecase'],
+                  'has_embedded_links' => payload['has_embedded_links'],
+                  'has_embedded_phone' => payload['has_embedded_phone'],
+                  'status' => payload['status'],
+                  'campaign_id' => payload['campaign_id'],
+                  'is_externally_registered' => payload['is_externally_registered'],
+                  'rate_limits' => payload['rate_limits'],
+                  'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']),
+                  'date_updated' => Twilio.deserialize_iso8601_datetime(payload['date_updated']),
+                  'url' => payload['url'],
+              }
+            end
+
+            ##
+            # @return [String] The SID of the Account that created the resource
+            def account_sid
+              @properties['account_sid']
+            end
+
+            ##
+            # @return [String] A2P Brand Registration SID
+            def brand_registration_sid
+              @properties['brand_registration_sid']
+            end
+
+            ##
+            # @return [String] The SID of the Messaging Service the resource is associated with
+            def messaging_service_sid
+              @properties['messaging_service_sid']
+            end
+
+            ##
+            # @return [String] A short description of what this SMS campaign does
+            def description
+              @properties['description']
+            end
+
+            ##
+            # @return [Array[String]] Message samples
+            def message_samples
+              @properties['message_samples']
+            end
+
+            ##
+            # @return [String] A2P Campaign Use Case.
+            def us_app_to_person_usecase
+              @properties['us_app_to_person_usecase']
+            end
+
+            ##
+            # @return [Boolean] Indicate that this SMS campaign will send messages that contain links
+            def has_embedded_links
+              @properties['has_embedded_links']
+            end
+
+            ##
+            # @return [Boolean] Indicates that this SMS campaign will send messages that contain phone numbers
+            def has_embedded_phone
+              @properties['has_embedded_phone']
+            end
+
+            ##
+            # @return [String] Campaign status
+            def status
+              @properties['status']
+            end
+
+            ##
+            # @return [String] The Campaign Registry (TCR) Campaign ID.
+            def campaign_id
+              @properties['campaign_id']
+            end
+
+            ##
+            # @return [Boolean] Indicates whether the campaign was registered externally or not
+            def is_externally_registered
+              @properties['is_externally_registered']
+            end
+
+            ##
+            # @return [Hash] Rate limit and/or classification set by each carrier
+            def rate_limits
+              @properties['rate_limits']
+            end
+
+            ##
+            # @return [Time] The ISO 8601 date and time in GMT when the resource was created
+            def date_created
+              @properties['date_created']
+            end
+
+            ##
+            # @return [Time] The ISO 8601 date and time in GMT when the resource was last updated
+            def date_updated
+              @properties['date_updated']
+            end
+
+            ##
+            # @return [String] The absolute URL of the US App to Person resource
+            def url
+              @properties['url']
+            end
+
+            ##
+            # Provide a user friendly representation
+            def to_s
+              "<Twilio.Messaging.V1.UsAppToPersonInstance>"
+            end
+
+            ##
+            # Provide a detailed, user friendly representation
+            def inspect
+              "<Twilio.Messaging.V1.UsAppToPersonInstance>"
+            end
+          end
+        end
+      end
+    end
+  end
+end