twilio-ruby 5.72.0 → 5.77.0

data/advanced-examples/custom-http-client.md

@@ -0,0 +1,170 @@
+# Custom HTTP Clients for the Twilio Ruby Helper Library
+
+If you are working with the Twilio Ruby Helper Library, and you need to be able to modify the HTTP requests that the library makes to the Twilio servers, you’re in the right place. The most common need to alter the HTTP request is to connect and authenticate with an enterprise’s proxy server. We’ll provide sample code that you can drop right into your app to handle this use case.
+
+Connect and authenticate with a proxy server
+To connect and provide credentials to a proxy server that may be between your app and Twilio, you need a way to modify the HTTP requests that the Twilio helper library makes on your behalf to invoke the Twilio REST API.
+
+The Twilio Ruby helper library uses the [Faraday](https://rubygems.org/gems/faraday) gem under the hood to make the HTTP requests. The following example shows a typical request, without a custom `http_client`:
+
+```rb
+@client = Twilio::REST::Client.new(account_sid, auth_token)
+
+message = @client.messages
+  .create(
+    to: "+15558675310",
+    body: "Hey there!",
+    from: "+15017122661",
+  )
+```
+
+Out of the box, the helper library is creating a default `Twilio::Http::Client` for you, using the Twilio credentials you provide. However, you can create your own `Twilio::Http::Client`, and pass it to any Twilio REST API resource action you want.
+
+Here’s an example of sending an SMS message with a custom client:
+
+```rb
+# Download the helper library from https://www.twilio.com/docs/ruby/install
+require "rubygems"
+require "twilio-ruby"
+require "dotenv/load"
+
+# Custom HTTP Client
+require_relative "MyRequestClass"
+
+# Your Account Sid and Auth Token from twilio.com/console
+account_sid = ENV["ACCOUNT_SID"]
+auth_token = ENV["AUTH_TOKEN"]
+proxy_address = ENV["PROXY_ADDRESS"]
+proxy_protocol = ENV["PROXY_PROTOCOL"]
+proxy_port = ENV["PROXY_PORT"]
+
+my_request_client = MyRequestClass.new(proxy_protocol, proxy_address, proxy_port)
+
+@client = Twilio::REST::Client.new(account_sid, auth_token,
+                                   nil, nil, my_request_client)
+
+message = @client.messages
+  .create(
+    to: "+593978613041",
+    body: "RB This is the ship that made the Kesssssel Run in fourteen parsecs?",
+    from: "+13212855389",
+  )
+
+puts "Message SID: #{message.sid}"
+```
+
+## Create your custom TwilioRestClient
+
+When you take a closer look at the constructor for `Twilio::Http::Client`, you see that this class provides it to the Twilio helper library to make the necessary HTTP requests.
+
+## Call Twilio through the proxy server
+
+Now that we understand how all the components fit together, we can create our own `http_client` that can connect through a proxy server. To make this reusable, here’s a class that you can use to create this `http_client` whenever you need one.
+
+```rb
+class MyRequestClass
+  attr_accessor :adapter
+  attr_reader :timeout, :last_response, :last_request
+
+  def initialize(proxy_prot = nil, proxy_addr = nil, proxy_port = nil, timeout: nil)
+    @proxy_prot = proxy_prot
+    @proxy_addr = proxy_addr
+    @proxy_port = proxy_port
+    @timeout = timeout
+    @adapter = Faraday.default_adapter
+  end
+
+  def _request(request)
+    @connection = Faraday.new(url: request.host + ":" + request.port.to_s, ssl: { verify: true }) do |f|
+      f.options.params_encoder = Faraday::FlatParamsEncoder
+      f.request :url_encoded
+      f.adapter @adapter
+      f.headers = request.headers
+      f.basic_auth(request.auth[0], request.auth[1])
+      if @proxy_addr
+        f.proxy = "#{@proxy_prot}://#{@proxy_addr}:#{@proxy_port}"
+      end
+      f.options.open_timeout = request.timeout || @timeout
+      f.options.timeout = request.timeout || @timeout
+    end
+
+    @last_request = request
+    @last_response = nil
+    response = @connection.send(request.method.downcase.to_sym,
+                                request.url,
+                                request.method == "GET" ? request.params : request.data)
+
+    if response.body && !response.body.empty?
+      object = response.body
+    elsif response.status == 400
+      object = { message: "Bad request", code: 400 }.to_json
+    end
+
+    twilio_response = Twilio::Response.new(response.status, object, headers: response.headers)
+    @last_response = twilio_response
+
+    twilio_response
+  end
+
+  def request(host, port, method, url, params = {}, data = {}, headers = {}, auth = nil, timeout = nil)
+    request = Twilio::Request.new(host, port, method, url, params, data, headers, auth, timeout)
+    _request(request)
+  end
+end
+```
+
+In this example, we are using some environment variables loaded at the program startup to retrieve various configuration settings:
+
+- Your Twilio Account Sid and Auth Token ([found here, in the Twilio console](https://console.twilio.com))
+- A proxy address in the form of `http://127.0.0.1:8888`
+
+These settings are located in a file like `.env` like so:
+
+```env
+ACCOUNT_SID=ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+AUTH_TOKEN= your_auth_token
+
+HTTPS_PROXY=https://127.0.0.1:8888
+HTTP_PROXY=http://127.0.0.1:8888
+```
+
+Here’s the full console program that sends a text message and shows how it all can work together. It loads the `.env` file.
+
+```rb
+# Download the helper library from https://www.twilio.com/docs/ruby/install
+require "rubygems"
+require "twilio-ruby"
+require "dotenv/load"
+
+# Custom HTTP Client
+require_relative "MyRequestClass"
+
+# Your Account Sid and Auth Token from twilio.com/console
+account_sid = ENV["ACCOUNT_SID"]
+auth_token = ENV["AUTH_TOKEN"]
+proxy_address = ENV["PROXY_ADDRESS"]
+proxy_protocol = ENV["PROXY_PROTOCOL"]
+proxy_port = ENV["PROXY_PORT"]
+
+my_request_client = MyRequestClass.new(proxy_protocol, proxy_address, proxy_port)
+
+@client = Twilio::REST::Client.new(account_sid, auth_token,
+                                   nil, nil, my_request_client)
+
+message = @client.messages
+  .create(
+    to: "+593978613041",
+    body: "RB This is the ship that made the Kesssssel Run in fourteen parsecs?",
+    from: "+13212855389",
+  )
+
+puts "Message SID: #{message.sid}"
+```
+
+## What else can this technique be used for?
+
+Now that you know how to inject your own `http_client` into the Twilio API request pipeline, you could use this technique to add custom HTTP headers and authorization to the requests (perhaps as required by an upstream proxy server).
+
+You could also implement your own `http_client` to mock the Twilio API responses so your unit and integration tests can run quickly without the need to make a connection to Twilio. In fact, there’s already an example online showing [how to do exactly that with Node.js and Prism](https://www.twilio.com/docs/openapi/mock-api-generation-with-twilio-openapi-spec).
+
+We can’t wait to see what you build!

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

@@ -43,8 +43,10 @@ module Twilio
             #   the address. Can be: `true` or `false` and the default is `true`. If empty or
             #   `true`, we will correct the address you provide if necessary. If `false`, we
             #   won't alter the address you provide.
+            # @param [String] street_secondary The additional number and street address of the
+            #   address.
             # @return [AddressInstance] Created AddressInstance
-            def create(customer_name: nil, street: nil, city: nil, region: nil, postal_code: nil, iso_country: nil, friendly_name: :unset, emergency_enabled: :unset, auto_correct_address: :unset)
+            def create(customer_name: nil, street: nil, city: nil, region: nil, postal_code: nil, iso_country: nil, friendly_name: :unset, emergency_enabled: :unset, auto_correct_address: :unset, street_secondary: :unset)
               data = Twilio::Values.of({
                   'CustomerName' => customer_name,
                   'Street' => street,
@@ -55,6 +57,7 @@ module Twilio
                   'FriendlyName' => friendly_name,
                   'EmergencyEnabled' => emergency_enabled,
                   'AutoCorrectAddress' => auto_correct_address,
+                  'StreetSecondary' => street_secondary,
               })
 
               payload = @version.create('POST', @uri, data: data)
@@ -262,8 +265,10 @@ module Twilio
             #   the address. Can be: `true` or `false` and the default is `true`. If empty or
             #   `true`, we will correct the address you provide if necessary. If `false`, we
             #   won't alter the address you provide.
+            # @param [String] street_secondary The additional number and street address of the
+            #   address.
             # @return [AddressInstance] Updated AddressInstance
-            def update(friendly_name: :unset, customer_name: :unset, street: :unset, city: :unset, region: :unset, postal_code: :unset, emergency_enabled: :unset, auto_correct_address: :unset)
+            def update(friendly_name: :unset, customer_name: :unset, street: :unset, city: :unset, region: :unset, postal_code: :unset, emergency_enabled: :unset, auto_correct_address: :unset, street_secondary: :unset)
               data = Twilio::Values.of({
                   'FriendlyName' => friendly_name,
                   'CustomerName' => customer_name,
@@ -273,6 +278,7 @@ module Twilio
                   'PostalCode' => postal_code,
                   'EmergencyEnabled' => emergency_enabled,
                   'AutoCorrectAddress' => auto_correct_address,
+                  'StreetSecondary' => street_secondary,
               })
 
               payload = @version.update('POST', @uri, data: data)
@@ -342,6 +348,7 @@ module Twilio
                   'emergency_enabled' => payload['emergency_enabled'],
                   'validated' => payload['validated'],
                   'verified' => payload['verified'],
+                  'street_secondary' => payload['street_secondary'],
               }
 
               # Context
@@ -450,6 +457,12 @@ module Twilio
               @properties['verified']
             end
 
+            ##
+            # @return [String] The additional number and street address of the address
+            def street_secondary
+              @properties['street_secondary']
+            end
+
             ##
             # Delete the AddressInstance
             # @return [Boolean] true if delete succeeds, false otherwise
@@ -479,8 +492,10 @@ module Twilio
             #   the address. Can be: `true` or `false` and the default is `true`. If empty or
             #   `true`, we will correct the address you provide if necessary. If `false`, we
             #   won't alter the address you provide.
+            # @param [String] street_secondary The additional number and street address of the
+            #   address.
             # @return [AddressInstance] Updated AddressInstance
-            def update(friendly_name: :unset, customer_name: :unset, street: :unset, city: :unset, region: :unset, postal_code: :unset, emergency_enabled: :unset, auto_correct_address: :unset)
+            def update(friendly_name: :unset, customer_name: :unset, street: :unset, city: :unset, region: :unset, postal_code: :unset, emergency_enabled: :unset, auto_correct_address: :unset, street_secondary: :unset)
               context.update(
                   friendly_name: friendly_name,
                   customer_name: customer_name,
@@ -490,6 +505,7 @@ module Twilio
                   postal_code: postal_code,
                   emergency_enabled: emergency_enabled,
                   auto_correct_address: auto_correct_address,
+                  street_secondary: street_secondary,
               )
             end
 

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

@@ -61,8 +61,11 @@ module Twilio
             #   method to send message status information to your application.
             # @param [String] friendly_name A descriptive string that you create to describe
             #   the new application. It can be up to 64 characters long.
+            # @param [Boolean] public_application_connect_enabled Whether to allow other
+            #   Twilio accounts to dial this applicaton using Dial verb. Can be: `true` or
+            #   `false`.
             # @return [ApplicationInstance] Created ApplicationInstance
-            def create(api_version: :unset, voice_url: :unset, voice_method: :unset, voice_fallback_url: :unset, voice_fallback_method: :unset, status_callback: :unset, status_callback_method: :unset, voice_caller_id_lookup: :unset, sms_url: :unset, sms_method: :unset, sms_fallback_url: :unset, sms_fallback_method: :unset, sms_status_callback: :unset, message_status_callback: :unset, friendly_name: :unset)
+            def create(api_version: :unset, voice_url: :unset, voice_method: :unset, voice_fallback_url: :unset, voice_fallback_method: :unset, status_callback: :unset, status_callback_method: :unset, voice_caller_id_lookup: :unset, sms_url: :unset, sms_method: :unset, sms_fallback_url: :unset, sms_fallback_method: :unset, sms_status_callback: :unset, message_status_callback: :unset, friendly_name: :unset, public_application_connect_enabled: :unset)
               data = Twilio::Values.of({
                   'ApiVersion' => api_version,
                   'VoiceUrl' => voice_url,
@@ -79,6 +82,7 @@ module Twilio
                   'SmsStatusCallback' => sms_status_callback,
                   'MessageStatusCallback' => message_status_callback,
                   'FriendlyName' => friendly_name,
+                  'PublicApplicationConnectEnabled' => public_application_connect_enabled,
               })
 
               payload = @version.create('POST', @uri, data: data)
@@ -283,8 +287,11 @@ module Twilio
             #   sent by the application. Deprecated, included for backwards compatibility.
             # @param [String] message_status_callback The URL we should call using a POST
             #   method to send message status information to your application.
+            # @param [Boolean] public_application_connect_enabled Whether to allow other
+            #   Twilio accounts to dial this applicaton using Dial verb. Can be: `true` or
+            #   `false`.
             # @return [ApplicationInstance] Updated ApplicationInstance
-            def update(friendly_name: :unset, api_version: :unset, voice_url: :unset, voice_method: :unset, voice_fallback_url: :unset, voice_fallback_method: :unset, status_callback: :unset, status_callback_method: :unset, voice_caller_id_lookup: :unset, sms_url: :unset, sms_method: :unset, sms_fallback_url: :unset, sms_fallback_method: :unset, sms_status_callback: :unset, message_status_callback: :unset)
+            def update(friendly_name: :unset, api_version: :unset, voice_url: :unset, voice_method: :unset, voice_fallback_url: :unset, voice_fallback_method: :unset, status_callback: :unset, status_callback_method: :unset, voice_caller_id_lookup: :unset, sms_url: :unset, sms_method: :unset, sms_fallback_url: :unset, sms_fallback_method: :unset, sms_status_callback: :unset, message_status_callback: :unset, public_application_connect_enabled: :unset)
               data = Twilio::Values.of({
                   'FriendlyName' => friendly_name,
                   'ApiVersion' => api_version,
@@ -301,6 +308,7 @@ module Twilio
                   'SmsFallbackMethod' => sms_fallback_method,
                   'SmsStatusCallback' => sms_status_callback,
                   'MessageStatusCallback' => message_status_callback,
+                  'PublicApplicationConnectEnabled' => public_application_connect_enabled,
               })
 
               payload = @version.update('POST', @uri, data: data)
@@ -364,6 +372,7 @@ module Twilio
                   'voice_fallback_url' => payload['voice_fallback_url'],
                   'voice_method' => payload['voice_method'],
                   'voice_url' => payload['voice_url'],
+                  'public_application_connect_enabled' => payload['public_application_connect_enabled'],
               }
 
               # Context
@@ -502,6 +511,12 @@ module Twilio
               @properties['voice_url']
             end
 
+            ##
+            # @return [Boolean] Whether to allow other Twilio accounts to dial this application
+            def public_application_connect_enabled
+              @properties['public_application_connect_enabled']
+            end
+
             ##
             # Delete the ApplicationInstance
             # @return [Boolean] true if delete succeeds, false otherwise
@@ -551,8 +566,11 @@ module Twilio
             #   sent by the application. Deprecated, included for backwards compatibility.
             # @param [String] message_status_callback The URL we should call using a POST
             #   method to send message status information to your application.
+            # @param [Boolean] public_application_connect_enabled Whether to allow other
+            #   Twilio accounts to dial this applicaton using Dial verb. Can be: `true` or
+            #   `false`.
             # @return [ApplicationInstance] Updated ApplicationInstance
-            def update(friendly_name: :unset, api_version: :unset, voice_url: :unset, voice_method: :unset, voice_fallback_url: :unset, voice_fallback_method: :unset, status_callback: :unset, status_callback_method: :unset, voice_caller_id_lookup: :unset, sms_url: :unset, sms_method: :unset, sms_fallback_url: :unset, sms_fallback_method: :unset, sms_status_callback: :unset, message_status_callback: :unset)
+            def update(friendly_name: :unset, api_version: :unset, voice_url: :unset, voice_method: :unset, voice_fallback_url: :unset, voice_fallback_method: :unset, status_callback: :unset, status_callback_method: :unset, voice_caller_id_lookup: :unset, sms_url: :unset, sms_method: :unset, sms_fallback_url: :unset, sms_fallback_method: :unset, sms_status_callback: :unset, message_status_callback: :unset, public_application_connect_enabled: :unset)
               context.update(
                   friendly_name: friendly_name,
                   api_version: api_version,
@@ -569,6 +587,7 @@ module Twilio
                   sms_fallback_method: sms_fallback_method,
                   sms_status_callback: sms_status_callback,
                   message_status_callback: message_status_callback,
+                  public_application_connect_enabled: public_application_connect_enabled,
               )
             end
 

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

@@ -391,8 +391,8 @@ module Twilio
                     'lata' => payload['lata'],
                     'locality' => payload['locality'],
                     'rate_center' => payload['rate_center'],
-                    'latitude' => payload['latitude'].to_f,
-                    'longitude' => payload['longitude'].to_f,
+                    'latitude' => payload['latitude'] == nil ? payload['latitude'] : payload['latitude'].to_f,
+                    'longitude' => payload['longitude'] == nil ? payload['longitude'] : payload['longitude'].to_f,
                     'region' => payload['region'],
                     'postal_code' => payload['postal_code'],
                     'iso_country' => payload['iso_country'],

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

@@ -391,8 +391,8 @@ module Twilio
                     'lata' => payload['lata'],
                     'locality' => payload['locality'],
                     'rate_center' => payload['rate_center'],
-                    'latitude' => payload['latitude'].to_f,
-                    'longitude' => payload['longitude'].to_f,
+                    'latitude' => payload['latitude'] == nil ? payload['latitude'] : payload['latitude'].to_f,
+                    'longitude' => payload['longitude'] == nil ? payload['longitude'] : payload['longitude'].to_f,
                     'region' => payload['region'],
                     'postal_code' => payload['postal_code'],
                     'iso_country' => payload['iso_country'],

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

@@ -391,8 +391,8 @@ module Twilio
                     'lata' => payload['lata'],
                     'locality' => payload['locality'],
                     'rate_center' => payload['rate_center'],
-                    'latitude' => payload['latitude'].to_f,
-                    'longitude' => payload['longitude'].to_f,
+                    'latitude' => payload['latitude'] == nil ? payload['latitude'] : payload['latitude'].to_f,
+                    'longitude' => payload['longitude'] == nil ? payload['longitude'] : payload['longitude'].to_f,
                     'region' => payload['region'],
                     'postal_code' => payload['postal_code'],
                     'iso_country' => payload['iso_country'],

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

@@ -391,8 +391,8 @@ module Twilio
                     'lata' => payload['lata'],
                     'locality' => payload['locality'],
                     'rate_center' => payload['rate_center'],
-                    'latitude' => payload['latitude'].to_f,
-                    'longitude' => payload['longitude'].to_f,
+                    'latitude' => payload['latitude'] == nil ? payload['latitude'] : payload['latitude'].to_f,
+                    'longitude' => payload['longitude'] == nil ? payload['longitude'] : payload['longitude'].to_f,
                     'region' => payload['region'],
                     'postal_code' => payload['postal_code'],
                     'iso_country' => payload['iso_country'],

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

@@ -391,8 +391,8 @@ module Twilio
                     'lata' => payload['lata'],
                     'locality' => payload['locality'],
                     'rate_center' => payload['rate_center'],
-                    'latitude' => payload['latitude'].to_f,
-                    'longitude' => payload['longitude'].to_f,
+                    'latitude' => payload['latitude'] == nil ? payload['latitude'] : payload['latitude'].to_f,
+                    'longitude' => payload['longitude'] == nil ? payload['longitude'] : payload['longitude'].to_f,
                     'region' => payload['region'],
                     'postal_code' => payload['postal_code'],
                     'iso_country' => payload['iso_country'],

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

@@ -391,8 +391,8 @@ module Twilio
                     'lata' => payload['lata'],
                     'locality' => payload['locality'],
                     'rate_center' => payload['rate_center'],
-                    'latitude' => payload['latitude'].to_f,
-                    'longitude' => payload['longitude'].to_f,
+                    'latitude' => payload['latitude'] == nil ? payload['latitude'] : payload['latitude'].to_f,
+                    'longitude' => payload['longitude'] == nil ? payload['longitude'] : payload['longitude'].to_f,
                     'region' => payload['region'],
                     'postal_code' => payload['postal_code'],
                     'iso_country' => payload['iso_country'],

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

@@ -391,8 +391,8 @@ module Twilio
                     'lata' => payload['lata'],
                     'locality' => payload['locality'],
                     'rate_center' => payload['rate_center'],
-                    'latitude' => payload['latitude'].to_f,
-                    'longitude' => payload['longitude'].to_f,
+                    'latitude' => payload['latitude'] == nil ? payload['latitude'] : payload['latitude'].to_f,
+                    'longitude' => payload['longitude'] == nil ? payload['longitude'] : payload['longitude'].to_f,
                     'region' => payload['region'],
                     'postal_code' => payload['postal_code'],
                     'iso_country' => payload['iso_country'],

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

@@ -188,7 +188,7 @@ module Twilio
                     'date_created' => Twilio.deserialize_rfc2822(payload['date_created']),
                     'date_updated' => Twilio.deserialize_rfc2822(payload['date_updated']),
                     'issues' => payload['issues'],
-                    'quality_score' => payload['quality_score'].to_i,
+                    'quality_score' => payload['quality_score'] == nil ? payload['quality_score'] : payload['quality_score'].to_i,
                     'sid' => payload['sid'],
                 }
 

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

@@ -163,16 +163,16 @@ module Twilio
                 # Marshaled Properties
                 @properties = {
                     'account_sid' => payload['account_sid'],
-                    'call_count' => payload['call_count'].to_i,
-                    'call_feedback_count' => payload['call_feedback_count'].to_i,
+                    'call_count' => payload['call_count'] == nil ? payload['call_count'] : payload['call_count'].to_i,
+                    'call_feedback_count' => payload['call_feedback_count'] == nil ? payload['call_feedback_count'] : payload['call_feedback_count'].to_i,
                     'date_created' => Twilio.deserialize_rfc2822(payload['date_created']),
                     'date_updated' => Twilio.deserialize_rfc2822(payload['date_updated']),
                     'end_date' => Twilio.deserialize_iso8601_date(payload['end_date']),
                     'include_subaccounts' => payload['include_subaccounts'],
                     'issues' => payload['issues'],
-                    'quality_score_average' => payload['quality_score_average'].to_f,
-                    'quality_score_median' => payload['quality_score_median'].to_f,
-                    'quality_score_standard_deviation' => payload['quality_score_standard_deviation'].to_f,
+                    'quality_score_average' => payload['quality_score_average'] == nil ? payload['quality_score_average'] : payload['quality_score_average'].to_f,
+                    'quality_score_median' => payload['quality_score_median'] == nil ? payload['quality_score_median'] : payload['quality_score_median'].to_f,
+                    'quality_score_standard_deviation' => payload['quality_score_standard_deviation'] == nil ? payload['quality_score_standard_deviation'] : payload['quality_score_standard_deviation'].to_f,
                     'sid' => payload['sid'],
                     'start_date' => Twilio.deserialize_iso8601_date(payload['start_date']),
                     'status' => payload['status'],

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

@@ -332,12 +332,12 @@ module Twilio
                     'start_time' => Twilio.deserialize_rfc2822(payload['start_time']),
                     'duration' => payload['duration'],
                     'sid' => payload['sid'],
-                    'price' => payload['price'].to_f,
+                    'price' => payload['price'] == nil ? payload['price'] : payload['price'].to_f,
                     'uri' => payload['uri'],
                     'encryption_details' => payload['encryption_details'],
                     'price_unit' => payload['price_unit'],
                     'status' => payload['status'],
-                    'channels' => payload['channels'].to_i,
+                    'channels' => payload['channels'] == nil ? payload['channels'] : payload['channels'].to_i,
                     'source' => payload['source'],
                     'error_code' => payload['error_code'] == nil ? payload['error_code'] : payload['error_code'].to_i,
                     'track' => payload['track'],

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

@@ -0,0 +1,160 @@
+##
+# This code was generated by
+# \ / _    _  _|   _  _
+#  | (_)\/(_)(_|\/| |(/_  v1.0.0
+#       /       /
+#
+# frozen_string_literal: true
+
+module Twilio
+  module REST
+    class Api < Domain
+      class V2010 < Version
+        class AccountContext < InstanceContext
+          class CallContext < InstanceContext
+            class UserDefinedMessageList < ListResource
+              ##
+              # Initialize the UserDefinedMessageList
+              # @param [Version] version Version that contains the resource
+              # @param [String] account_sid The SID of the
+              #   {Account}[https://www.twilio.com/docs/iam/api/account] that created User Defined
+              #   Message.
+              # @param [String] call_sid The SID of the
+              #   {Call}[https://www.twilio.com/docs/voice/api/call-resource] the User Defined
+              #   Message is associated with.
+              # @return [UserDefinedMessageList] UserDefinedMessageList
+              def initialize(version, account_sid: nil, call_sid: nil)
+                super(version)
+
+                # Path Solution
+                @solution = {account_sid: account_sid, call_sid: call_sid}
+                @uri = "/Accounts/#{@solution[:account_sid]}/Calls/#{@solution[:call_sid]}/UserDefinedMessages.json"
+              end
+
+              ##
+              # Create the UserDefinedMessageInstance
+              # @param [String] content The User Defined Message in the form of URL-encoded JSON
+              #   string.
+              # @param [String] idempotency_key A unique string value to identify API call. This
+              #   should be a unique string value per API call and can be a randomly generated.
+              # @return [UserDefinedMessageInstance] Created UserDefinedMessageInstance
+              def create(content: nil, idempotency_key: :unset)
+                data = Twilio::Values.of({'Content' => content, 'IdempotencyKey' => idempotency_key, })
+
+                payload = @version.create('POST', @uri, data: data)
+
+                UserDefinedMessageInstance.new(
+                    @version,
+                    payload,
+                    account_sid: @solution[:account_sid],
+                    call_sid: @solution[:call_sid],
+                )
+              end
+
+              ##
+              # Provide a user friendly representation
+              def to_s
+                '#<Twilio.Api.V2010.UserDefinedMessageList>'
+              end
+            end
+
+            class UserDefinedMessagePage < Page
+              ##
+              # Initialize the UserDefinedMessagePage
+              # @param [Version] version Version that contains the resource
+              # @param [Response] response Response from the API
+              # @param [Hash] solution Path solution for the resource
+              # @return [UserDefinedMessagePage] UserDefinedMessagePage
+              def initialize(version, response, solution)
+                super(version, response)
+
+                # Path Solution
+                @solution = solution
+              end
+
+              ##
+              # Build an instance of UserDefinedMessageInstance
+              # @param [Hash] payload Payload response from the API
+              # @return [UserDefinedMessageInstance] UserDefinedMessageInstance
+              def get_instance(payload)
+                UserDefinedMessageInstance.new(
+                    @version,
+                    payload,
+                    account_sid: @solution[:account_sid],
+                    call_sid: @solution[:call_sid],
+                )
+              end
+
+              ##
+              # Provide a user friendly representation
+              def to_s
+                '<Twilio.Api.V2010.UserDefinedMessagePage>'
+              end
+            end
+
+            class UserDefinedMessageInstance < InstanceResource
+              ##
+              # Initialize the UserDefinedMessageInstance
+              # @param [Version] version Version that contains the resource
+              # @param [Hash] payload payload that contains response from Twilio
+              # @param [String] account_sid The SID of the
+              #   {Account}[https://www.twilio.com/docs/iam/api/account] that created User Defined
+              #   Message.
+              # @param [String] call_sid The SID of the
+              #   {Call}[https://www.twilio.com/docs/voice/api/call-resource] the User Defined
+              #   Message is associated with.
+              # @return [UserDefinedMessageInstance] UserDefinedMessageInstance
+              def initialize(version, payload, account_sid: nil, call_sid: nil)
+                super(version)
+
+                # Marshaled Properties
+                @properties = {
+                    'account_sid' => payload['account_sid'],
+                    'call_sid' => payload['call_sid'],
+                    'sid' => payload['sid'],
+                    'date_created' => Twilio.deserialize_rfc2822(payload['date_created']),
+                }
+              end
+
+              ##
+              # @return [String] Account SID.
+              def account_sid
+                @properties['account_sid']
+              end
+
+              ##
+              # @return [String] Call SID.
+              def call_sid
+                @properties['call_sid']
+              end
+
+              ##
+              # @return [String] User Defined Message SID.
+              def sid
+                @properties['sid']
+              end
+
+              ##
+              # @return [Time] The date this User Defined Message was created.
+              def date_created
+                @properties['date_created']
+              end
+
+              ##
+              # Provide a user friendly representation
+              def to_s
+                "<Twilio.Api.V2010.UserDefinedMessageInstance>"
+              end
+
+              ##
+              # Provide a detailed, user friendly representation
+              def inspect
+                "<Twilio.Api.V2010.UserDefinedMessageInstance>"
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end