vonage 7.21.0 → 7.22.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8839127b442d9de3ee98bfc35f38bf76c967389bcf02136a28c8232f497f94bb
-  data.tar.gz: c52b8d863d3326153f6678a9234457eb945b155f6fdfa2b782e45abbc4c5d16b
+  metadata.gz: 56d2728bfe79b6d7361f68189aae31b7509fae3e97260fa413f2e99ccc72d14c
+  data.tar.gz: ccca6115ec963b7e687e2c227ae31b026ec88c92ccc205fc39df46fe43827adf
 SHA512:
-  metadata.gz: bf2d3ae171d5278f8c8d9c68129e3ba70b1edce0d16fb414bf0ecae7995c27620fbaca284f40c121dc128e6388f1485fa4bfa069f52e38b029d2f76397a73b0e
-  data.tar.gz: 49897746fc8dc49fd67b01e3366215cc6298a59f771c1544b0004d2dcdac07c5d4b2263f383ac6c17e9d9bf7ca483bb4922bcc4ebdcdb0167a4823ac4387f627
+  metadata.gz: 0fdeaffdc2859873b73370cd32db48c540e38e88a637ed096f830694be07c221cbd663185631266d52b41c281051946f932aaf1afda7589a5a76b634f26ad37e
+  data.tar.gz: 0a75edbe4f910371aa672a554e2933f3514cd1b93c6557f7fd2f47c4c4f9465170d6c5c309ad99f676448dfe141261e4b0ce0879517f47ee1c99a49cce6d1cfd

data/README.md

@@ -525,6 +525,7 @@ The following is a list of Vonage APIs for which the Ruby SDK currently provides
 
 * [Account API](https://developer.vonage.com/en/account/overview)
 * [Application API](https://developer.vonage.com/en/application/overview)
+* [Conversation API](https://developer.vonage.com/en/conversation/overview)
 * [Meetings API](https://developer.vonage.com/en/meetings/overview)
 * [Messages API](https://developer.vonage.com/en/messages/overview)
 * [Number Insight API](https://developer.vonage.com/en/number-insight/overview)

data/lib/vonage/client.rb

@@ -40,8 +40,17 @@ module Vonage
       @applications ||= T.let(Applications.new(config), T.nilable(Vonage::Applications))
     end
 
+    # @return [Conversation]
+    #
+    sig { returns(T.nilable(Vonage::Conversation)) }
+    def conversation
+      @conversation ||= T.let(Conversation.new(config), T.nilable(Vonage::Conversation))
+    end
+
     # @return [Conversations]
     #
+    # @deprecated Please use {#conversation} instead
+    #
     sig { returns(T.nilable(Vonage::Conversations)) }
     def conversations
       @conversations ||= T.let(Conversations.new(config), T.nilable(Vonage::Conversations))

data/lib/vonage/conversation/event/list_response.rb

@@ -0,0 +1,11 @@
+# typed: true
+
+class Vonage::Conversation::Event::ListResponse < Vonage::Response
+  include Enumerable
+
+  def each
+    return enum_for(:each) unless block_given?
+
+    @entity._embedded.each { |item| yield item }
+  end
+end

data/lib/vonage/conversation/event.rb

@@ -0,0 +1,108 @@
+# typed: true
+# frozen_string_literal: true
+
+module Vonage
+  class Conversation::Event < Namespace
+    self.authentication = BearerToken
+
+    self.request_body = JSON
+
+    # List conversation events
+    #
+    # @example
+    #   response = client.conversation.event.list(conversation_id: 'CON-d66d47de-5bcb-4300-94f0-0c9d4b948e9a')
+    #
+    # @param [required, String] :conversation_id The conversation_id of the conversation to list events for
+    #
+    # @param [String] :start_id
+    #   The ID to start returning events at
+    #
+    # @param [String] :end_id
+    #   The ID to end returning events at
+    #
+    # @param [String] :event_type
+    #  The type of event to search for. Does not currently support custom events
+    #
+    # @param [Integer] :page_size
+    #   Return this amount of records in the response.
+    #
+    # @param ['asc', 'desc'] :order
+    #   Return the records in ascending or descending order.
+    #
+    # @param [String] :cursor
+    #   The cursor to start returning results from.
+    #
+    # @return [Conversation::Member::ListResponse]
+    #
+    # @see https://developer.vonage.com/en/api/conversation#getEvents
+    #
+    def list(conversation_id:, **params)  
+      request("/v1/conversations/#{conversation_id}/events", params: params, response_class: ListResponse)
+    end
+
+    # Create an event
+    # @example
+    #   response = client.conversation.event.create(
+    #     conversation_id: 'CON-d66d47de-5bcb-4300-94f0-0c9d4b948e9a',
+    #     type: 'message',
+    #     body: {
+    #       message_type: 'text',
+    #       text: 'Hello World'
+    #     }
+    #   )  
+    #
+    # @param [required, String] :conversation_id The conversation_id of the conversation to create the event for
+    #
+    # @param [required, String] :type
+    #   Event type.
+    #
+    # @param [String] :from
+    #
+    # @option params [required, String] :from
+    #
+    # @param [Hash] :body
+    #   The body of the event. There are many possible properties depending on the event type and message_type
+    #
+    # @return [Response]
+    #
+    # @see https://developer.vonage.com/en/api/conversation#createEvent
+    #
+    def create(conversation_id:, **params)
+      request("/v1/conversations/#{conversation_id}/events", params: params, type: Post)
+    end
+
+    # Get details of a specific event
+    #
+    # @example
+    #   response = client.conversation.event.find(conversation_id: 'CON-d66d47de-5bcb-4300-94f0-0c9d4b948e9a', event_id: 1) 
+    #
+    # @param [required, String] :conversation_id
+    #
+    # @param [required, String] :event_id
+    #
+    # @return [Response]
+    #
+    # @see https://developer.vonage.com/en/api/conversation#getEvent
+    #
+    def find(conversation_id:, event_id:)
+      request("/v1/conversations/#{conversation_id}/events/#{event_id}")
+    end
+
+    # Delete an event.
+    #
+    # @example
+    #   response = client.conversation.event.delete(conversation_id: 'CON-d66d47de-5bcb-4300-94f0-0c9d4b948e9a', event_id: 1)
+    #
+    # @param [String] :conversation_id
+    #
+    # @param [String] :event_id
+    #
+    # @return [Response]
+    #
+    # @see https://developer.vonage.com/en/api/conversation#deleteEvent
+    #
+    def delete(conversation_id:, event_id:)
+      request("/v1/conversations/#{conversation_id}/events/#{event_id}", type: Delete)
+    end
+  end
+end

data/lib/vonage/conversation/list_response.rb

@@ -0,0 +1,11 @@
+# typed: true
+
+class Vonage::Conversation::ListResponse < Vonage::Response
+  include Enumerable
+
+  def each
+    return enum_for(:each) unless block_given?
+
+    @entity._embedded.conversations.each { |item| yield item }
+  end
+end

data/lib/vonage/conversation/member/list_response.rb

@@ -0,0 +1,11 @@
+# typed: true
+
+class Vonage::Conversation::Member::ListResponse < Vonage::Response
+  include Enumerable
+
+  def each
+    return enum_for(:each) unless block_given?
+
+    @entity._embedded.members.each { |item| yield item }
+  end
+end

data/lib/vonage/conversation/member.rb

@@ -0,0 +1,134 @@
+# typed: true
+# frozen_string_literal: true
+
+module Vonage
+  class Conversation::Member < Namespace
+    self.authentication = BearerToken
+
+    self.request_body = JSON
+
+    # List members of a conversation
+    #
+    # @example
+    #   response = client.conversation.member.list(conversation_id: 'CON-d66d47de-5bcb-4300-94f0-0c9d4b948e9a')
+    #
+    # @param [required, String] :conversation_id The conversation_id of the conversation to list members for
+    #
+    # @param [Integer] :page_size
+    #   Return this amount of records in the response.
+    #
+    # @param ['asc', 'desc'] :order
+    #   Return the records in ascending or descending order.
+    #
+    # @param [String] :cursor
+    #   The cursor to start returning results from.
+    #
+    # @return [Conversation::Member::ListResponse]
+    #
+    # @see https://developer.vonage.com/en/api/conversation#getMembers
+    #
+    def list(conversation_id:, **params)
+      request("/v1/conversations/#{conversation_id}/members", params: params, response_class: ListResponse)
+    end
+
+    # Create a member.
+    #
+    # @example
+    #   response = client.conversation.member.create(
+    #     conversation_id: 'CON-d66d47de-5bcb-4300-94f0-0c9d4b948e9a',
+    #     user: {
+    #       id: 'USR-82e028d9-5201-4f1e-8188-604b2d3471ec'
+    #     }
+    #   )
+    #
+    # @param [required, String] :conversation_id The conversation_id of the conversation for which to create the member
+    #
+    # @param [String] :state Must be one of ['invited', 'joined']
+    #
+    # @param [Hash] :user (Either :id or :name is required)
+    #   - @option user [String] :id The user_id of the user to add to the conversation
+    #   - @option user [String] :name The name of the user to add to the conversation
+    #
+    # @param [Hash] :channel
+    #   - @option channel [required, String] :type The type of channel
+    #   - @option channel [Hash] :from
+    #     - @option from [String] :type
+    #     - @option from [String] :number
+    #     - @option from [String] :id
+    #   - @option channel [Hash] :to
+    #     - @option from [String] :type 
+    #     - @option from [String] :user
+    #     - @option from [String] :number
+    #     - @option from [String] :id
+    #
+    # @param [Hash] :media
+    #   - @option media [Boolean] :audio
+    #   - @option media [Hash] :audio_settings
+    #     - @option audio_settings [Boolean] :enabled
+    #     - @option audio_settings [Boolean] :earmuffed
+    #     - @option audio_settings [Boolean] :muted
+    #
+    # @param [String] :knocking_id
+    #
+    # @param [String] :member_id_inviting
+    #
+    # @param [String] :from
+    #
+    # @return [Response]
+    #
+    # @see https://developer.vonage.com/en/api/conversation#createMember
+    #
+    def create(conversation_id:, **params)
+      request("/v1/conversations/#{conversation_id}/members", params: params, type: Post)
+    end
+
+    # Retrieve a member
+    #
+    # @example
+    #   response = client.conversation.member.find(
+    #     conversation_id: 'CON-d66d47de-5bcb-4300-94f0-0c9d4b948e9a',
+    #     member_id: 'MEM-63f61863-4a51-4f6b-86e1-46edebio0391'
+    #   )  
+    #
+    # @param [required, String] :conversation_id
+    #
+    # @param [required, String] :member_id
+    #
+    # @return [Response]
+    #
+    # @see https://developer.vonage.com/en/api/conversation#getMember
+    #
+    def find(conversation_id:, member_id:)   
+      request("/v1/conversations/#{conversation_id}/members/#{member_id}", response_class: Vonage::Response)
+    end
+
+    # Update a member
+    #
+    # @example
+    #   response = client.conversation.member.update(
+    #     conversation_id: 'CON-d66d47de-5bcb-4300-94f0-0c9d4b948e9a',
+    #     member_id: 'MEM-63f61863-4a51-4f6b-86e1-46edebio0391',
+    #     state: 'left'
+    #   )  
+    #
+    # @param [required, String] :conversation_id
+    #
+    # @param [required, String] :member_id
+    #
+    # @param [String] :state Must be one of ['joined', 'left']
+    #
+    # @param [String] :from
+    #
+    # @param [Hash] :reason
+    #  - @option reason [String] :code
+    #  - @option reason [String] :text
+    #
+    # @return [Response]
+    #
+    # @see https://developer.vonage.com/en/api/conversation#updateMember
+    #
+    def update(conversation_id:, member_id:, **params)
+      request("/v1/conversations/#{conversation_id}/members/#{member_id}", params: params, type: Patch)
+    end
+  end
+end

data/lib/vonage/conversation/user/conversations_list_response.rb

@@ -0,0 +1,11 @@
+# typed: true
+
+class Vonage::Conversation::User::ConversationsListResponse < Vonage::Response
+  include Enumerable
+
+  def each
+    return enum_for(:each) unless block_given?
+
+    @entity._embedded.conversations.each { |item| yield item }
+  end
+end

data/lib/vonage/conversation/user/sessions_list_response.rb

@@ -0,0 +1,11 @@
+# typed: true
+
+class Vonage::Conversation::User::SessionsListResponse < Vonage::Response
+  include Enumerable
+
+  def each
+    return enum_for(:each) unless block_given?
+
+    @entity._embedded.sessions.each { |item| yield item }
+  end
+end

data/lib/vonage/conversation/user.rb

@@ -0,0 +1,67 @@
+# typed: true
+# frozen_string_literal: true
+
+module Vonage
+  class Conversation::User < Namespace
+    self.authentication = BearerToken
+
+    # List conversations associated with a user.
+    #
+    # @example
+    #   response = client.conversation.user.list_conversations(user_id: 'USR-82e028d9-5201-4f1e-8188-604b2d3471ec')
+    #
+    # @param [required, String] :user_id The user_id of the user to list conversations for
+    #
+    # @param [String] :state Must be one of ['INVITED', 'JOINED', 'LEFT']
+    #
+    # @param [String] :order_by Must be one of ['created', 'custom_sort_key']
+    #
+    # @param [Boolean] :include_custom_data
+    # @param [String] :date_start
+    #   Return the records that occurred after this point in time.
+    #
+    # @param [String] :date_start
+    #   Return the records that occurred after this point in time.
+    #
+    # @param [Integer] :page_size
+    #   Return this amount of records in the response.
+    #
+    # @param ['asc', 'desc'] :order
+    #   Return the records in ascending or descending order.
+    #
+    # @param [String] :cursor
+    #   The cursor to start returning results from.
+    #
+    # @return [Conversation::User::ConversationsListResponse]
+    #
+    # @see https://developer.vonage.com/en/api/conversation#getuserConversations
+    #
+    def list_conversations(user_id:, **params)
+      request("/v1/users/#{user_id}/conversations", params: params, response_class: ConversationsListResponse)
+    end
+
+    # List conversations associated with a user.
+    #
+    # @example
+    #   response = client.conversation.user.list_sessions(user_id: 'USR-82e028d9-5201-4f1e-8188-604b2d3471ec')
+    #
+    # @param [required, String] :user_id The user_id of the user to list sessions for
+    #
+    # @param [Integer] :page_size
+    #   Return this amount of records in the response.
+    #
+    # @param ['asc', 'desc'] :order
+    #   Return the records in ascending or descending order.
+    #
+    # @param [String] :cursor
+    #   The cursor to start returning results from.
+    #
+    # @return [Conversation::User::SessionsListResponse]
+    #
+    # @see https://developer.vonage.com/en/api/conversation#getuserSessions
+    #
+    def list_sessions(user_id:, **params)
+      request("/v1/users/#{user_id}/sessions", params: params, response_class: SessionsListResponse)
+    end
+  end
+end

data/lib/vonage/conversation.rb

@@ -0,0 +1,164 @@
+# typed: strict
+# frozen_string_literal: true
+
+module Vonage
+  class Conversation < Namespace
+    extend T::Sig
+
+    self.authentication = BearerToken
+
+    self.request_body = JSON
+
+    # List conversations associated with a Vonage application.
+    #
+    # @example
+    #   response = client.conversation.list
+    #
+    # @param [String] :date_start
+    #   Return the records that occurred after this point in time.
+    #
+    # @param [String] :date_end
+    #   Return the records that occurred before this point in time.
+    #
+    # @param [Integer] :page_size
+    #   Return this amount of records in the response.
+    #
+    # @param ['asc', 'desc'] :order
+    #   Return the records in ascending or descending order.
+    #
+    # @param [String] :cursor
+    #   The cursor to start returning results from.
+    #  
+    # @return [Conversation::ListResponse]
+    #
+    # @see https://developer.vonage.com/en/api/conversation#listConversations
+    #
+    def list(**params)
+      request('/v1/conversations', params: params, response_class: ListResponse)
+    end
+
+    # Create a conversation.
+    #
+    # @example
+    #   response = client.conversation.create(name: 'Example Conversation', display_name: 'Example Display Name')
+    #
+    # @param [String] :name
+    #   Your internal conversation name. Must be unique.
+    #
+    # @param [String] :display_name
+    #   The public facing name of the conversation.
+    #
+    # @param [String] :image_url
+    #   An image URL that you associate with the conversation
+    #
+    # @param [Hash] :properties
+    #   - :ttl (Integer) After how many seconds an empty conversation is deleted
+    #   - :type (String)
+    #   - :custom_sort_key (String)
+    #   - :custom_data (Hash) Custom key/value pairs to be included with conversation data
+    #
+    # @option params [Array] :numbers An array of Hashes containing number information for different channels.
+    #
+    # @option params [Hash] :callback
+    #   - @option callback :url (String)
+    #   - @option callback :event_mask (String)
+    #   - @option callback :params (Hash)
+    #     - @option params :applicationId (String)
+    #     - @option params :ncco_url (String)
+    #   - @option callback :method (String) Must be one of ['POST', 'GET']
+    #
+    # @return [Response]
+    #
+    # @see https://developer.vonage.com/en/api/conversation#createConversation
+    #
+    def create(**params)
+      request('/v1/conversations', params: params, type: Post)
+    end
+
+    # Retrieve a conversation.
+    #
+    # @example
+    #   response = client.conversation.find(conversation_id: 'CON-d66d47de-5bcb-4300-94f0-0c9d4b948e9a')
+    #
+    # @param [String] :conversation_id
+    #
+    # @return [Response]
+    #
+    # @see https://developer.vonage.com/en/api/conversation#retrieveConversation
+    #
+    def find(conversation_id:)
+      request("/v1/conversations/#{conversation_id}")
+    end
+
+    # Update a conversation.
+    #
+    # @example
+    #   response = client.conversation.update(conversation_id: 'CON-d66d47de-5bcb-4300-94f0-0c9d4b948e9a', display_name: 'Updated conversation')
+    #
+    # @param [String] :name
+    #   Your internal conversation name. Must be unique.
+    #
+    # @param [String] :display_name
+    #   The public facing name of the conversation.
+    #
+    # @param [String] :image_url
+    #   An image URL that you associate with the conversation
+    #
+    # @param [Hash] :properties
+    #   - @option properties :ttl (Integer) After how many seconds an empty conversation is deleted
+    #   - @option properties :type (String)
+    #   - @option properties :custom_sort_key (String)
+    #   - @option properties :custom_data (Hash) Custom key/value pairs to be included with conversation data
+    #
+    # @param [Array] :numbers An array of Hashes containing number information for different channels.
+    #
+    # @option params [Hash] :callback
+    #   - @option callback :url (String)
+    #   - @option callback :event_mask (String)
+    #   - @option callback :params (Hash)
+    #     - @option params :applicationId (String)
+    #     - @option params :ncco_url (String)
+    #   - @option callback :method (String) Must be one of ['POST', 'GET']
+    #
+    # @return [Response]
+    #
+    # @see https://developer.vonage.com/en/api/conversation#replaceConversation
+    #
+    def update(conversation_id:, **params)
+      request("/v1/conversations/#{conversation_id}", params: params, type: Put)
+    end
+
+    # Delete a conversation.
+    #
+    # @example
+    #   response = client.conversation.delete(conversation_id: 'CON-d66d47de-5bcb-4300-94f0-0c9d4b948e9a')
+    #
+    # @param [String] :conversation_id
+    #
+    # @return [Response]
+    #
+    # @see https://developer.vonage.com/en/api/conversation#deleteConversation
+    #
+    def delete(conversation_id:)
+      request("/v1/conversations/#{conversation_id}", type: Delete)
+    end
+
+    # @return [Conversation::User]
+    sig { returns(T.nilable(Vonage::Conversation::User)) }
+    def user
+      @user ||= User.new(@config)
+    end
+
+    # @return [Conversation::Member]
+    sig { returns(T.nilable(Vonage::Conversation::Member)) }
+    def member
+      @member ||= Member.new(@config)
+    end
+
+    # @return [Conversation::Event]
+    sig { returns(T.nilable(Vonage::Conversation::Event)) }
+    def event
+      @event ||= Event.new(@config)
+    end
+  end
+end

data/lib/vonage/conversations/events.rb

@@ -9,6 +9,8 @@ module Vonage
 
     # Create an event.
     #
+    # @deprecated Please use {Vonage::Conversation::Event#create} instead
+    #
     # @option params [required, String] :type
     #   Event type.
     #
@@ -29,11 +31,14 @@ module Vonage
     # @see https://developer.nexmo.com/api/conversation#createEvent
     #
     def create(conversation_id, params)
+      logger.info('This method is deprecated and will be removed in a future release. Please use `Vonage::Conversation::Event#create` instead.')
       request('/beta/conversations/' + conversation_id + '/events', params: params, type: Post)
     end
 
     # List events.
     #
+    # @deprecated Please use {Vonage::Conversation::Event#list} instead
+    #
     # @param [String] conversation_id
     #
     # @option params [Boolean] :auto_advance
@@ -45,11 +50,14 @@ module Vonage
     # @see https://developer.nexmo.com/api/conversation#getEvents
     #
     def list(conversation_id, params = nil, auto_advance = true)
+      logger.info('This method is deprecated and will be removed in a future release. Please use `Vonage::Conversation::Event#list` instead.')
       request('/beta/conversations/' + conversation_id + '/events', params: params)
     end
 
     # Retrieve an event.
     #
+    # @deprecated Please use {Vonage::Conversation::Event#find} instead
+    #
     # @param [String] conversation_id
     # @param [String] event_id
     #
@@ -58,11 +66,14 @@ module Vonage
     # @see https://developer.nexmo.com/api/conversation#getEvent
     #
     def get(conversation_id, event_id)
+      logger.info('This method is deprecated and will be removed in a future release. Please use `Vonage::Conversation::Event#find` instead.')
       request('/beta/conversations/' + conversation_id + '/events/' + event_id.to_s)
     end
 
     # Delete an event.
     #
+    # @deprecated Please use {Vonage::Conversation::Event#delete} instead
+    #
     # @param [String] conversation_id
     # @param [String] event_id
     #
@@ -71,6 +82,7 @@ module Vonage
     # @see https://developer.nexmo.com/api/conversation#deleteEvent
     #
     def delete(conversation_id, event_id)
+      logger.info('This method is deprecated and will be removed in a future release. Please use `Vonage::Conversation::Event#delete` instead.')
       request('/beta/conversations/' + conversation_id + '/events/' + event_id.to_s, type: Delete)
     end
   end

data/lib/vonage/conversations/legs.rb

@@ -7,6 +7,8 @@ module Vonage
 
     # List legs.
     #
+    # @deprecated
+    #
     # @option params [Boolean] :auto_advance
     #   Set this to `false` to not auto-advance through all the pages in the record
     #   and collect all the data. The default is `true`.     
@@ -16,11 +18,14 @@ module Vonage
     # @see https://developer.nexmo.com/api/conversation#listLegs
     #
     def list(params = nil, auto_advance = true)
+      logger.info('This method is deprecated and will be removed in a future release.')
       request('/beta/legs', params: params)
     end
 
     # Delete a leg.
     #
+    # @deprecated
+    #
     # @param [String] leg_id
     #
     # @return [Response]
@@ -28,6 +33,7 @@ module Vonage
     # @see https://developer.nexmo.com/api/conversation#deleteLeg
     #
     def delete(leg_id)
+      logger.info('This method is deprecated and will be removed in a future release.')
       request('/beta/legs/' + leg_id, type: Delete)
     end
   end

data/lib/vonage/conversations/members.rb

@@ -9,6 +9,8 @@ module Vonage
 
     # Create a member.
     #
+    # @deprecated Please use {Vonage::Conversation::Member#create} instead
+    #
     # @option params [String] :action
     #   Invite or join a member to a conversation.
     #   Must be one of: `invite` or `join`.
@@ -40,11 +42,14 @@ module Vonage
     # @see https://developer.nexmo.com/api/conversation#createMember
     #
     def create(conversation_id, params)
+      logger.info('This method is deprecated and will be removed in a future release. Please use `Vonage::Conversation::Member#create` instead.')
       request('/beta/conversations/' + conversation_id + '/members', params: params, type: Post)
     end
 
     # List members.
     #
+    # @deprecated Please use {Vonage::Conversation::Member#list} instead
+    #
     # @param [String] conversation_id
     #
     # @option params [Boolean] :auto_advance
@@ -56,11 +61,14 @@ module Vonage
     # @see https://developer.nexmo.com/api/conversation#getMembers
     #
     def list(conversation_id, params = nil, auto_advance = true)
+      logger.info('This method is deprecated and will be removed in a future release. Please use `Vonage::Conversation::Member#list` instead.')
       request('/beta/conversations/' + conversation_id + '/members', params: params)
     end
 
     # Retrieve a member.
     #
+    # @deprecated Please use {Vonage::Conversation::Member#find} instead
+    #
     # @param [String] conversation_id
     # @param [String] member_id
     #
@@ -69,11 +77,14 @@ module Vonage
     # @see https://developer.nexmo.com/api/conversation#getMember
     #
     def get(conversation_id, member_id)
+      logger.info('This method is deprecated and will be removed in a future release. Please use `Vonage::Conversation::Member#find` instead.')
       request('/beta/conversations/' + conversation_id + '/members/' + member_id)
     end
 
     # Update a member.
     #
+    # @deprecated Please use {Vonage::Conversation::Member#update} instead
+    #
     # @option params [String] :action
     #   Invite or join a member to a conversation.
     #
@@ -89,11 +100,14 @@ module Vonage
     # @see https://developer.nexmo.com/api/conversation#updateMember
     #
     def update(conversation_id, member_id, params)
+      logger.info('This method is deprecated and will be removed in a future release. Please use `Vonage::Conversation::Member#update` instead.')
       request('/beta/conversations/' + conversation_id + '/members/' + member_id, params: params, type: Put)
     end
 
     # Delete a member.
     #
+    # @deprecated
+    #
     # @param [String] conversation_id
     # @param [String] member_id
     #
@@ -102,6 +116,7 @@ module Vonage
     # @see https://developer.nexmo.com/api/conversation#deleteMember
     #
     def delete(conversation_id, member_id)
+      logger.info('This method is deprecated and will be removed in a future release.')
       request('/beta/conversations/' + conversation_id + '/members/' + member_id, type: Delete)
     end
   end

data/lib/vonage/conversations/users.rb

@@ -9,6 +9,8 @@ module Vonage
 
     # Create a user.
     #
+    # @deprecated Please use {Vonage::Users#create} instead
+    #
     # @option params [String] :name
     #   Unique name for a user.
     #
@@ -26,11 +28,14 @@ module Vonage
     # @see https://developer.nexmo.com/api/conversation#createUser
     #
     def create(params)
+      logger.info('This method is deprecated and will be removed in a future release. Please use `Vonage::Users#create` instead.')
       request('/beta/users', params: params, type: Post)
     end
 
     # List users.
     #
+    # @deprecated Please use {Vonage::Users#list} instead
+    #
     # @option params [Boolean] :auto_advance
     #   Set this to `false` to not auto-advance through all the pages in the record
     #   and collect all the data. The default is `true`.
@@ -40,11 +45,14 @@ module Vonage
     # @see https://developer.nexmo.com/api/conversation#getUsers
     #
     def list(params = nil, auto_advance = true)
+      logger.info('This method is deprecated and will be removed in a future release. Please use `Vonage::Users#list` instead.')
       request('/beta/users', params: params)
     end
 
     # Retrieve a user.
     #
+    # @deprecated Please use {Vonage::Users#find} instead
+    #
     # @param [String] id
     #
     # @return [Response]
@@ -52,11 +60,14 @@ module Vonage
     # @see https://developer.nexmo.com/api/conversation#getUser
     #
     def get(id)
+      logger.info('This method is deprecated and will be removed in a future release. Please use `Vonage::Users#find` instead.')
       request('/beta/users/' + id)
     end
 
     # Update a user.
     #
+    # @deprecated Please use {Vonage::Users#update} instead
+    #
     # @option params [String] :name
     #   Unique name for a user.
     #
@@ -79,11 +90,14 @@ module Vonage
     # @see https://developer.nexmo.com/api/conversation#updateUser
     #
     def update(id, params)
+      logger.info('This method is deprecated and will be removed in a future release. Please use `Vonage::Users#update` instead.')
       request('/beta/users/' + id, params: params, type: Put)
     end
 
     # Delete a user.
     #
+    # @deprecated Please use {Vonage::Users#delete} instead
+    #
     # @param [String] id
     #
     # @return [Response]
@@ -91,6 +105,7 @@ module Vonage
     # @see https://developer.nexmo.com/api/conversation#deleteUser
     #
     def delete(id)
+      logger.info('This method is deprecated and will be removed in a future release. Please use `Vonage::Users#delete` instead.')
       request('/beta/users/' + id, type: Delete)
     end
   end

data/lib/vonage/conversations.rb

@@ -11,6 +11,8 @@ module Vonage
 
     # Create a conversation.
     #
+    # @deprecated Please use {Vonage::Conversation#create} instead
+    #
     # @example
     #   response = client.conversations.create(name: 'Example Conversation', display_name: 'Example Display Name')
     #
@@ -37,11 +39,14 @@ module Vonage
     #
     sig { params(params: T::Hash[Symbol, T.untyped]).returns(Vonage::Response) }
     def create(params)
+      logger.info('This method is deprecated and will be removed in a future release. Please use `Vonage::Conversation#create` instead.')
       request('/beta/conversations', params: params, type: Post)
     end
 
     # List all conversations associated with your application.
     #
+    # @deprecated Please use {Vonage::Conversation#list} instead
+    #
     # @example
     #   response = client.conversations.list
     #
@@ -71,6 +76,7 @@ module Vonage
     #
     sig { params(params: T.nilable(T::Hash[Symbol, T.untyped]), auto_advance: T::Boolean).returns(Vonage::Response) }
     def list(params = nil, auto_advance = true)
+      logger.info('This method is deprecated and will be removed in a future release. Please use `Vonage::Conversation#list` instead.')
       if params && !params.key?(:auto_advance)
         params.merge!(auto_advance: true)
       end
@@ -80,6 +86,8 @@ module Vonage
 
     # Retrieve a conversation.
     #
+    # @deprecated Please use {Vonage::Conversation#find} instead
+    #
     # @example
     #   response = client.conversations.get(id)
     #
@@ -91,11 +99,14 @@ module Vonage
     #
     sig { params(id: String).returns(Vonage::Response) }
     def get(id)
+      logger.info('This method is deprecated and will be removed in a future release. Please use `Vonage::Conversation#find` instead.')
       request('/beta/conversations/' + id)
     end
   
     # Update a conversation.
     #
+    # @deprecated Please use {Vonage::Conversation#update} instead
+    #
     # @example
     #   response = client.conversations.update(id, display_name: 'Updated conversation')
     #
@@ -127,11 +138,14 @@ module Vonage
       params: T::Hash[Symbol, T.untyped]
     ).returns(Vonage::Response) }
     def update(id, params)
+      logger.info('This method is deprecated and will be removed in a future release. Please use `Vonage::Conversation#update` instead.')
       request('/beta/conversations/' + id, params: params, type: Put)
     end
 
     # Delete a conversation.
     #
+    # @deprecated Please use {Vonage::Conversation#delete} instead
+    #
     # @example
     #   response = client.conversations.delete(id)
     #
@@ -143,11 +157,14 @@ module Vonage
     #
     sig { params(id: String).returns(Vonage::Response) }
     def delete(id)
+      logger.info('This method is deprecated and will be removed in a future release. Please use `Vonage::Conversation#delete` instead.')
       request('/beta/conversations/' + id, type: Delete)
     end
 
     # Record a conversation.
     #
+    # @deprecated
+    #
     # @example
     #   response = client.conversations.record(id, action: 'start')
     #
@@ -178,13 +195,17 @@ module Vonage
       params: T::Hash[Symbol, T.untyped]
     ).returns(Vonage::Response) }
     def record(id, params)
+      logger.info('This method is deprecated and will be removed in a future release.')
       request('/v1/conversations/' + id + '/record', params: params, type: Put)
     end
 
     # @return [Events]
     #
+    # @deprecated Please use {Vonage::Conversation#event} instead
+    #
     sig { returns(T.nilable(Vonage::Conversations::Events)) }
     def events
+      logger.info('This method is deprecated and will be removed in a future release. Please use `Vonage::Conversation#event` instead.')
       @events = T.let(@events, T.nilable(Vonage::Conversations::Events))
       @config = T.let(@config, T.nilable(Vonage::Config))
       @events ||= Events.new(@config)
@@ -192,24 +213,33 @@ module Vonage
 
     # @return [Legs]
     #
+    # @deprecated
+    #
     sig { returns(T.nilable(Vonage::Conversations::Legs)) }
     def legs
+      logger.info('This method is deprecated and will be removed in a future release.')
       @legs = T.let(@legs, T.nilable(Vonage::Conversations::Legs))
       @legs ||= Legs.new(@config)
     end
 
     # @return [Members]
     #
+    # @deprecated Please use {Vonage::Conversation#member} instead
+    #
     sig { returns(T.nilable(Vonage::Conversations::Members)) }
     def members
+      logger.info('This method is deprecated and will be removed in a future release. Please use `Vonage::Conversation#member` instead.')
       @members = T.let(@members, T.nilable(Vonage::Conversations::Members))
       @members ||= Members.new(@config)
     end
 
     # @return [Users]
     #
+    # @deprecated Please use {Vonage::Conversation#user} instead
+    #
     sig { returns(T.nilable(Vonage::Conversations::Users)) }
     def users
+      logger.info('This method is deprecated and will be removed in a future release. Please use `Vonage::Conversation#user` instead.')
       @users = T.let(@users, T.nilable(Vonage::Conversations::Users))
       @users ||= Users.new(@config)
     end

data/lib/vonage/version.rb

@@ -1,5 +1,5 @@
 # typed: strong
 
 module Vonage
-  VERSION = '7.21.0'
+  VERSION = '7.22.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: vonage
 version: !ruby/object:Gem::Version
-  version: 7.21.0
+  version: 7.22.0
 platform: ruby
 authors:
 - Vonage
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-02-21 00:00:00.000000000 Z
+date: 2024-03-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: vonage-jwt
@@ -142,6 +142,15 @@ files:
 - lib/vonage/client.rb
 - lib/vonage/client_error.rb
 - lib/vonage/config.rb
+- lib/vonage/conversation.rb
+- lib/vonage/conversation/event.rb
+- lib/vonage/conversation/event/list_response.rb
+- lib/vonage/conversation/list_response.rb
+- lib/vonage/conversation/member.rb
+- lib/vonage/conversation/member/list_response.rb
+- lib/vonage/conversation/user.rb
+- lib/vonage/conversation/user/conversations_list_response.rb
+- lib/vonage/conversation/user/sessions_list_response.rb
 - lib/vonage/conversations.rb
 - lib/vonage/conversations/events.rb
 - lib/vonage/conversations/legs.rb