twilio-api-sdk 1.0.0

data/lib/twilio_ap_is/apis/conversations_v1_conversation_api.rb

@@ -0,0 +1,550 @@
+# twilio_ap_is
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module TwilioApIs
+  # ConversationsV1ConversationApi
+  class ConversationsV1ConversationApi < BaseApi
+    # Create a new conversation in your account's default service
+    # @param [ChannelWebhookEnabledType] x_twilio_webhook_enabled Optional
+    # parameter: The X-Twilio-Webhook-Enabled HTTP request header
+    # @param [String] friendly_name Optional parameter: The human-readable name
+    # of this conversation, limited to 256 characters. Optional.
+    # @param [String] unique_name Optional parameter: 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 [DateTime] date_created Optional parameter: The date that this
+    # resource was created.
+    # @param [DateTime] date_updated Optional parameter: The date that this
+    # resource was last updated.
+    # @param [String] messaging_service_sid Optional parameter: The unique ID of
+    # the [Messaging
+    # Service](https://www.twilio.com/docs/messaging/api/service-resource) this
+    # conversation belongs to.
+    # @param [String] attributes Optional parameter: 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 [ConversationState] state Optional parameter: Current state of this
+    # conversation. Can be either `initializing`, `active`, `inactive` or
+    # `closed` and defaults to `active`
+    # @param [String] timers_inactive Optional parameter: ISO8601 duration when
+    # conversation will be switched to `inactive` state. Minimum value for this
+    # timer is 1 minute.
+    # @param [String] timers_closed Optional parameter: ISO8601 duration when
+    # conversation will be switched to `closed` state. Minimum value for this
+    # timer is 10 minutes.
+    # @param [String] bindings_email_address Optional parameter: The default
+    # email address that will be used when sending outbound emails in this
+    # conversation.
+    # @param [String] bindings_email_name Optional parameter: The default name
+    # that will be used when sending outbound emails in this conversation.
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def create_conversation(x_twilio_webhook_enabled: nil,
+                            friendly_name: nil,
+                            unique_name: nil,
+                            date_created: nil,
+                            date_updated: nil,
+                            messaging_service_sid: nil,
+                            attributes: nil,
+                            state: nil,
+                            timers_inactive: nil,
+                            timers_closed: nil,
+                            bindings_email_address: nil,
+                            bindings_email_name: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/v1/Conversations',
+                                     Server::DEFAULT2)
+                   .header_param(new_parameter(x_twilio_webhook_enabled, key: 'X-Twilio-Webhook-Enabled'))
+                   .form_param(new_parameter(friendly_name, key: 'FriendlyName'))
+                   .form_param(new_parameter(unique_name, key: 'UniqueName'))
+                   .form_param(new_parameter(date_created, key: 'DateCreated'))
+                   .form_param(new_parameter(date_updated, key: 'DateUpdated'))
+                   .form_param(new_parameter(messaging_service_sid, key: 'MessagingServiceSid'))
+                   .form_param(new_parameter(attributes, key: 'Attributes'))
+                   .form_param(new_parameter(state, key: 'State'))
+                   .form_param(new_parameter(timers_inactive, key: 'Timers.Inactive'))
+                   .form_param(new_parameter(timers_closed, key: 'Timers.Closed'))
+                   .form_param(new_parameter(bindings_email_address, key: 'Bindings.Email.Address'))
+                   .form_param(new_parameter(bindings_email_name, key: 'Bindings.Email.Name'))
+                   .header_param(new_parameter('application/x-www-form-urlencoded', key: 'content-type'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('accountSid_authToken')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(Conversation.method(:from_hash))
+                    .is_api_response(true))
+        .execute
+    end
+
+    # Retrieve a list of conversations in your account's default service
+    # @param [String] start_date Optional parameter: Specifies the beginning of
+    # the date range for filtering Conversations based on their creation date.
+    # Conversations that were created on or after this date will be included in
+    # the results. The date must be in ISO8601 format, specifically starting at
+    # the beginning of the specified date (YYYY-MM-DDT00:00:00Z), for precise
+    # filtering. This parameter can be combined with other filters. If this
+    # filter is used, the returned list is sorted by latest conversation
+    # creation date in descending order.
+    # @param [String] end_date Optional parameter: Defines the end of the date
+    # range for filtering conversations by their creation date. Only
+    # conversations that were created on or before this date will appear in the
+    # results.  The date must be in ISO8601 format, specifically capturing up to
+    # the end of the specified date (YYYY-MM-DDT23:59:59Z), to ensure that
+    # conversations from the entire end day are included. This parameter can be
+    # combined with other filters. If this filter is used, the returned list is
+    # sorted by latest conversation creation date in descending order.
+    # @param [ConversationState] state Optional parameter: State for sorting and
+    # filtering list of Conversations. Can be `active`, `inactive` or `closed`
+    # @param [Integer] page_size Optional parameter: How many resources to
+    # return in each list page. The default is 50, and the maximum is 100.
+    # @param [Integer] page Optional parameter: The page index. This value is
+    # simply for client state.
+    # @param [String] page_token Optional parameter: The page token. This is
+    # provided by the API.
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def list_conversation(start_date: nil,
+                          end_date: nil,
+                          state: nil,
+                          page_size: nil,
+                          page: nil,
+                          page_token: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/v1/Conversations',
+                                     Server::DEFAULT2)
+                   .query_param(new_parameter(start_date, key: 'StartDate'))
+                   .query_param(new_parameter(end_date, key: 'EndDate'))
+                   .query_param(new_parameter(state, key: 'State'))
+                   .query_param(new_parameter(page_size, key: 'PageSize'))
+                   .query_param(new_parameter(page, key: 'Page'))
+                   .query_param(new_parameter(page_token, key: 'PageToken'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('accountSid_authToken')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(ListConversationResponse.method(:from_hash))
+                    .is_api_response(true))
+        .execute
+    end
+
+    # Update an existing conversation in your account's default service
+    # @param [String] sid Required parameter: A 34 character string that
+    # uniquely identifies this resource. Can also be the `unique_name` of the
+    # Conversation.
+    # @param [ChannelWebhookEnabledType] x_twilio_webhook_enabled Optional
+    # parameter: The X-Twilio-Webhook-Enabled HTTP request header
+    # @param [String] friendly_name Optional parameter: The human-readable name
+    # of this conversation, limited to 256 characters. Optional.
+    # @param [DateTime] date_created Optional parameter: The date that this
+    # resource was created.
+    # @param [DateTime] date_updated Optional parameter: The date that this
+    # resource was last updated.
+    # @param [String] attributes Optional parameter: 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 [String] messaging_service_sid Optional parameter: The unique ID of
+    # the [Messaging
+    # Service](https://www.twilio.com/docs/messaging/api/service-resource) this
+    # conversation belongs to.
+    # @param [ConversationState] state Optional parameter: Current state of this
+    # conversation. Can be either `initializing`, `active`, `inactive` or
+    # `closed` and defaults to `active`
+    # @param [String] timers_inactive Optional parameter: ISO8601 duration when
+    # conversation will be switched to `inactive` state. Minimum value for this
+    # timer is 1 minute.
+    # @param [String] timers_closed Optional parameter: ISO8601 duration when
+    # conversation will be switched to `closed` state. Minimum value for this
+    # timer is 10 minutes.
+    # @param [String] unique_name Optional parameter: 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 [String] bindings_email_address Optional parameter: The default
+    # email address that will be used when sending outbound emails in this
+    # conversation.
+    # @param [String] bindings_email_name Optional parameter: The default name
+    # that will be used when sending outbound emails in this conversation.
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def update_conversation(sid,
+                            x_twilio_webhook_enabled: nil,
+                            friendly_name: nil,
+                            date_created: nil,
+                            date_updated: nil,
+                            attributes: nil,
+                            messaging_service_sid: nil,
+                            state: nil,
+                            timers_inactive: nil,
+                            timers_closed: nil,
+                            unique_name: nil,
+                            bindings_email_address: nil,
+                            bindings_email_name: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/v1/Conversations/{Sid}',
+                                     Server::DEFAULT2)
+                   .template_param(new_parameter(sid, key: 'Sid')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .header_param(new_parameter(x_twilio_webhook_enabled, key: 'X-Twilio-Webhook-Enabled'))
+                   .form_param(new_parameter(friendly_name, key: 'FriendlyName'))
+                   .form_param(new_parameter(date_created, key: 'DateCreated'))
+                   .form_param(new_parameter(date_updated, key: 'DateUpdated'))
+                   .form_param(new_parameter(attributes, key: 'Attributes'))
+                   .form_param(new_parameter(messaging_service_sid, key: 'MessagingServiceSid'))
+                   .form_param(new_parameter(state, key: 'State'))
+                   .form_param(new_parameter(timers_inactive, key: 'Timers.Inactive'))
+                   .form_param(new_parameter(timers_closed, key: 'Timers.Closed'))
+                   .form_param(new_parameter(unique_name, key: 'UniqueName'))
+                   .form_param(new_parameter(bindings_email_address, key: 'Bindings.Email.Address'))
+                   .form_param(new_parameter(bindings_email_name, key: 'Bindings.Email.Name'))
+                   .header_param(new_parameter('application/x-www-form-urlencoded', key: 'content-type'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('accountSid_authToken')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(Conversation.method(:from_hash))
+                    .is_api_response(true))
+        .execute
+    end
+
+    # Remove a conversation from your account's default service
+    # @param [String] sid Required parameter: A 34 character string that
+    # uniquely identifies this resource. Can also be the `unique_name` of the
+    # Conversation.
+    # @param [ChannelWebhookEnabledType] x_twilio_webhook_enabled Optional
+    # parameter: The X-Twilio-Webhook-Enabled HTTP request header
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def delete_conversation(sid,
+                            x_twilio_webhook_enabled: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::DELETE,
+                                     '/v1/Conversations/{Sid}',
+                                     Server::DEFAULT2)
+                   .template_param(new_parameter(sid, key: 'Sid')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .header_param(new_parameter(x_twilio_webhook_enabled, key: 'X-Twilio-Webhook-Enabled'))
+                   .auth(Single.new('accountSid_authToken')))
+        .response(new_response_handler
+                    .is_response_void(true)
+                    .is_api_response(true))
+        .execute
+    end
+
+    # Fetch a conversation from your account's default service
+    # @param [String] sid Required parameter: A 34 character string that
+    # uniquely identifies this resource. Can also be the `unique_name` of the
+    # Conversation.
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def fetch_conversation(sid)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/v1/Conversations/{Sid}',
+                                     Server::DEFAULT2)
+                   .template_param(new_parameter(sid, key: 'Sid')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('accountSid_authToken')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(Conversation.method(:from_hash))
+                    .is_api_response(true))
+        .execute
+    end
+
+    # Create a new conversation in your service
+    # @param [String] chat_service_sid Required parameter: The SID of the
+    # [Conversation
+    # Service](https://www.twilio.com/docs/conversations/api/service-resource)
+    # the Conversation resource is associated with.
+    # @param [ChannelWebhookEnabledType] x_twilio_webhook_enabled Optional
+    # parameter: The X-Twilio-Webhook-Enabled HTTP request header
+    # @param [String] friendly_name Optional parameter: The human-readable name
+    # of this conversation, limited to 256 characters. Optional.
+    # @param [String] unique_name Optional parameter: 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 [String] attributes Optional parameter: 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 [String] messaging_service_sid Optional parameter: The unique ID of
+    # the [Messaging
+    # Service](https://www.twilio.com/docs/messaging/api/service-resource) this
+    # conversation belongs to.
+    # @param [DateTime] date_created Optional parameter: The date that this
+    # resource was created.
+    # @param [DateTime] date_updated Optional parameter: The date that this
+    # resource was last updated.
+    # @param [ServiceConversationState] state Optional parameter: Current state
+    # of this conversation. Can be either `initializing`, `active`, `inactive`
+    # or `closed` and defaults to `active`
+    # @param [String] timers_inactive Optional parameter: ISO8601 duration when
+    # conversation will be switched to `inactive` state. Minimum value for this
+    # timer is 1 minute.
+    # @param [String] timers_closed Optional parameter: ISO8601 duration when
+    # conversation will be switched to `closed` state. Minimum value for this
+    # timer is 10 minutes.
+    # @param [String] bindings_email_address Optional parameter: The default
+    # email address that will be used when sending outbound emails in this
+    # conversation.
+    # @param [String] bindings_email_name Optional parameter: The default name
+    # that will be used when sending outbound emails in this conversation.
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def create_service_conversation(chat_service_sid,
+                                    x_twilio_webhook_enabled: nil,
+                                    friendly_name: nil,
+                                    unique_name: nil,
+                                    attributes: nil,
+                                    messaging_service_sid: nil,
+                                    date_created: nil,
+                                    date_updated: nil,
+                                    state: nil,
+                                    timers_inactive: nil,
+                                    timers_closed: nil,
+                                    bindings_email_address: nil,
+                                    bindings_email_name: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/v1/Services/{ChatServiceSid}/Conversations',
+                                     Server::DEFAULT2)
+                   .template_param(new_parameter(chat_service_sid, key: 'ChatServiceSid')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .header_param(new_parameter(x_twilio_webhook_enabled, key: 'X-Twilio-Webhook-Enabled'))
+                   .form_param(new_parameter(friendly_name, key: 'FriendlyName'))
+                   .form_param(new_parameter(unique_name, key: 'UniqueName'))
+                   .form_param(new_parameter(attributes, key: 'Attributes'))
+                   .form_param(new_parameter(messaging_service_sid, key: 'MessagingServiceSid'))
+                   .form_param(new_parameter(date_created, key: 'DateCreated'))
+                   .form_param(new_parameter(date_updated, key: 'DateUpdated'))
+                   .form_param(new_parameter(state, key: 'State'))
+                   .form_param(new_parameter(timers_inactive, key: 'Timers.Inactive'))
+                   .form_param(new_parameter(timers_closed, key: 'Timers.Closed'))
+                   .form_param(new_parameter(bindings_email_address, key: 'Bindings.Email.Address'))
+                   .form_param(new_parameter(bindings_email_name, key: 'Bindings.Email.Name'))
+                   .header_param(new_parameter('application/x-www-form-urlencoded', key: 'content-type'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('accountSid_authToken')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(ServiceConversation.method(:from_hash))
+                    .is_api_response(true))
+        .execute
+    end
+
+    # Retrieve a list of conversations in your service
+    # @param [String] chat_service_sid Required parameter: The SID of the
+    # [Conversation
+    # Service](https://www.twilio.com/docs/conversations/api/service-resource)
+    # the Conversation resource is associated with.
+    # @param [String] start_date Optional parameter: Specifies the beginning of
+    # the date range for filtering Conversations based on their creation date.
+    # Conversations that were created on or after this date will be included in
+    # the results. The date must be in ISO8601 format, specifically starting at
+    # the beginning of the specified date (YYYY-MM-DDT00:00:00Z), for precise
+    # filtering. This parameter can be combined with other filters. If this
+    # filter is used, the returned list is sorted by latest conversation
+    # creation date in descending order.
+    # @param [String] end_date Optional parameter: Defines the end of the date
+    # range for filtering conversations by their creation date. Only
+    # conversations that were created on or before this date will appear in the
+    # results.  The date must be in ISO8601 format, specifically capturing up to
+    # the end of the specified date (YYYY-MM-DDT23:59:59Z), to ensure that
+    # conversations from the entire end day are included. This parameter can be
+    # combined with other filters. If this filter is used, the returned list is
+    # sorted by latest conversation creation date in descending order.
+    # @param [ServiceConversationState] state Optional parameter: State for
+    # sorting and filtering list of Conversations. Can be `active`, `inactive`
+    # or `closed`
+    # @param [Integer] page_size Optional parameter: How many resources to
+    # return in each list page. The default is 50, and the maximum is 100.
+    # @param [Integer] page Optional parameter: The page index. This value is
+    # simply for client state.
+    # @param [String] page_token Optional parameter: The page token. This is
+    # provided by the API.
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def list_service_conversation(chat_service_sid,
+                                  start_date: nil,
+                                  end_date: nil,
+                                  state: nil,
+                                  page_size: nil,
+                                  page: nil,
+                                  page_token: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/v1/Services/{ChatServiceSid}/Conversations',
+                                     Server::DEFAULT2)
+                   .template_param(new_parameter(chat_service_sid, key: 'ChatServiceSid')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .query_param(new_parameter(start_date, key: 'StartDate'))
+                   .query_param(new_parameter(end_date, key: 'EndDate'))
+                   .query_param(new_parameter(state, key: 'State'))
+                   .query_param(new_parameter(page_size, key: 'PageSize'))
+                   .query_param(new_parameter(page, key: 'Page'))
+                   .query_param(new_parameter(page_token, key: 'PageToken'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('accountSid_authToken')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(ListServiceConversationResponse.method(:from_hash))
+                    .is_api_response(true))
+        .execute
+    end
+
+    # Update an existing conversation in your service
+    # @param [String] chat_service_sid Required parameter: The SID of the
+    # [Conversation
+    # Service](https://www.twilio.com/docs/conversations/api/service-resource)
+    # the Conversation resource is associated with.
+    # @param [String] sid Required parameter: A 34 character string that
+    # uniquely identifies this resource. Can also be the `unique_name` of the
+    # Conversation.
+    # @param [ChannelWebhookEnabledType] x_twilio_webhook_enabled Optional
+    # parameter: The X-Twilio-Webhook-Enabled HTTP request header
+    # @param [String] friendly_name Optional parameter: The human-readable name
+    # of this conversation, limited to 256 characters. Optional.
+    # @param [DateTime] date_created Optional parameter: The date that this
+    # resource was created.
+    # @param [DateTime] date_updated Optional parameter: The date that this
+    # resource was last updated.
+    # @param [String] attributes Optional parameter: 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 [String] messaging_service_sid Optional parameter: The unique ID of
+    # the [Messaging
+    # Service](https://www.twilio.com/docs/messaging/api/service-resource) this
+    # conversation belongs to.
+    # @param [ServiceConversationState] state Optional parameter: Current state
+    # of this conversation. Can be either `initializing`, `active`, `inactive`
+    # or `closed` and defaults to `active`
+    # @param [String] timers_inactive Optional parameter: ISO8601 duration when
+    # conversation will be switched to `inactive` state. Minimum value for this
+    # timer is 1 minute.
+    # @param [String] timers_closed Optional parameter: ISO8601 duration when
+    # conversation will be switched to `closed` state. Minimum value for this
+    # timer is 10 minutes.
+    # @param [String] unique_name Optional parameter: 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 [String] bindings_email_address Optional parameter: The default
+    # email address that will be used when sending outbound emails in this
+    # conversation.
+    # @param [String] bindings_email_name Optional parameter: The default name
+    # that will be used when sending outbound emails in this conversation.
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def update_service_conversation(chat_service_sid,
+                                    sid,
+                                    x_twilio_webhook_enabled: nil,
+                                    friendly_name: nil,
+                                    date_created: nil,
+                                    date_updated: nil,
+                                    attributes: nil,
+                                    messaging_service_sid: nil,
+                                    state: nil,
+                                    timers_inactive: nil,
+                                    timers_closed: nil,
+                                    unique_name: nil,
+                                    bindings_email_address: nil,
+                                    bindings_email_name: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/v1/Services/{ChatServiceSid}/Conversations/{Sid}',
+                                     Server::DEFAULT2)
+                   .template_param(new_parameter(chat_service_sid, key: 'ChatServiceSid')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .template_param(new_parameter(sid, key: 'Sid')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .header_param(new_parameter(x_twilio_webhook_enabled, key: 'X-Twilio-Webhook-Enabled'))
+                   .form_param(new_parameter(friendly_name, key: 'FriendlyName'))
+                   .form_param(new_parameter(date_created, key: 'DateCreated'))
+                   .form_param(new_parameter(date_updated, key: 'DateUpdated'))
+                   .form_param(new_parameter(attributes, key: 'Attributes'))
+                   .form_param(new_parameter(messaging_service_sid, key: 'MessagingServiceSid'))
+                   .form_param(new_parameter(state, key: 'State'))
+                   .form_param(new_parameter(timers_inactive, key: 'Timers.Inactive'))
+                   .form_param(new_parameter(timers_closed, key: 'Timers.Closed'))
+                   .form_param(new_parameter(unique_name, key: 'UniqueName'))
+                   .form_param(new_parameter(bindings_email_address, key: 'Bindings.Email.Address'))
+                   .form_param(new_parameter(bindings_email_name, key: 'Bindings.Email.Name'))
+                   .header_param(new_parameter('application/x-www-form-urlencoded', key: 'content-type'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('accountSid_authToken')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(ServiceConversation.method(:from_hash))
+                    .is_api_response(true))
+        .execute
+    end
+
+    # Remove a conversation from your service
+    # @param [String] chat_service_sid Required parameter: The SID of the
+    # [Conversation
+    # Service](https://www.twilio.com/docs/conversations/api/service-resource)
+    # the Conversation resource is associated with.
+    # @param [String] sid Required parameter: A 34 character string that
+    # uniquely identifies this resource. Can also be the `unique_name` of the
+    # Conversation.
+    # @param [ChannelWebhookEnabledType] x_twilio_webhook_enabled Optional
+    # parameter: The X-Twilio-Webhook-Enabled HTTP request header
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def delete_service_conversation(chat_service_sid,
+                                    sid,
+                                    x_twilio_webhook_enabled: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::DELETE,
+                                     '/v1/Services/{ChatServiceSid}/Conversations/{Sid}',
+                                     Server::DEFAULT2)
+                   .template_param(new_parameter(chat_service_sid, key: 'ChatServiceSid')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .template_param(new_parameter(sid, key: 'Sid')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .header_param(new_parameter(x_twilio_webhook_enabled, key: 'X-Twilio-Webhook-Enabled'))
+                   .auth(Single.new('accountSid_authToken')))
+        .response(new_response_handler
+                    .is_response_void(true)
+                    .is_api_response(true))
+        .execute
+    end
+
+    # Fetch a conversation from your service
+    # @param [String] chat_service_sid Required parameter: The SID of the
+    # [Conversation
+    # Service](https://www.twilio.com/docs/conversations/api/service-resource)
+    # the Conversation resource is associated with.
+    # @param [String] sid Required parameter: A 34 character string that
+    # uniquely identifies this resource. Can also be the `unique_name` of the
+    # Conversation.
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def fetch_service_conversation(chat_service_sid,
+                                   sid)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/v1/Services/{ChatServiceSid}/Conversations/{Sid}',
+                                     Server::DEFAULT2)
+                   .template_param(new_parameter(chat_service_sid, key: 'ChatServiceSid')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .template_param(new_parameter(sid, key: 'Sid')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('accountSid_authToken')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(ServiceConversation.method(:from_hash))
+                    .is_api_response(true))
+        .execute
+    end
+  end
+end