twilio-ruby 5.45.0 → 5.48.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4d11664418beb1659b2ee854fea2a14df842116c75edde8f66aa98c8b6cb9fd2
-  data.tar.gz: 4109ac807241c28fed2e425e74064bf1daaac49ec2360fa874568453797e148f
+  metadata.gz: 7ff540a9fa947040666a3768f2c5fe1e7be8809c6ab36d0367b8046f808495d9
+  data.tar.gz: 9b7d6b438eb9fa1453b914dd74f0cf26484bdeaa5c0276116a421c323d8c5093
 SHA512:
-  metadata.gz: 6a08b729a2859792323662ee8d9f4b9b4b93539d20485d3f7bb794dba44975e61d4c3178710ec488b6738db1cc30656aa0ae24530cde10d899165d9f152e94c0
-  data.tar.gz: ac04197fe55debf9afe2d08f4f79a4e56ca40488b99b02a038c999873c27775c9728e8d38adb6d3bdffae47894366a1aa34925da86409731555c90e7a4050e06
+  metadata.gz: 5e894f9eb7afc39ff72071668b2eb8f4f76c14937867d691762489e7dc4835e7deaa5690f9ed26b923c9cdac838c97c7b55a47eea374ede8b5ebc372ebfc1377
+  data.tar.gz: e6b8846bc652433306f33f6419779d75ae0cd870fb1ef7032c65c8abbcfea042ada5fcc326f73c7ffe66af603147be8f6832e3d95e72d0fdcec9e08b6e7d6e4c

data/.travis.yml

@@ -4,6 +4,7 @@ bundler_args: --without development
 
 rvm:
   - ruby-head
+  - 3.0
   - 2.7
   - 2.6
   - 2.5

data/CHANGES.md

@@ -1,6 +1,110 @@
 twilio-ruby changelog
 =====================
 
+[2021-02-24] Version 5.48.0
+---------------------------
+**Events**
+- Update description of types in the create sink resource
+
+**Messaging**
+- Add WA template header and footer
+- Remove A2P campaign and use cases API **(breaking change)**
+- Add number_registration_status field to read and fetch campaign responses
+
+**Trusthub**
+- Make all resources public
+
+**Verify**
+- Verify List Attempts API endpoints added.
+
+
+[2021-02-10] Version 5.47.0
+---------------------------
+**Library - Fix**
+- [PR #548](https://github.com/twilio/twilio-ruby/pull/548): shortcut syntax for new non-GA versions. Thanks to [@eshanholtz](https://github.com/eshanholtz)!
+
+**Api**
+- Revert change that conference participant create `from` and `to` param to be endpoint type for supporting client identifier and sip address
+- Update the conference participant create `from` and `to` param to be endpoint type for supporting client identifier and sip address
+
+**Events**
+- Documentation should state that no fields are PII
+
+**Flex**
+- Adding `notifications` and `markdown` to Flex Configuration
+
+**Messaging**
+- Add A2P use cases API
+- Add Brand Registrations API
+- Add Campaigns API
+
+**Serverless**
+- Add runtime field to Build response and as an optional parameter to the Build create endpoint.
+- Add @twilio/runtime-handler dependency to Build response example.
+
+**Sync**
+- Remove If-Match header for Document **(breaking change)**
+
+**Twiml**
+- Add `refer_url` and `refer_method` to `Dial`.
+
+
+[2021-01-27] Version 5.46.1
+---------------------------
+**Library - Docs**
+- [PR #547](https://github.com/twilio/twilio-ruby/pull/547): Document how to use an API Key. Thanks to [@davetron5000](https://github.com/davetron5000)!
+
+**Studio**
+- Studio V2 API is now GA
+
+**Supersim**
+- Allow updating `CommandsUrl` and `CommandsMethod` on a Fleet
+
+**Twiml**
+- Add `status_callback` and `status_callback_method` to `Stream`.
+
+
+[2021-01-13] Version 5.46.0
+---------------------------
+**Library - Docs**
+- [PR #546](https://github.com/twilio/twilio-ruby/pull/546): Fixing docs for list parameter types. Thanks to [@shwetha-manvinkurke](https://github.com/shwetha-manvinkurke)!
+
+**Library - Fix**
+- [PR #545](https://github.com/twilio/twilio-ruby/pull/545): Adds Ruby 3.0 to Travis. Fixes test. Thanks to [@philnash](https://github.com/philnash)!
+
+**Api**
+- Add 'Electric Imp v1 Usage' to usage categories
+
+**Conversations**
+- Changed `last_read_message_index` type in Participant's resource **(breaking change)**
+
+**Insights**
+- Added `created_time` to call summary.
+
+**Sync**
+- Remove HideExpired query parameter for filtering Sync Documents with expired **(breaking change)**
+
+**Video**
+- [Rooms] Expose maxConcurrentPublishedTracks property in Room resource
+
+
+[2020-12-16] Version 5.45.1
+---------------------------
+**Api**
+- Updated `call_event` default_output_properties to request and response.
+
+**Conversations**
+- Added `last_read_message_index` and `last_read_timestamp` to Participant's resource update operation
+- Added `is_notifiable` and `is_online` to User's resource
+- Added `reachability_enabled` parameters to update method for Conversation Service Configuration resource
+
+**Messaging**
+- Added WA template quick reply, URL, and phone number buttons
+
+**Twiml**
+- Add `sequential` to `Dial`.
+
+
 [2020-12-08] Version 5.45.0
 ---------------------------
 **Api**

data/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (C) 2020, Twilio, Inc. <help@twilio.com>
+Copyright (C) 2021, Twilio, Inc. <help@twilio.com>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of
 this software and associated documentation files (the "Software"), to deal in

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.45.0'
+gem 'twilio-ruby', '~> 5.48.0'
 ```
 
 To manually install `twilio-ruby` via [Rubygems][rubygems] simply gem install:
 
 ```bash
-gem install twilio-ruby -v 5.45.0
+gem install twilio-ruby -v 5.48.0
 ```
 
 To build and install the development branch yourself from the latest source:
@@ -66,6 +66,20 @@ auth_token = 'yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy'
 @client = Twilio::REST::Client.new account_sid, auth_token
 ```
 
+### Use An API Key
+
+```ruby
+require 'twilio-ruby'
+
+# put your own credentials here
+account_sid = 'ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
+api_key_sid = 'zzzzzzzzzzzzzzzzzzzzzz'
+api_key_secret = 'yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy'
+
+# set up a client to talk to the Twilio REST API using an API Key
+@client = Twilio::REST::Client.new api_key_sid, api_key_secret, account_sid
+```
+
 ### Specify a Region and/or Edge
 
 To take advantage of Twilio's [Global Infrastructure](https://www.twilio.com/docs/global-infrastructure), specify the target Region and/or Edge for the client:

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

@@ -288,7 +288,7 @@ module Twilio
             end
 
             ##
-            # @return [authorized_connect_app.Permission] Permissions authorized to the app
+            # @return [Array[authorized_connect_app.Permission]] Permissions authorized to the app
             def permissions
               @properties['permissions']
             end

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

@@ -52,10 +52,10 @@ module Twilio
             #   `status_callback_event` is specified, we will send the `completed` status. If an
             #   `application_sid` parameter is present, this parameter is ignored. URLs must
             #   contain a valid hostname (underscores are not permitted).
-            # @param [String] status_callback_event The call progress events that we will send
-            #   to the `status_callback` URL. Can be: `initiated`, `ringing`, `answered`, and
-            #   `completed`. If no event is specified, we send the `completed` status. If you
-            #   want to receive multiple events, specify each one in a separate
+            # @param [Array[String]] status_callback_event The call progress events that we
+            #   will send to the `status_callback` URL. Can be: `initiated`, `ringing`,
+            #   `answered`, and `completed`. If no event is specified, we send the `completed`
+            #   status. If you want to receive multiple events, specify each one in a separate
             #   `status_callback_event` parameter. See the code sample for {monitoring call
             #   progress}[https://www.twilio.com/docs/voice/api/call-resource?code-sample=code-create-a-call-resource-and-specify-a-statuscallbackevent&code-sdk-version=json].
             #   If an `application_sid` is present, this parameter is ignored.
@@ -106,10 +106,10 @@ module Twilio
             # @param [String] machine_detection_timeout The number of seconds that we should
             #   attempt to detect an answering machine before timing out and sending a voice
             #   request with `AnsweredBy` of `unknown`. The default timeout is 30 seconds.
-            # @param [String] recording_status_callback_event The recording status events that
-            #   will trigger calls to the URL specified in `recording_status_callback`. Can be:
-            #   `in-progress`, `completed` and `absent`. Defaults to `completed`. Separate
-            #   multiple values with a space.
+            # @param [Array[String]] recording_status_callback_event The recording status
+            #   events that will trigger calls to the URL specified in
+            #   `recording_status_callback`. Can be: `in-progress`, `completed` and `absent`.
+            #   Defaults to `completed`. Separate  multiple values with a space.
             # @param [String] trim Whether to trim any leading and trailing silence from the
             #   recording. Can be: `trim-silence` or `do-not-trim` and the default is
             #   `trim-silence`.
@@ -142,10 +142,10 @@ module Twilio
             # @param [String] call_reason The Reason for the outgoing call. Use it to specify
             #   the purpose of the call that is presented on the called party's phone. (Branded
             #   Calls Beta)
-            # @param [String] recording_track The tracks to record. Can be: `inbound`,
-            #   `outbound`, or `both`. The default is `both`. `inbound` only records the audio
-            #   received by Twilio, `outbound` only records audio generated by Twilio, and
-            #   `both` mixes the inbound and outbound audio.
+            # @param [String] recording_track The audio track to record for the call. Can be:
+            #   `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] 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

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

@@ -92,8 +92,8 @@ module Twilio
               # @param [String] quality_score The call quality expressed as an integer from `1`
               #   to `5` where `1` represents very poor call quality and `5` represents a perfect
               #   call.
-              # @param [feedback.Issues] issue A list of one or more issues experienced during
-              #   the call. Issues can be: `imperfect-audio`, `dropped-call`,
+              # @param [Array[feedback.Issues]] issue A list of one or more issues experienced
+              #   during the call. Issues can be: `imperfect-audio`, `dropped-call`,
               #   `incorrect-caller-id`, `post-dial-delay`, `digits-not-captured`,
               #   `audio-latency`, `unsolicited-call`, or `one-way-audio`.
               # @return [FeedbackInstance] Created FeedbackInstance
@@ -132,10 +132,10 @@ module Twilio
               # @param [String] quality_score The call quality expressed as an integer from `1`
               #   to `5` where `1` represents very poor call quality and `5` represents a perfect
               #   call.
-              # @param [feedback.Issues] issue One or more issues experienced during the call.
-              #   The issues can be: `imperfect-audio`, `dropped-call`, `incorrect-caller-id`,
-              #   `post-dial-delay`, `digits-not-captured`, `audio-latency`, `unsolicited-call`,
-              #   or `one-way-audio`.
+              # @param [Array[feedback.Issues]] issue One or more issues experienced during the
+              #   call. The issues can be: `imperfect-audio`, `dropped-call`,
+              #   `incorrect-caller-id`, `post-dial-delay`, `digits-not-captured`,
+              #   `audio-latency`, `unsolicited-call`, or `one-way-audio`.
               # @return [FeedbackInstance] Updated FeedbackInstance
               def update(quality_score: nil, issue: :unset)
                 data = Twilio::Values.of({
@@ -227,7 +227,7 @@ module Twilio
               end
 
               ##
-              # @return [feedback.Issues] Issues experienced during the call
+              # @return [Array[feedback.Issues]] Issues experienced during the call
               def issues
                 @properties['issues']
               end
@@ -249,8 +249,8 @@ module Twilio
               # @param [String] quality_score The call quality expressed as an integer from `1`
               #   to `5` where `1` represents very poor call quality and `5` represents a perfect
               #   call.
-              # @param [feedback.Issues] issue A list of one or more issues experienced during
-              #   the call. Issues can be: `imperfect-audio`, `dropped-call`,
+              # @param [Array[feedback.Issues]] issue A list of one or more issues experienced
+              #   during the call. Issues can be: `imperfect-audio`, `dropped-call`,
               #   `incorrect-caller-id`, `post-dial-delay`, `digits-not-captured`,
               #   `audio-latency`, `unsolicited-call`, or `one-way-audio`.
               # @return [FeedbackInstance] Created FeedbackInstance
@@ -270,10 +270,10 @@ module Twilio
               # @param [String] quality_score The call quality expressed as an integer from `1`
               #   to `5` where `1` represents very poor call quality and `5` represents a perfect
               #   call.
-              # @param [feedback.Issues] issue One or more issues experienced during the call.
-              #   The issues can be: `imperfect-audio`, `dropped-call`, `incorrect-caller-id`,
-              #   `post-dial-delay`, `digits-not-captured`, `audio-latency`, `unsolicited-call`,
-              #   or `one-way-audio`.
+              # @param [Array[feedback.Issues]] issue One or more issues experienced during the
+              #   call. The issues can be: `imperfect-audio`, `dropped-call`,
+              #   `incorrect-caller-id`, `post-dial-delay`, `digits-not-captured`,
+              #   `audio-latency`, `unsolicited-call`, or `one-way-audio`.
               # @return [FeedbackInstance] Updated FeedbackInstance
               def update(quality_score: nil, issue: :unset)
                 context.update(quality_score: quality_score, issue: issue, )

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

@@ -237,7 +237,7 @@ module Twilio
               end
 
               ##
-              # @return [String] Issues experienced during the call
+              # @return [Array[String]] Issues experienced during the call
               def issues
                 @properties['issues']
               end

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

@@ -33,10 +33,10 @@ module Twilio
 
               ##
               # Create the RecordingInstance
-              # @param [String] recording_status_callback_event The recording status events on
-              #   which we should call the `recording_status_callback` URL. Can be: `in-progress`,
-              #   `completed` and `absent` and the default is `completed`. Separate multiple event
-              #   values with a space.
+              # @param [Array[String]] recording_status_callback_event The recording status
+              #   events on which we should call the `recording_status_callback` URL. Can be:
+              #   `in-progress`, `completed` and `absent` and the default is `completed`. Separate
+              #   multiple event values with a space.
               # @param [String] recording_status_callback The URL we should call using the
               #   `recording_status_callback_method` on each recording event specified in
               #   `recording_status_callback_event`. For more information, see
@@ -53,10 +53,10 @@ module Twilio
               #   Can be: `mono` or `dual` and the default is `mono`. `mono` records all parties
               #   of the call into one channel. `dual` records each party of a 2-party call into
               #   separate channels.
-              # @param [String] recording_track The tracks to record. Can be: `inbound`,
-              #   `outbound`, or `both`. The default is `both`. `inbound` only records the audio
-              #   received by Twilio, `outbound` only records audio generated by Twilio, and
-              #   `both` mixes the inbound and outbound audio.
+              # @param [String] recording_track The audio track to record for the call. Can be:
+              #   `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.
               # @return [RecordingInstance] Created RecordingInstance
               def create(recording_status_callback_event: :unset, recording_status_callback: :unset, recording_status_callback_method: :unset, trim: :unset, recording_channels: :unset, recording_track: :unset)
                 data = Twilio::Values.of({

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

@@ -52,8 +52,8 @@ module Twilio
               #   `status_callback_method` to send status information to your application.
               # @param [String] status_callback_method The HTTP method we should use to call
               #   `status_callback`. Can be: `GET` and `POST` and defaults to `POST`.
-              # @param [String] status_callback_event The conference state changes that should
-              #   generate a call to `status_callback`. Can be: `initiated`, `ringing`,
+              # @param [Array[String]] status_callback_event The conference state changes that
+              #   should generate a call to `status_callback`. Can be: `initiated`, `ringing`,
               #   `answered`, and `completed`. Separate multiple values with a space. The default
               #   value is `completed`.
               # @param [String] label A label for this participant. If one is supplied, it may
@@ -105,10 +105,10 @@ module Twilio
               # @param [String] conference_status_callback_method The HTTP method we should use
               #   to call `conference_status_callback`. Can be: `GET` or `POST` and defaults to
               #   `POST`.
-              # @param [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`.
+              # @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`.
               # @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
@@ -128,11 +128,11 @@ module Twilio
               # @param [String] conference_recording_status_callback_method The HTTP method we
               #   should use to call `conference_recording_status_callback`. Can be: `GET` or
               #   `POST` and defaults to `POST`.
-              # @param [String] recording_status_callback_event The recording state changes that
-              #   should generate a call to `recording_status_callback`. Can be: `in-progress`,
-              #   `completed`, and `failed`. Separate multiple values with a space. The default
-              #   value is `in-progress completed failed`.
-              # @param [String] conference_recording_status_callback_event The conference
+              # @param [Array[String]] recording_status_callback_event The recording state
+              #   changes that should generate a call to `recording_status_callback`. Can be:
+              #   `in-progress`, `completed`, and `failed`. Separate multiple values with a space.
+              #   The default value is `in-progress completed failed`.
+              # @param [Array[String]] conference_recording_status_callback_event The conference
               #   recording state changes that generate a call to
               #   `conference_recording_status_callback`. Can be: `in-progress`, `completed`, and
               #   `failed`. Separate multiple values with a space. The default value is
@@ -162,10 +162,10 @@ module Twilio
               # @param [String] call_reason The Reason for the outgoing call. Use it to specify
               #   the purpose of the call that is presented on the called party's phone. (Branded
               #   Calls Beta)
-              # @param [String] recording_track The track to record. Can be: `inbound`,
-              #   `outbound`, or `both`. The default is `both`. `inbound` only records the audio
-              #   received by Twilio, `outbound` only records audio sent from Twilio, and `both`
-              #   mixes the inbound and outbound audio.
+              # @param [String] recording_track The audio track to record for the call. Can be:
+              #   `inbound`, `outbound` or `both`. The default is `both`. `inbound` records the
+              #   audio that is received by Twilio. `outbound` records the audio that is sent from
+              #   Twilio. `both` records the audio that is received and sent by Twilio.
               # @return [ParticipantInstance] Created ParticipantInstance
               def create(from: nil, to: nil, status_callback: :unset, status_callback_method: :unset, status_callback_event: :unset, label: :unset, timeout: :unset, record: :unset, muted: :unset, beep: :unset, start_conference_on_enter: :unset, end_conference_on_exit: :unset, wait_url: :unset, wait_method: :unset, early_media: :unset, max_participants: :unset, conference_record: :unset, conference_trim: :unset, conference_status_callback: :unset, conference_status_callback_method: :unset, conference_status_callback_event: :unset, recording_channels: :unset, recording_status_callback: :unset, recording_status_callback_method: :unset, sip_auth_username: :unset, sip_auth_password: :unset, region: :unset, conference_recording_status_callback: :unset, conference_recording_status_callback_method: :unset, recording_status_callback_event: :unset, conference_recording_status_callback_event: :unset, coaching: :unset, call_sid_to_coach: :unset, jitter_buffer_size: :unset, byoc: :unset, caller_id: :unset, call_reason: :unset, recording_track: :unset)
                 data = Twilio::Values.of({

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

@@ -189,7 +189,7 @@ module Twilio
             #   the resource. It can be up to 64 characters long.
             # @param [String] homepage_url A public URL where users can obtain more
             #   information about this Connect App.
-            # @param [connect_app.Permission] permissions A comma-separated list of the
+            # @param [Array[connect_app.Permission]] permissions A comma-separated list of the
             #   permissions you will request from the users of this ConnectApp.  Can include:
             #   `get-all` and `post-all`.
             # @return [ConnectAppInstance] Updated ConnectAppInstance
@@ -331,7 +331,7 @@ module Twilio
             end
 
             ##
-            # @return [connect_app.Permission] The set of permissions that your ConnectApp requests
+            # @return [Array[connect_app.Permission]] The set of permissions that your ConnectApp requests
             def permissions
               @properties['permissions']
             end
@@ -369,7 +369,7 @@ module Twilio
             #   the resource. It can be up to 64 characters long.
             # @param [String] homepage_url A public URL where users can obtain more
             #   information about this Connect App.
-            # @param [connect_app.Permission] permissions A comma-separated list of the
+            # @param [Array[connect_app.Permission]] permissions A comma-separated list of the
             #   permissions you will request from the users of this ConnectApp.  Can include:
             #   `get-all` and `post-all`.
             # @return [ConnectAppInstance] Updated ConnectAppInstance

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

@@ -77,7 +77,7 @@ module Twilio
             #   can be stored or obfuscated based on privacy settings
             # @param [Boolean] smart_encoded Whether to detect Unicode characters that have a
             #   similar GSM-7 character and replace them. Can be: `true` or `false`.
-            # @param [String] persistent_action Rich actions for Channels Messages.
+            # @param [Array[String]] persistent_action Rich actions for Channels Messages.
             # @param [String] from A Twilio phone number in
             #   {E.164}[https://www.twilio.com/docs/glossary/what-e164] format, an {alphanumeric
             #   sender
@@ -99,10 +99,10 @@ module Twilio
             #   delivery.
             # @param [String] body The text of the message you want to send. Can be up to
             #   1,600 characters in length.
-            # @param [String] media_url The URL of the media to send with the message. The
-            #   media can be of type `gif`, `png`, and `jpeg` and will be formatted correctly on
-            #   the recipient's device. The media size limit is 5MB for supported file types
-            #   (JPEG, PNG, GIF) and 500KB for {other
+            # @param [Array[String]] media_url The URL of the media to send with the message.
+            #   The media can be of type `gif`, `png`, and `jpeg` and will be formatted
+            #   correctly on the recipient's device. The media size limit is 5MB for supported
+            #   file types (JPEG, PNG, GIF) and 500KB for {other
             #   types}[https://www.twilio.com/docs/sms/accepted-mime-types] of accepted media.
             #   To send more than one image in the message body, provide multiple `media_url`
             #   parameters in the POST request. You can include up to 10 `media_url` parameters

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

@@ -110,7 +110,8 @@ module Twilio
               ##
               # Create the DomainInstance
               # @param [String] domain_name The unique address you reserve on Twilio to which
-              #   you route your SIP traffic. Domain names can contain letters, digits, and "-".
+              #   you route your SIP traffic. Domain names can contain letters, digits, and "-"
+              #   and must end with `sip.twilio.com`.
               # @param [String] friendly_name A descriptive string that you created to describe
               #   the resource. It can be up to 64 characters long.
               # @param [String] voice_url The URL we should when the domain receives a call.
@@ -248,7 +249,8 @@ module Twilio
               #   with the domain to receive calls. Can be `true` or `false`. `true` allows SIP
               #   Endpoints to register with the domain to receive calls, `false` does not.
               # @param [String] domain_name The unique address you reserve on Twilio to which
-              #   you route your SIP traffic. Domain names can contain letters, digits, and "-".
+              #   you route your SIP traffic. Domain names can contain letters, digits, and "-"
+              #   and must end with `sip.twilio.com`.
               # @param [Boolean] emergency_calling_enabled Whether emergency calling is enabled
               #   for the domain. If enabled, allows emergency calls on the domain from phone
               #   numbers with validated addresses.
@@ -576,7 +578,8 @@ module Twilio
               #   with the domain to receive calls. Can be `true` or `false`. `true` allows SIP
               #   Endpoints to register with the domain to receive calls, `false` does not.
               # @param [String] domain_name The unique address you reserve on Twilio to which
-              #   you route your SIP traffic. Domain names can contain letters, digits, and "-".
+              #   you route your SIP traffic. Domain names can contain letters, digits, and "-"
+              #   and must end with `sip.twilio.com`.
               # @param [Boolean] emergency_calling_enabled Whether emergency calling is enabled
               #   for the domain. If enabled, allows emergency calls on the domain from phone
               #   numbers with validated addresses.