twilio-ruby 7.3.3 → 7.3.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4f2e73c51c288976c1c887e2f7b531eac33660aa
-  data.tar.gz: 7cd72222c429642bdbc322d64074b1d949dae3e3
+  metadata.gz: e25ad4751d947c97ea1f1b024808691fca6ced5c
+  data.tar.gz: 7b04ac93d6f0cf9113143ebcf95caab81b4d6b60
 SHA512:
-  metadata.gz: c01620723f63074f14f586946d602a29e82b49a348753fae96686d8c573ca968a7c738f04e6d69ecccfd5943d9e27befeadfbe336331e15cc4cb10ccac5fac0a
-  data.tar.gz: 21442f7a242ef06a5b5f0dfe6ccc4d7da1599973707b4dbb0945814e42220264ec1de69c8354318c230dce73e8e71f3562f1754ea18d25dc37e5c55eedbf1212
+  metadata.gz: f2a4fa936804210bc6884dc97ee6254af4cdfbc08f415408a2ecf02d405cd94339e26de0e21927dc157fd74efb2107c4adf4e4b3b5a097839e4c570b944850b2
+  data.tar.gz: ed941f50e2bec4a7f5c733d29fbd791400a2d03a968659ca2fae3003e93cc6c26c427d36769812385326b51e30c64e5a19f2dc124f133191f09b7efc0f83c7de

data/CHANGES.md

@@ -1,6 +1,21 @@
 twilio-ruby changelog
 =====================
 
+[2024-10-24] Version 7.3.5
+--------------------------
+**Conversations**
+- Expose ConversationWithParticipants resource that allows creating a conversation with participants
+
+
+[2024-10-17] Version 7.3.4
+--------------------------
+**Api**
+- Add response key `country` to fetch AvailablePhoneNumber resource by specific country.
+
+**Messaging**
+- Make library and doc public for requestManagedCert Endpoint
+
+
 [2024-10-03] Version 7.3.3
 --------------------------
 **Messaging**

data/README.md

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

data/lib/twilio-ruby/rest/conversations/v1/conversation.rb

@@ -209,9 +209,9 @@ module Twilio
                         @uri = "/Conversations/#{@solution[:sid]}"
 
                         # Dependents
-                        @webhooks = nil
                         @messages = nil
                         @participants = nil
+                        @webhooks = nil
                     end
                     ##
                     # Delete the ConversationInstance
@@ -295,25 +295,6 @@ module Twilio
                         )
                     end
 
-                    ##
-                    # Access the webhooks
-                    # @return [WebhookList]
-                    # @return [WebhookContext] if sid was passed.
-                    def webhooks(sid=:unset)
-
-                        raise ArgumentError, 'sid cannot be nil' if sid.nil?
-
-                        if sid != :unset
-                            return WebhookContext.new(@version, @solution[:sid],sid )
-                        end
-
-                        unless @webhooks
-                            @webhooks = WebhookList.new(
-                                @version, conversation_sid: @solution[:sid], )
-                        end
-
-                     @webhooks
-                    end
                     ##
                     # Access the messages
                     # @return [MessageList]
@@ -352,6 +333,25 @@ module Twilio
 
                      @participants
                     end
+                    ##
+                    # Access the webhooks
+                    # @return [WebhookList]
+                    # @return [WebhookContext] if sid was passed.
+                    def webhooks(sid=:unset)
+
+                        raise ArgumentError, 'sid cannot be nil' if sid.nil?
+
+                        if sid != :unset
+                            return WebhookContext.new(@version, @solution[:sid],sid )
+                        end
+
+                        unless @webhooks
+                            @webhooks = WebhookList.new(
+                                @version, conversation_sid: @solution[:sid], )
+                        end
+
+                     @webhooks
+                    end
 
                     ##
                     # Provide a user friendly representation
@@ -594,13 +594,6 @@ module Twilio
                         )
                     end
 
-                    ##
-                    # Access the webhooks
-                    # @return [webhooks] webhooks
-                    def webhooks
-                        context.webhooks
-                    end
-
                     ##
                     # Access the messages
                     # @return [messages] messages
@@ -615,6 +608,13 @@ module Twilio
                         context.participants
                     end
 
+                    ##
+                    # Access the webhooks
+                    # @return [webhooks] webhooks
+                    def webhooks
+                        context.webhooks
+                    end
+
                     ##
                     # Provide a user friendly representation
                     def to_s

data/lib/twilio-ruby/rest/conversations/v1/conversation_with_participants.rb

@@ -0,0 +1,259 @@
+##
+#    This code was generated by
+#    ___ _ _ _ _ _    _ ____    ____ ____ _    ____ ____ _  _ ____ ____ ____ ___ __   __
+#     |  | | | | |    | |  | __ |  | |__| | __ | __ |___ |\ | |___ |__/ |__|  | |  | |__/
+#     |  |_|_| | |___ | |__|    |__| |  | |    |__] |___ | \| |___ |  \ |  |  | |__| |  \
+#
+#    Twilio - Conversations
+#    This is the public Twilio REST API.
+#
+#    NOTE: This class is auto generated by OpenAPI Generator.
+#    https://openapi-generator.tech
+#    Do not edit the class manually.
+#
+
+
+module Twilio
+    module REST
+        class Conversations < ConversationsBase
+            class V1 < Version
+                class ConversationWithParticipantsList < ListResource
+                
+                    ##
+                    # Initialize the ConversationWithParticipantsList
+                    # @param [Version] version Version that contains the resource
+                    # @return [ConversationWithParticipantsList] ConversationWithParticipantsList
+                    def initialize(version)
+                        super(version)
+                        # Path Solution
+                        @solution = {  }
+                        @uri = "/ConversationWithParticipants"
+                        
+                    end
+                    ##
+                    # Create the ConversationWithParticipantsInstance
+                    # @param [String] friendly_name The human-readable name of this conversation, limited to 256 characters. Optional.
+                    # @param [String] unique_name An application-defined string that uniquely identifies the resource. It can be used to address the resource in place of the resource's `sid` in the URL.
+                    # @param [Time] date_created The date that this resource was created.
+                    # @param [Time] date_updated The date that this resource was last updated.
+                    # @param [String] messaging_service_sid The unique ID of the [Messaging Service](https://www.twilio.com/docs/messaging/api/service-resource) this conversation belongs to.
+                    # @param [String] attributes An optional string metadata field you can use to store any data you wish. The string value must contain structurally valid JSON if specified.  **Note** that if the attributes are not set \\\"{}\\\" will be returned.
+                    # @param [State] state 
+                    # @param [String] timers_inactive ISO8601 duration when conversation will be switched to `inactive` state. Minimum value for this timer is 1 minute.
+                    # @param [String] timers_closed ISO8601 duration when conversation will be switched to `closed` state. Minimum value for this timer is 10 minutes.
+                    # @param [String] bindings_email_address The default email address that will be used when sending outbound emails in this conversation.
+                    # @param [String] bindings_email_name The default name that will be used when sending outbound emails in this conversation.
+                    # @param [Array[String]] participant The participant to be added to the conversation in JSON format. The parameters are as in [Participant Resource](https://www.twilio.com/docs/conversations/api/conversation-participant-resource). The maximum number of participants that can be added in a single request is 10.
+                    # @param [ConversationWithParticipantsEnumWebhookEnabledType] x_twilio_webhook_enabled The X-Twilio-Webhook-Enabled HTTP request header
+                    # @return [ConversationWithParticipantsInstance] Created ConversationWithParticipantsInstance
+                    def create(
+                        friendly_name: :unset, 
+                        unique_name: :unset, 
+                        date_created: :unset, 
+                        date_updated: :unset, 
+                        messaging_service_sid: :unset, 
+                        attributes: :unset, 
+                        state: :unset, 
+                        timers_inactive: :unset, 
+                        timers_closed: :unset, 
+                        bindings_email_address: :unset, 
+                        bindings_email_name: :unset, 
+                        participant: :unset, 
+                        x_twilio_webhook_enabled: :unset
+                    )
+
+                        data = Twilio::Values.of({
+                            'FriendlyName' => friendly_name,
+                            'UniqueName' => unique_name,
+                            'DateCreated' => Twilio.serialize_iso8601_datetime(date_created),
+                            'DateUpdated' => Twilio.serialize_iso8601_datetime(date_updated),
+                            'MessagingServiceSid' => messaging_service_sid,
+                            'Attributes' => attributes,
+                            'State' => state,
+                            'Timers.Inactive' => timers_inactive,
+                            'Timers.Closed' => timers_closed,
+                            'Bindings.Email.Address' => bindings_email_address,
+                            'Bindings.Email.Name' => bindings_email_name,
+                            'Participant' => Twilio.serialize_list(participant) { |e| e },
+                        })
+
+                        headers = Twilio::Values.of({'Content-Type' => 'application/x-www-form-urlencoded', 'X-Twilio-Webhook-Enabled' => x_twilio_webhook_enabled, })
+                        
+                        payload = @version.create('POST', @uri, data: data, headers: headers)
+                        ConversationWithParticipantsInstance.new(
+                            @version,
+                            payload,
+                        )
+                    end
+
+                
+
+
+                    # Provide a user friendly representation
+                    def to_s
+                        '#<Twilio.Conversations.V1.ConversationWithParticipantsList>'
+                    end
+                end
+
+                class ConversationWithParticipantsPage < Page
+                    ##
+                    # Initialize the ConversationWithParticipantsPage
+                    # @param [Version] version Version that contains the resource
+                    # @param [Response] response Response from the API
+                    # @param [Hash] solution Path solution for the resource
+                    # @return [ConversationWithParticipantsPage] ConversationWithParticipantsPage
+                    def initialize(version, response, solution)
+                        super(version, response)
+
+                        # Path Solution
+                        @solution = solution
+                    end
+
+                    ##
+                    # Build an instance of ConversationWithParticipantsInstance
+                    # @param [Hash] payload Payload response from the API
+                    # @return [ConversationWithParticipantsInstance] ConversationWithParticipantsInstance
+                    def get_instance(payload)
+                        ConversationWithParticipantsInstance.new(@version, payload)
+                    end
+
+                    ##
+                    # Provide a user friendly representation
+                    def to_s
+                        '<Twilio.Conversations.V1.ConversationWithParticipantsPage>'
+                    end
+                end
+                class ConversationWithParticipantsInstance < InstanceResource
+                    ##
+                    # Initialize the ConversationWithParticipantsInstance
+                    # @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 this ConversationWithParticipants
+                    #   resource.
+                    # @param [String] sid The SID of the Call resource to fetch.
+                    # @return [ConversationWithParticipantsInstance] ConversationWithParticipantsInstance
+                    def initialize(version, payload )
+                        super(version)
+                        
+                        # Marshaled Properties
+                        @properties = { 
+                            'account_sid' => payload['account_sid'],
+                            'chat_service_sid' => payload['chat_service_sid'],
+                            'messaging_service_sid' => payload['messaging_service_sid'],
+                            'sid' => payload['sid'],
+                            'friendly_name' => payload['friendly_name'],
+                            'unique_name' => payload['unique_name'],
+                            'attributes' => payload['attributes'],
+                            'state' => payload['state'],
+                            'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']),
+                            'date_updated' => Twilio.deserialize_iso8601_datetime(payload['date_updated']),
+                            'timers' => payload['timers'],
+                            'links' => payload['links'],
+                            'bindings' => payload['bindings'],
+                            'url' => payload['url'],
+                        }
+                    end
+
+                    
+                    ##
+                    # @return [String] The unique ID of the [Account](https://www.twilio.com/docs/iam/api/account) responsible for this conversation.
+                    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 unique ID of the [Messaging Service](https://www.twilio.com/docs/messaging/api/service-resource) this conversation belongs to.
+                    def messaging_service_sid
+                        @properties['messaging_service_sid']
+                    end
+                    
+                    ##
+                    # @return [String] A 34 character string that uniquely identifies this resource.
+                    def sid
+                        @properties['sid']
+                    end
+                    
+                    ##
+                    # @return [String] The human-readable name of this conversation, limited to 256 characters. Optional.
+                    def friendly_name
+                        @properties['friendly_name']
+                    end
+                    
+                    ##
+                    # @return [String] An application-defined string that uniquely identifies the resource. It can be used to address the resource in place of the resource's `sid` in the URL.
+                    def unique_name
+                        @properties['unique_name']
+                    end
+                    
+                    ##
+                    # @return [String] An optional string metadata field you can use to store any data you wish. The string value must contain structurally valid JSON if specified.  **Note** that if the attributes are not set \"{}\" will be returned.
+                    def attributes
+                        @properties['attributes']
+                    end
+                    
+                    ##
+                    # @return [State] 
+                    def state
+                        @properties['state']
+                    end
+                    
+                    ##
+                    # @return [Time] The date that this resource was created.
+                    def date_created
+                        @properties['date_created']
+                    end
+                    
+                    ##
+                    # @return [Time] The date that this resource was last updated.
+                    def date_updated
+                        @properties['date_updated']
+                    end
+                    
+                    ##
+                    # @return [Hash] Timer date values representing state update for this conversation.
+                    def timers
+                        @properties['timers']
+                    end
+                    
+                    ##
+                    # @return [Hash] Contains absolute URLs to access the [participants](https://www.twilio.com/docs/conversations/api/conversation-participant-resource), [messages](https://www.twilio.com/docs/conversations/api/conversation-message-resource) and [webhooks](https://www.twilio.com/docs/conversations/api/conversation-scoped-webhook-resource) of this conversation.
+                    def links
+                        @properties['links']
+                    end
+                    
+                    ##
+                    # @return [Hash] 
+                    def bindings
+                        @properties['bindings']
+                    end
+                    
+                    ##
+                    # @return [String] An absolute API resource URL for this conversation.
+                    def url
+                        @properties['url']
+                    end
+                    
+                    ##
+                    # Provide a user friendly representation
+                    def to_s
+                        "<Twilio.Conversations.V1.ConversationWithParticipantsInstance>"
+                    end
+
+                    ##
+                    # Provide a detailed, user friendly representation
+                    def inspect
+                        "<Twilio.Conversations.V1.ConversationWithParticipantsInstance>"
+                    end
+                end
+
+            end
+        end
+    end
+end

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

@@ -56,8 +56,8 @@ module Twilio
                         @uri = "/Services/#{@solution[:chat_service_sid]}/Configuration"
 
                         # Dependents
-                        @notifications = nil
                         @webhooks = nil
+                        @notifications = nil
                     end
                     ##
                     # Fetch the ConfigurationInstance
@@ -105,16 +105,6 @@ module Twilio
                         )
                     end
 
-                    ##
-                    # Access the notifications
-                    # @return [NotificationList]
-                    # @return [NotificationContext]
-                    def notifications
-                        NotificationContext.new(
-                                @version,
-                                @solution[:chat_service_sid]
-                                )
-                    end
                     ##
                     # Access the webhooks
                     # @return [WebhookList]
@@ -125,6 +115,16 @@ module Twilio
                                 @solution[:chat_service_sid]
                                 )
                     end
+                    ##
+                    # Access the notifications
+                    # @return [NotificationList]
+                    # @return [NotificationContext]
+                    def notifications
+                        NotificationContext.new(
+                                @version,
+                                @solution[:chat_service_sid]
+                                )
+                    end
 
                     ##
                     # Provide a user friendly representation
@@ -281,13 +281,6 @@ module Twilio
                         )
                     end
 
-                    ##
-                    # Access the notifications
-                    # @return [notifications] notifications
-                    def notifications
-                        context.notifications
-                    end
-
                     ##
                     # Access the webhooks
                     # @return [webhooks] webhooks
@@ -295,6 +288,13 @@ module Twilio
                         context.webhooks
                     end
 
+                    ##
+                    # Access the notifications
+                    # @return [notifications] notifications
+                    def notifications
+                        context.notifications
+                    end
+
                     ##
                     # Provide a user friendly representation
                     def to_s

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

@@ -214,8 +214,8 @@ module Twilio
 
                         # Dependents
                         @participants = nil
-                        @messages = nil
                         @webhooks = nil
+                        @messages = nil
                     end
                     ##
                     # Delete the ConversationInstance
@@ -321,42 +321,42 @@ module Twilio
                      @participants
                     end
                     ##
-                    # Access the messages
-                    # @return [MessageList]
-                    # @return [MessageContext] if sid was passed.
-                    def messages(sid=:unset)
+                    # Access the webhooks
+                    # @return [WebhookList]
+                    # @return [WebhookContext] if sid was passed.
+                    def webhooks(sid=:unset)
 
                         raise ArgumentError, 'sid cannot be nil' if sid.nil?
 
                         if sid != :unset
-                            return MessageContext.new(@version, @solution[:chat_service_sid], @solution[:sid],sid )
+                            return WebhookContext.new(@version, @solution[:chat_service_sid], @solution[:sid],sid )
                         end
 
-                        unless @messages
-                            @messages = MessageList.new(
+                        unless @webhooks
+                            @webhooks = WebhookList.new(
                                 @version, chat_service_sid: @solution[:chat_service_sid], conversation_sid: @solution[:sid], )
                         end
 
-                     @messages
+                     @webhooks
                     end
                     ##
-                    # Access the webhooks
-                    # @return [WebhookList]
-                    # @return [WebhookContext] if sid was passed.
-                    def webhooks(sid=:unset)
+                    # Access the messages
+                    # @return [MessageList]
+                    # @return [MessageContext] if sid was passed.
+                    def messages(sid=:unset)
 
                         raise ArgumentError, 'sid cannot be nil' if sid.nil?
 
                         if sid != :unset
-                            return WebhookContext.new(@version, @solution[:chat_service_sid], @solution[:sid],sid )
+                            return MessageContext.new(@version, @solution[:chat_service_sid], @solution[:sid],sid )
                         end
 
-                        unless @webhooks
-                            @webhooks = WebhookList.new(
+                        unless @messages
+                            @messages = MessageList.new(
                                 @version, chat_service_sid: @solution[:chat_service_sid], conversation_sid: @solution[:sid], )
                         end
 
-                     @webhooks
+                     @messages
                     end
 
                     ##
@@ -607,13 +607,6 @@ module Twilio
                         context.participants
                     end
 
-                    ##
-                    # Access the messages
-                    # @return [messages] messages
-                    def messages
-                        context.messages
-                    end
-
                     ##
                     # Access the webhooks
                     # @return [webhooks] webhooks
@@ -621,6 +614,13 @@ module Twilio
                         context.webhooks
                     end
 
+                    ##
+                    # Access the messages
+                    # @return [messages] messages
+                    def messages
+                        context.messages
+                    end
+
                     ##
                     # Provide a user friendly representation
                     def to_s