twilio-ruby 5.61.0 → 5.63.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2f67e55070e1d0eddd733aab27eb25aaac27b3ca
-  data.tar.gz: 8152831ec638b70b0bae3a6596080c1fa6c7ced9
+  metadata.gz: 582f6e6561bd6ee40a9aadaefc0e2550df5d565f
+  data.tar.gz: 8ec0f4c692bd66e1da3a7ea99d58f4ddaa8b6d0c
 SHA512:
-  metadata.gz: 4386a3cee85ffba9015d8eb0aba9012fbe5e8465635f96bfe563fafbd2aa6d99c0b4228a6b8dfca7fb958c16175b079eaa44e9c06d1944fdc8fdd630de3f58af
-  data.tar.gz: f57664647dd26b987cd3cc45b6ff2035880bb324acc1b790a9271d66bdbdc7ca12d73164be50fe023e11ece500db1044717db855006791569b903f7d42cdf927
+  metadata.gz: 5864ca88585ee5e2f4952218d1c85180caac3e0b0c4361836e8cc850c2e1fc716f20d0fcd931df29e03e05e54ad4c5bb9c93d46eda5e6e94f8d3aee5a6aa0e64
+  data.tar.gz: 26560b4c09aa1161baac7ba7ac3c83bebe154b4a923e71e550e03742614c1d51e4ef086b747e83645c27f2092eb05a8c811f23f0f7636f0b8f6e191407513fa0

data/.github/workflows/{deploy.yml → test-and-deploy.yml}

@@ -1,17 +1,57 @@
-name: Deploy
+name: Test and Deploy
 on:
   push:
-    tags:
-      - '*'
+    branches: [ '*' ]
+    tags: [ '*' ]
+  pull_request:
+    branches: [ main ]
+  schedule:
+    # Run automatically at 8AM PST Monday-Friday
+    - cron: '0 15 * * 1-5'
   workflow_dispatch:
 
 jobs:
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    strategy:
+      matrix:
+        ruby: [ 2.4, 2.5, 2.6, 2.7, '3.0', ruby-head, jruby-9.2 ]
+    continue-on-error: ${{ matrix.ruby == 'ruby-head' }}
+    steps:
+      - name: Checkout twilio-ruby
+        uses: actions/checkout@v2
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+
+      - run: bundle install --with development
+      - run: bundle exec rake install
+      - name: Run Unit Tests
+        run: make test
+
   deploy:
-    name: Deploy to Rubygems
+    name: Deploy
+    if: success() && github.ref_type == 'tag'
+    needs: [ test ]
     runs-on: ubuntu-latest
     steps:
       - name: Checkout twilio-ruby
         uses: actions/checkout@v2
+        with:
+          fetch-depth: 0
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 2.4
+          bundler-cache: true
+
+      - run: bundle install
 
       - name: Login to Docker Hub
         uses: docker/login-action@v1
@@ -23,20 +63,17 @@ jobs:
       - name: Get tagged version
         run: echo "GITHUB_TAG=${GITHUB_REF#refs/*/}" >> $GITHUB_ENV
 
+      - name: Create GitHub Release
+        uses: sendgrid/dx-automator/actions/release@main
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
       - name: Build and Push image
         run: make docker-build && make docker-push
-
-      - name: Set up Ruby
-        uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: 2.4
-          bundler-cache: true
-
-      - run: bundle install
       - name: Publish to Rubygems
         env:
           GEM_HOST_API_KEY: ${{ secrets.RUBYGEMS_AUTH_TOKEN }}
-        run:  |
+        run: |
           mkdir -p $HOME/.gem
           touch $HOME/.gem/credentials
           chmod 0600 $HOME/.gem/credentials
@@ -46,16 +83,16 @@ jobs:
 
   notify-on-failure:
     name: Slack notify on failure
-    if: ${{ failure() }}
-    needs: [deploy]
+    if: failure() && github.event_name != 'pull_request' && (github.ref == 'refs/heads/main' || github.ref_type == 'tag')
+    needs: [ test, deploy ]
     runs-on: ubuntu-latest
     steps:
       - uses: rtCamp/action-slack-notify@v2
         env:
-          SLACK_COLOR: ${{ needs.deploy.status }}
+          SLACK_COLOR: failure
           SLACK_ICON_EMOJI: ':github:'
-          SLACK_MESSAGE: ${{ format('Failed to publish {1} to RubyGems{3} {0}/{1}/actions/runs/{2}', github.server_url, github.repository, github.run_id, ':') }}
-          SLACK_TITLE: Deployment Failure
+          SLACK_MESSAGE: ${{ format('Tests *{0}*, Deploy *{1}*, {2}/{3}/actions/runs/{4}', needs.test.result, needs.deploy.result, github.server_url, github.repository, github.run_id) }}
+          SLACK_TITLE: Action Failure - ${{ github.repository }}
           SLACK_USERNAME: GitHub Actions
           SLACK_MSG_AUTHOR: twilio-dx
           SLACK_FOOTER: Posted automatically using GitHub Actions

data/.gitignore

@@ -13,5 +13,6 @@ docs/_build
 *.iml
 .bundle
 .rakeTasks
+.yardoc
 
 coverage

data/.rubocop.yml

@@ -1,7 +1,7 @@
 inherit_from: .rubocop_todo.yml
 
 AllCops:
-  TargetRubyVersion: 2.6
+  TargetRubyVersion: 2.4
   Exclude:
     - 'lib/twilio-ruby/rest/**/*'
     - 'spec/integration/**/*'

data/CHANGES.md

@@ -1,6 +1,104 @@
 twilio-ruby changelog
 =====================
 
+[2022-01-12] Version 5.63.0
+---------------------------
+**Library - Feature**
+- [PR #586](https://github.com/twilio/twilio-ruby/pull/586): add GitHub release step during deploy. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+
+**Library - Chore**
+- [PR #584](https://github.com/twilio/twilio-ruby/pull/584): run yard in bundle context. Thanks to [@eshanholtz](https://github.com/eshanholtz)!
+- [PR #583](https://github.com/twilio/twilio-ruby/pull/583): remove githook dependency from make install. Thanks to [@JenniferMah](https://github.com/JenniferMah)!
+
+**Api**
+- Make fixed time scheduling parameters public **(breaking change)**
+
+**Messaging**
+- Add update brand registration API
+
+**Numbers**
+- Add API endpoint for List Bundle Copies resource
+
+**Video**
+- Enable external storage for all customers
+
+
+[2021-12-15] Version 5.62.0
+---------------------------
+**Library - Feature**
+- [PR #581](https://github.com/twilio/twilio-ruby/pull/581): run tests before deploying. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+
+**Api**
+- Add optional boolean send_as_mms parameter to the create action of Message resource **(breaking change)**
+- Change team ownership for `call` delete
+
+**Conversations**
+- Change wording for `Service Webhook Configuration` resource fields
+
+**Insights**
+- Added new APIs for updating and getting voice insights flags by accountSid.
+
+**Media**
+- Add max_duration param to MediaProcessor
+
+**Video**
+- Add `EmptyRoomTimeout` and `UnusedRoomTimeout` properties to a room; add corresponding parameters to room creation
+
+**Voice**
+- Add endpoint to delete archived Calls
+
+
+[2021-12-01] Version 5.61.2
+---------------------------
+**Library - Chore**
+- [PR #579](https://github.com/twilio/twilio-ruby/pull/579): make ruby-head test optional. Thanks to [@eshanholtz](https://github.com/eshanholtz)!
+
+**Conversations**
+- Add `Service Webhook Configuration` resource
+
+**Flex**
+- Adding `flex_insights_drilldown` and `flex_url` objects to Flex Configuration
+
+**Messaging**
+- Update us_app_to_person endpoints to remove beta feature flag based access
+
+**Supersim**
+- Add IP Commands resource
+
+**Verify**
+- Add optional `factor_friendly_name` parameter to the create access token endpoint.
+
+**Video**
+- Add maxParticipantDuration param to Rooms
+
+**Twiml**
+- Unrevert Add supported SSML children to `<emphasis>`, `<lang>`, `<p>`, `<prosody>`, `<s>`, and `<w>`.
+- Revert Add supported SSML children to `<emphasis>`, `<lang>`, `<p>`, `<prosody>`, `<s>`, and `<w>`.
+
+
+[2021-11-17] Version 5.61.1
+---------------------------
+**Library - Chore**
+- [PR #578](https://github.com/twilio/twilio-ruby/pull/578): remove yardoc files. Thanks to [@eshanholtz](https://github.com/eshanholtz)!
+
+**Library - Fix**
+- [PR #576](https://github.com/twilio/twilio-ruby/pull/576): git log retrieval issues. Thanks to [@shwetha-manvinkurke](https://github.com/shwetha-manvinkurke)!
+
+**Frontline**
+- Added `is_available` to User's resource
+
+**Messaging**
+- Added GET vetting API
+
+**Verify**
+- Add `WHATSAPP` to the attempts API.
+- Allow to update `config.notification_platform` from `none` to `apn` or `fcm` and viceversa for Verify Push
+- Add `none` as a valid `config.notification_platform` value for Verify Push
+
+**Twiml**
+- Add supported SSML children to `<emphasis>`, `<lang>`, `<p>`, `<prosody>`, `<s>`, and `<w>`.
+
+
 [2021-11-03] Version 5.61.0
 ---------------------------
 **Library - Chore**

data/Makefile

@@ -3,17 +3,17 @@
 githooks:
 	ln -sf ../../githooks/pre-commit .git/hooks/pre-commit
 
-install: githooks
+install:
 	bundle install --with development; bundle exec rake install
 
 test: lint
 	bundle exec rake spec
 
 lint:
-	bundle exec rubocop --cache true --parallel
+	bundle exec rubocop -d --cache true --parallel
 
 docs:
-	yard doc --output-dir ./doc
+	bundle exec yard doc --output-dir ./doc
 
 authors:
 	echo "Authors\n=======\n\nA huge thanks to all of our contributors:\n\n" > AUTHORS.md

data/README.md

@@ -1,6 +1,6 @@
 # twilio-ruby
 
-[![Tests](https://github.com/twilio/twilio-ruby/actions/workflows/test.yml/badge.svg)][github-actions]
+[![Tests](https://github.com/twilio/twilio-ruby/actions/workflows/test-and-deploy.yml/badge.svg)][github-actions]
 [![Gem Version](https://img.shields.io/gem/v/twilio-ruby.svg)](https://rubygems.org/gems/twilio-ruby)
 [![Learn with TwilioQuest](https://img.shields.io/static/v1?label=TwilioQuest&message=Learn%20to%20contribute%21&color=F22F46&labelColor=1f243c&style=flat-square&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAIAAAACACAMAAAD04JH5AAAASFBMVEUAAAAZGRkcHBwjIyMoKCgAAABgYGBoaGiAgICMjIyzs7PJycnMzMzNzc3UoBfd3d3m5ubqrhfrMEDu7u739/f4vSb/3AD///9tbdyEAAAABXRSTlMAAAAAAMJrBrEAAAKoSURBVHgB7ZrRcuI6EESdyxXGYoNFvMD//+l2bSszRgyUYpFAsXOeiJGmj4NkuWx1Qeh+Ekl9DgEXOBwOx+Px5xyQhDykfgq4wG63MxxaR4ddIkg6Ul3g84vCIcjPBA5gmUMeXESrlukuoK33+33uID8TWeLAdOWsKpJYzwVMB7bOzYSGOciyUlXSn0/ABXTosJ1M1SbypZ4O4MbZuIDMU02PMbauhhHMHXbmebmALIiEbbbbbUrpF1gwE9kFfRNAJaP+FQEXCCTGyJ4ngDrjOFo3jEL5JdqjF/pueR4cCeCGgAtwmuRS6gDwaRiGvu+DMFwSBLTE3+jF8JyuV1okPZ+AC4hDFhCHyHQjdjPHUKFDlHSJkHQXMB3KpSwXNGJPcwwTdZiXlRN0gSp0zpWxNtM0beYE0nRH6QIbO7rawwXaBYz0j78gxjokDuv12gVeUuBD0MDi0OQCLvDaAho4juP1Q/jkAncXqIcCfd+7gAu4QLMACCLxpRsSuQh0igu0C9Svhi7weAGZg50L3IE3cai4IfkNZAC8dfdhsUD3CgKBVC9JE5ABAFzg4QL/taYPAAWrHdYcgfLaIgAXWJ7OV38n1LEF8tt2TH29E+QAoDoO5Ve/LtCQDmKM9kPbvCEBApK+IXzbcSJ0cIGF6e8gpcRhUDogWZ8JnaWjPXc/fNnBBUKRngiHgTUSivSzDRDgHZQOLvBQgf8rRt+VdBUUhwkU6VpJ+xcOwQUqZr+mR0kvBUgv6cB4+37hQAkXqE8PwGisGhJtN4xAHMzrsgvI7rccXqSvKh6jltGlrOHA3Xk1At3LC4QiPdX9/0ndHpGVvTjR4bZA1ypAKgVcwE5vx74ulwIugDt8e/X7JgfkucBMIAr26ndnB4UCLnDOqvteQsHlgX9N4A+c4cW3DXSPbwAAAABJRU5ErkJggg==)](https://twil.io/learn-open-source)
 
@@ -35,13 +35,13 @@ This library supports the following Ruby implementations:
 To install using [Bundler][bundler] grab the latest stable version:
 
 ```ruby
-gem 'twilio-ruby', '~> 5.61.0'
+gem 'twilio-ruby', '~> 5.63.0'
 ```
 
 To manually install `twilio-ruby` via [Rubygems][rubygems] simply gem install:
 
 ```bash
-gem install twilio-ruby -v 5.61.0
+gem install twilio-ruby -v 5.63.0
 ```
 
 To build and install the development branch yourself from the latest source:
@@ -257,7 +257,7 @@ If you've instead found a bug in the library or would like new features added, g
 [bundler]: https://bundler.io
 [rubygems]: https://rubygems.org
 [gem]: https://rubygems.org/gems/twilio
-[github-actions]: https://github.com/twilio/twilio-ruby/actions/workflows/test.yml
+[github-actions]: https://github.com/twilio/twilio-ruby/actions/workflows/test-and-deploy.yml
 [upgrade]: https://github.com/twilio/twilio-ruby/wiki/Ruby-Version-5.x-Upgrade-Guide
 [issues]: https://github.com/twilio/twilio-ruby/issues
 [faraday]: https://github.com/lostisland/faraday

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

@@ -144,9 +144,9 @@ module Twilio
             #   Calls Beta)
             # @param [String] call_token A token string needed to invoke a forwarded call. A
             #   call_token is generated when an incoming call is received on a Twilio number.
-            #   this field should be populated by the incoming call's call_token to make this
-            #   outgoing call as a forwarded call of incoming call. A forwarded call should bear
-            #   the same caller-id of incoming call.
+            #   Pass an incoming call's call_token value to a forwarded call via the call_token
+            #   parameter when creating a new call. A forwarded call should bear the same
+            #   CallerID of the original incoming call.
             # @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

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

@@ -78,6 +78,13 @@ module Twilio
             # @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 [Array[String]] persistent_action Rich actions for Channels Messages.
+            # @param [message.ScheduleType] schedule_type Indicates your intent to schedule a
+            #   message. Pass the value `fixed` to schedule a message at a fixed time.
+            # @param [Time] send_at The time that Twilio will send the message. Must be in ISO
+            #   8601 format.
+            # @param [Boolean] send_as_mms If set to True, Twilio will deliver the message as
+            #   a single MMS message, regardless of the presence of media. This is a Beta
+            #   Feature.
             # @param [String] from A Twilio phone number in
             #   {E.164}[https://www.twilio.com/docs/glossary/what-e164] format, an {alphanumeric
             #   sender
@@ -108,7 +115,7 @@ module Twilio
             #   parameters in the POST request. You can include up to 10 `media_url` parameters
             #   per message. You can send images in an SMS message in only the US and Canada.
             # @return [MessageInstance] Created MessageInstance
-            def create(to: nil, status_callback: :unset, application_sid: :unset, max_price: :unset, provide_feedback: :unset, attempt: :unset, validity_period: :unset, force_delivery: :unset, content_retention: :unset, address_retention: :unset, smart_encoded: :unset, persistent_action: :unset, from: :unset, messaging_service_sid: :unset, body: :unset, media_url: :unset)
+            def create(to: nil, status_callback: :unset, application_sid: :unset, max_price: :unset, provide_feedback: :unset, attempt: :unset, validity_period: :unset, force_delivery: :unset, content_retention: :unset, address_retention: :unset, smart_encoded: :unset, persistent_action: :unset, schedule_type: :unset, send_at: :unset, send_as_mms: :unset, from: :unset, messaging_service_sid: :unset, body: :unset, media_url: :unset)
               data = Twilio::Values.of({
                   'To' => to,
                   'From' => from,
@@ -126,6 +133,9 @@ module Twilio
                   'AddressRetention' => address_retention,
                   'SmartEncoded' => smart_encoded,
                   'PersistentAction' => Twilio.serialize_list(persistent_action) { |e| e },
+                  'ScheduleType' => schedule_type,
+                  'SendAt' => Twilio.serialize_iso8601_datetime(send_at),
+                  'SendAsMms' => send_as_mms,
               })
 
               payload = @version.create('POST', @uri, data: data)
@@ -329,9 +339,11 @@ module Twilio
             # Update the MessageInstance
             # @param [String] body The text of the message you want to send. Can be up to
             #   1,600 characters long.
+            # @param [message.UpdateStatus] status When set as `canceled`, allows a message
+            #   cancelation request if a message has not yet been sent.
             # @return [MessageInstance] Updated MessageInstance
-            def update(body: :unset)
-              data = Twilio::Values.of({'Body' => body, })
+            def update(body: :unset, status: :unset)
+              data = Twilio::Values.of({'Body' => body, 'Status' => status, })
 
               payload = @version.update('POST', @uri, data: data)
 
@@ -579,9 +591,11 @@ module Twilio
             # Update the MessageInstance
             # @param [String] body The text of the message you want to send. Can be up to
             #   1,600 characters long.
+            # @param [message.UpdateStatus] status When set as `canceled`, allows a message
+            #   cancelation request if a message has not yet been sent.
             # @return [MessageInstance] Updated MessageInstance
-            def update(body: :unset)
-              context.update(body: body, )
+            def update(body: :unset, status: :unset)
+              context.update(body: body, status: status, )
             end
 
             ##

data/lib/twilio-ruby/rest/conversations/v1/service/configuration/webhook.rb

@@ -0,0 +1,269 @@
+##
+# This code was generated by
+# \ / _    _  _|   _  _
+#  | (_)\/(_)(_|\/| |(/_  v1.0.0
+#       /       /
+#
+# frozen_string_literal: true
+
+module Twilio
+  module REST
+    class Conversations < Domain
+      class V1 < Version
+        class ServiceContext < InstanceContext
+          class ConfigurationContext < InstanceContext
+            class WebhookList < ListResource
+              ##
+              # Initialize the WebhookList
+              # @param [Version] version Version that contains the resource
+              # @param [String] chat_service_sid The unique string that we created to identify
+              #   the Service configuration resource.
+              # @return [WebhookList] WebhookList
+              def initialize(version, chat_service_sid: nil)
+                super(version)
+
+                # Path Solution
+                @solution = {chat_service_sid: chat_service_sid}
+              end
+
+              ##
+              # Provide a user friendly representation
+              def to_s
+                '#<Twilio.Conversations.V1.WebhookList>'
+              end
+            end
+
+            class WebhookPage < Page
+              ##
+              # Initialize the WebhookPage
+              # @param [Version] version Version that contains the resource
+              # @param [Response] response Response from the API
+              # @param [Hash] solution Path solution for the resource
+              # @return [WebhookPage] WebhookPage
+              def initialize(version, response, solution)
+                super(version, response)
+
+                # Path Solution
+                @solution = solution
+              end
+
+              ##
+              # Build an instance of WebhookInstance
+              # @param [Hash] payload Payload response from the API
+              # @return [WebhookInstance] WebhookInstance
+              def get_instance(payload)
+                WebhookInstance.new(@version, payload, chat_service_sid: @solution[:chat_service_sid], )
+              end
+
+              ##
+              # Provide a user friendly representation
+              def to_s
+                '<Twilio.Conversations.V1.WebhookPage>'
+              end
+            end
+
+            class WebhookContext < InstanceContext
+              ##
+              # Initialize the WebhookContext
+              # @param [Version] version Version that contains the resource
+              # @param [String] chat_service_sid The unique ID of the {Conversation
+              #   Service}[https://www.twilio.com/docs/conversations/api/service-resource] this
+              #   conversation belongs to.
+              # @return [WebhookContext] WebhookContext
+              def initialize(version, chat_service_sid)
+                super(version)
+
+                # Path Solution
+                @solution = {chat_service_sid: chat_service_sid, }
+                @uri = "/Services/#{@solution[:chat_service_sid]}/Configuration/Webhooks"
+              end
+
+              ##
+              # Update the WebhookInstance
+              # @param [String] pre_webhook_url The absolute url the pre-event webhook request
+              #   should be sent to.
+              # @param [String] post_webhook_url The absolute url the post-event webhook request
+              #   should be sent to.
+              # @param [Array[String]] filters The list of events that your configured webhook
+              #   targets will receive. Events not configured here will not fire. Possible values
+              #   are `onParticipantAdd`, `onParticipantAdded`, `onDeliveryUpdated`,
+              #   `onConversationUpdated`, `onConversationRemove`, `onParticipantRemove`,
+              #   `onConversationUpdate`, `onMessageAdd`, `onMessageRemoved`,
+              #   `onParticipantUpdated`, `onConversationAdded`, `onMessageAdded`,
+              #   `onConversationAdd`, `onConversationRemoved`, `onParticipantUpdate`,
+              #   `onMessageRemove`, `onMessageUpdated`, `onParticipantRemoved`, `onMessageUpdate`
+              #   or `onConversationStateUpdated`.
+              # @param [String] method The HTTP method to be used when sending a webhook
+              #   request. One of `GET` or `POST`.
+              # @return [WebhookInstance] Updated WebhookInstance
+              def update(pre_webhook_url: :unset, post_webhook_url: :unset, filters: :unset, method: :unset)
+                data = Twilio::Values.of({
+                    'PreWebhookUrl' => pre_webhook_url,
+                    'PostWebhookUrl' => post_webhook_url,
+                    'Filters' => Twilio.serialize_list(filters) { |e| e },
+                    'Method' => method,
+                })
+
+                payload = @version.update('POST', @uri, data: data)
+
+                WebhookInstance.new(@version, payload, chat_service_sid: @solution[:chat_service_sid], )
+              end
+
+              ##
+              # Fetch the WebhookInstance
+              # @return [WebhookInstance] Fetched WebhookInstance
+              def fetch
+                payload = @version.fetch('GET', @uri)
+
+                WebhookInstance.new(@version, payload, chat_service_sid: @solution[:chat_service_sid], )
+              end
+
+              ##
+              # Provide a user friendly representation
+              def to_s
+                context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+                "#<Twilio.Conversations.V1.WebhookContext #{context}>"
+              end
+
+              ##
+              # Provide a detailed, user friendly representation
+              def inspect
+                context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+                "#<Twilio.Conversations.V1.WebhookContext #{context}>"
+              end
+            end
+
+            class WebhookInstance < InstanceResource
+              ##
+              # Initialize the WebhookInstance
+              # @param [Version] version Version that contains the resource
+              # @param [Hash] payload payload that contains response from Twilio
+              # @param [String] chat_service_sid The unique string that we created to identify
+              #   the Service configuration resource.
+              # @return [WebhookInstance] WebhookInstance
+              def initialize(version, payload, chat_service_sid: nil)
+                super(version)
+
+                # Marshaled Properties
+                @properties = {
+                    'account_sid' => payload['account_sid'],
+                    'chat_service_sid' => payload['chat_service_sid'],
+                    'pre_webhook_url' => payload['pre_webhook_url'],
+                    'post_webhook_url' => payload['post_webhook_url'],
+                    'filters' => payload['filters'],
+                    'method' => payload['method'],
+                    'url' => payload['url'],
+                }
+
+                # Context
+                @instance_context = nil
+                @params = {'chat_service_sid' => chat_service_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 [WebhookContext] WebhookContext for this WebhookInstance
+              def context
+                unless @instance_context
+                  @instance_context = WebhookContext.new(@version, @params['chat_service_sid'], )
+                end
+                @instance_context
+              end
+
+              ##
+              # @return [String] The unique ID of the Account responsible for this service.
+              def account_sid
+                @properties['account_sid']
+              end
+
+              ##
+              # @return [String] The unique ID of the {Conversation Service}[https://www.twilio.com/docs/conversations/api/service-resource] this conversation belongs to.
+              def chat_service_sid
+                @properties['chat_service_sid']
+              end
+
+              ##
+              # @return [String] The absolute url the pre-event webhook request should be sent to.
+              def pre_webhook_url
+                @properties['pre_webhook_url']
+              end
+
+              ##
+              # @return [String] The absolute url the post-event webhook request should be sent to.
+              def post_webhook_url
+                @properties['post_webhook_url']
+              end
+
+              ##
+              # @return [Array[String]] The list of events that your configured webhook targets will receive. Events not configured here will not fire.
+              def filters
+                @properties['filters']
+              end
+
+              ##
+              # @return [webhook.Method] The HTTP method to be used when sending a webhook request
+              def method
+                @properties['method']
+              end
+
+              ##
+              # @return [String] An absolute URL for this webhook.
+              def url
+                @properties['url']
+              end
+
+              ##
+              # Update the WebhookInstance
+              # @param [String] pre_webhook_url The absolute url the pre-event webhook request
+              #   should be sent to.
+              # @param [String] post_webhook_url The absolute url the post-event webhook request
+              #   should be sent to.
+              # @param [Array[String]] filters The list of events that your configured webhook
+              #   targets will receive. Events not configured here will not fire. Possible values
+              #   are `onParticipantAdd`, `onParticipantAdded`, `onDeliveryUpdated`,
+              #   `onConversationUpdated`, `onConversationRemove`, `onParticipantRemove`,
+              #   `onConversationUpdate`, `onMessageAdd`, `onMessageRemoved`,
+              #   `onParticipantUpdated`, `onConversationAdded`, `onMessageAdded`,
+              #   `onConversationAdd`, `onConversationRemoved`, `onParticipantUpdate`,
+              #   `onMessageRemove`, `onMessageUpdated`, `onParticipantRemoved`, `onMessageUpdate`
+              #   or `onConversationStateUpdated`.
+              # @param [String] method The HTTP method to be used when sending a webhook
+              #   request. One of `GET` or `POST`.
+              # @return [WebhookInstance] Updated WebhookInstance
+              def update(pre_webhook_url: :unset, post_webhook_url: :unset, filters: :unset, method: :unset)
+                context.update(
+                    pre_webhook_url: pre_webhook_url,
+                    post_webhook_url: post_webhook_url,
+                    filters: filters,
+                    method: method,
+                )
+              end
+
+              ##
+              # Fetch the WebhookInstance
+              # @return [WebhookInstance] Fetched WebhookInstance
+              def fetch
+                context.fetch
+              end
+
+              ##
+              # Provide a user friendly representation
+              def to_s
+                values = @params.map{|k, v| "#{k}: #{v}"}.join(" ")
+                "<Twilio.Conversations.V1.WebhookInstance #{values}>"
+              end
+
+              ##
+              # Provide a detailed, user friendly representation
+              def inspect
+                values = @properties.map{|k, v| "#{k}: #{v}"}.join(" ")
+                "<Twilio.Conversations.V1.WebhookInstance #{values}>"
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/twilio-ruby/rest/conversations/v1/service/configuration.rb

@@ -77,6 +77,7 @@ module Twilio
 
               # Components
               @notifications = nil
+              @webhooks = nil
             end
 
             ##
@@ -127,6 +128,13 @@ module Twilio
               return NotificationContext.new(@version, @solution[:chat_service_sid], )
             end
 
+            ##
+            # Access the webhooks
+            # @return [WebhookContext] WebhookContext
+            def webhooks
+              return WebhookContext.new(@version, @solution[:chat_service_sid], )
+            end
+
             ##
             # Provide a user friendly representation
             def to_s