twilio-ruby 7.12.0 → 7.13.0

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

@@ -87,7 +87,7 @@ module Twilio
                     end
 
                     class CreateConversationWithConfigRequest
-                            # @param [configuration_id]: [String] The ID of an existing configuration.
+                            # @param [configuration_id]: [String] The ID of an existing configuration. Omit it to define the configuration inline in `configuration`.
                             # @param [name]: [String] The name of the conversation.
                             # @param [configuration]: [ConversationList.CreateConversationWithConfigRequestConfiguration] 
                             # @param [participants]: [Array<ConversationList.CreateConversationWithConfigRequestParticipants>] Optional list of Participants to create with the Conversation.
@@ -112,27 +112,87 @@ module Twilio
                     end
 
                     class CreateConversationWithConfigRequestConfiguration
+                            # @param [conversation_grouping_type]: [String] Type of Conversation grouping strategy: - `GROUP_BY_PROFILE`: Groups Communications by resolved Profile from the Memory Store.   A Profile is looked up or created for `CUSTOMER` Participant types. All Communications from the same Profile are in the same Conversation, regardless of address or channel. - `GROUP_BY_PARTICIPANT_ADDRESSES`: Groups Communications by Participant addresses across all channels.   A customer using +18005550100 will be in the same Conversation whether they contact by SMS, WhatsApp, or RCS. - `GROUP_BY_PARTICIPANT_ADDRESSES_AND_CHANNEL_TYPE`: Groups Communications by both Participant addresses AND channel.   A customer using +18005550100 by SMS will be in a different Conversation than the same customer by Voice. 
+                            # @param [memory_store_id]: [String] The memory store ID that Conversation Orchestrator uses for profile resolution.
+                            # @param [channel_settings]: [Hash<String, CreateConversationWithConfigRequestConfigurationChannelSettingsValue>] Status timeouts by channel type. Capture rules can only be set on a Configuration.
+                            # @param [memory_extraction_enabled]: [Boolean] Whether memory extraction is enabled for this Conversation. Without `configurationId`, defaults to false; with it, defaults to the Configuration's value.
                             # @param [intelligence_configuration_ids]: [Array<String>] A list of Conversational Intelligence configuration IDs.
                             # @param [trait_extraction_strategy_ids]: [Array<String>] A list of Trait Extraction Strategy IDs.
                             # @param [observation_extraction_strategy_ids]: [Array<String>] A list of Observation Extraction Strategy IDs.
+                            # @param [status_callbacks]: [Array<ConversationList.CreateConversationWithConfigRequestConfigurationStatusCallbacks>] The webhook configurations for this Conversation. Overrides the Configuration's own.
                             # @param [workflows]: [Array<ConversationList.ConversationWorkflow>] The Workflows to associate with this Conversation. Overrides the Configuration's own.
-                        attr_accessor :intelligence_configuration_ids, :trait_extraction_strategy_ids, :observation_extraction_strategy_ids, :workflows
+                        attr_accessor :conversation_grouping_type, :memory_store_id, :channel_settings, :memory_extraction_enabled, :intelligence_configuration_ids, :trait_extraction_strategy_ids, :observation_extraction_strategy_ids, :status_callbacks, :workflows
                         def initialize(payload)
+                                @conversation_grouping_type = payload["conversation_grouping_type"]
+                                @memory_store_id = payload["memory_store_id"]
+                                @channel_settings = payload["channel_settings"]
+                                @memory_extraction_enabled = payload["memory_extraction_enabled"]
                                 @intelligence_configuration_ids = payload["intelligence_configuration_ids"]
                                 @trait_extraction_strategy_ids = payload["trait_extraction_strategy_ids"]
                                 @observation_extraction_strategy_ids = payload["observation_extraction_strategy_ids"]
+                                @status_callbacks = payload["status_callbacks"]
                                 @workflows = payload["workflows"]
                         end
                         def to_json(options = {})
                         {
+                                "conversationGroupingType": @conversation_grouping_type,
+                                "memoryStoreId": @memory_store_id,
+                                "channelSettings": @channel_settings,
+                                "memoryExtractionEnabled": @memory_extraction_enabled,
                                 "intelligenceConfigurationIds": @intelligence_configuration_ids,
                                 "traitExtractionStrategyIds": @trait_extraction_strategy_ids,
                                 "observationExtractionStrategyIds": @observation_extraction_strategy_ids,
+                                "statusCallbacks": @status_callbacks,
                                 "workflows": @workflows,
                         }.to_json(options)
                         end
                     end
 
+                    class CreateConversationWithConfigRequestConfigurationChannelSettingsValue
+                            # @param [status_timeouts]: [CreateConversationWithConfigRequestConfigurationChannelSettingsValueStatusTimeouts] 
+                        attr_accessor :status_timeouts
+                        def initialize(payload)
+                                @status_timeouts = payload["status_timeouts"]
+                        end
+                        def to_json(options = {})
+                        {
+                                "statusTimeouts": @status_timeouts,
+                        }.to_json(options)
+                        end
+                    end
+
+                    class CreateConversationWithConfigRequestConfigurationChannelSettingsValueStatusTimeouts
+                            # @param [inactive]: [Integer] Inactivity timeout in minutes.
+                            # @param [closed]: [Integer] Close timeout in minutes.
+                        attr_accessor :inactive, :closed
+                        def initialize(payload)
+                                @inactive = payload["inactive"]
+                                @closed = payload["closed"]
+                        end
+                        def to_json(options = {})
+                        {
+                                "inactive": @inactive,
+                                "closed": @closed,
+                        }.to_json(options)
+                        end
+                    end
+
+                    class CreateConversationWithConfigRequestConfigurationStatusCallbacks
+                            # @param [url]: [String] Destination URL for webhooks.
+                            # @param [method]: [String] HTTP method used to invoke the webhook URL.
+                        attr_accessor :url, :method
+                        def initialize(payload)
+                                @url = payload["url"]
+                                @method = payload["method"]
+                        end
+                        def to_json(options = {})
+                        {
+                                "url": @url,
+                                "method": @method,
+                        }.to_json(options)
+                        end
+                    end
+
                     class CreateConversationWithConfigRequestParticipants
                             # @param [name]: [String] Display name for the Participant.
                             # @param [type]: [String] Type of Participant in the Conversation.
@@ -297,7 +357,7 @@ module Twilio
                     end
 
                     class CreateConversationWithConfigRequest
-                            # @param [configuration_id]: [String] The ID of an existing configuration.
+                            # @param [configuration_id]: [String] The ID of an existing configuration. Omit it to define the configuration inline in `configuration`.
                             # @param [name]: [String] The name of the conversation.
                             # @param [configuration]: [ConversationList.CreateConversationWithConfigRequestConfiguration] 
                             # @param [participants]: [Array<ConversationList.CreateConversationWithConfigRequestParticipants>] Optional list of Participants to create with the Conversation.
@@ -322,27 +382,87 @@ module Twilio
                     end
 
                     class CreateConversationWithConfigRequestConfiguration
+                            # @param [conversation_grouping_type]: [String] Type of Conversation grouping strategy: - `GROUP_BY_PROFILE`: Groups Communications by resolved Profile from the Memory Store.   A Profile is looked up or created for `CUSTOMER` Participant types. All Communications from the same Profile are in the same Conversation, regardless of address or channel. - `GROUP_BY_PARTICIPANT_ADDRESSES`: Groups Communications by Participant addresses across all channels.   A customer using +18005550100 will be in the same Conversation whether they contact by SMS, WhatsApp, or RCS. - `GROUP_BY_PARTICIPANT_ADDRESSES_AND_CHANNEL_TYPE`: Groups Communications by both Participant addresses AND channel.   A customer using +18005550100 by SMS will be in a different Conversation than the same customer by Voice. 
+                            # @param [memory_store_id]: [String] The memory store ID that Conversation Orchestrator uses for profile resolution.
+                            # @param [channel_settings]: [Hash<String, CreateConversationWithConfigRequestConfigurationChannelSettingsValue>] Status timeouts by channel type. Capture rules can only be set on a Configuration.
+                            # @param [memory_extraction_enabled]: [Boolean] Whether memory extraction is enabled for this Conversation. Without `configurationId`, defaults to false; with it, defaults to the Configuration's value.
                             # @param [intelligence_configuration_ids]: [Array<String>] A list of Conversational Intelligence configuration IDs.
                             # @param [trait_extraction_strategy_ids]: [Array<String>] A list of Trait Extraction Strategy IDs.
                             # @param [observation_extraction_strategy_ids]: [Array<String>] A list of Observation Extraction Strategy IDs.
+                            # @param [status_callbacks]: [Array<ConversationList.CreateConversationWithConfigRequestConfigurationStatusCallbacks>] The webhook configurations for this Conversation. Overrides the Configuration's own.
                             # @param [workflows]: [Array<ConversationList.ConversationWorkflow>] The Workflows to associate with this Conversation. Overrides the Configuration's own.
-                        attr_accessor :intelligence_configuration_ids, :trait_extraction_strategy_ids, :observation_extraction_strategy_ids, :workflows
+                        attr_accessor :conversation_grouping_type, :memory_store_id, :channel_settings, :memory_extraction_enabled, :intelligence_configuration_ids, :trait_extraction_strategy_ids, :observation_extraction_strategy_ids, :status_callbacks, :workflows
                         def initialize(payload)
+                                @conversation_grouping_type = payload["conversation_grouping_type"]
+                                @memory_store_id = payload["memory_store_id"]
+                                @channel_settings = payload["channel_settings"]
+                                @memory_extraction_enabled = payload["memory_extraction_enabled"]
                                 @intelligence_configuration_ids = payload["intelligence_configuration_ids"]
                                 @trait_extraction_strategy_ids = payload["trait_extraction_strategy_ids"]
                                 @observation_extraction_strategy_ids = payload["observation_extraction_strategy_ids"]
+                                @status_callbacks = payload["status_callbacks"]
                                 @workflows = payload["workflows"]
                         end
                         def to_json(options = {})
                         {
+                                "conversationGroupingType": @conversation_grouping_type,
+                                "memoryStoreId": @memory_store_id,
+                                "channelSettings": @channel_settings,
+                                "memoryExtractionEnabled": @memory_extraction_enabled,
                                 "intelligenceConfigurationIds": @intelligence_configuration_ids,
                                 "traitExtractionStrategyIds": @trait_extraction_strategy_ids,
                                 "observationExtractionStrategyIds": @observation_extraction_strategy_ids,
+                                "statusCallbacks": @status_callbacks,
                                 "workflows": @workflows,
                         }.to_json(options)
                         end
                     end
 
+                    class CreateConversationWithConfigRequestConfigurationChannelSettingsValue
+                            # @param [status_timeouts]: [CreateConversationWithConfigRequestConfigurationChannelSettingsValueStatusTimeouts] 
+                        attr_accessor :status_timeouts
+                        def initialize(payload)
+                                @status_timeouts = payload["status_timeouts"]
+                        end
+                        def to_json(options = {})
+                        {
+                                "statusTimeouts": @status_timeouts,
+                        }.to_json(options)
+                        end
+                    end
+
+                    class CreateConversationWithConfigRequestConfigurationChannelSettingsValueStatusTimeouts
+                            # @param [inactive]: [Integer] Inactivity timeout in minutes.
+                            # @param [closed]: [Integer] Close timeout in minutes.
+                        attr_accessor :inactive, :closed
+                        def initialize(payload)
+                                @inactive = payload["inactive"]
+                                @closed = payload["closed"]
+                        end
+                        def to_json(options = {})
+                        {
+                                "inactive": @inactive,
+                                "closed": @closed,
+                        }.to_json(options)
+                        end
+                    end
+
+                    class CreateConversationWithConfigRequestConfigurationStatusCallbacks
+                            # @param [url]: [String] Destination URL for webhooks.
+                            # @param [method]: [String] HTTP method used to invoke the webhook URL.
+                        attr_accessor :url, :method
+                        def initialize(payload)
+                                @url = payload["url"]
+                                @method = payload["method"]
+                        end
+                        def to_json(options = {})
+                        {
+                                "url": @url,
+                                "method": @method,
+                        }.to_json(options)
+                        end
+                    end
+
                     class CreateConversationWithConfigRequestParticipants
                             # @param [name]: [String] Display name for the Participant.
                             # @param [type]: [String] Type of Participant in the Conversation.
@@ -507,7 +627,7 @@ module Twilio
                     end
 
                     class CreateConversationWithConfigRequest
-                            # @param [configuration_id]: [String] The ID of an existing configuration.
+                            # @param [configuration_id]: [String] The ID of an existing configuration. Omit it to define the configuration inline in `configuration`.
                             # @param [name]: [String] The name of the conversation.
                             # @param [configuration]: [ConversationList.CreateConversationWithConfigRequestConfiguration] 
                             # @param [participants]: [Array<ConversationList.CreateConversationWithConfigRequestParticipants>] Optional list of Participants to create with the Conversation.
@@ -532,27 +652,87 @@ module Twilio
                     end
 
                     class CreateConversationWithConfigRequestConfiguration
+                            # @param [conversation_grouping_type]: [String] Type of Conversation grouping strategy: - `GROUP_BY_PROFILE`: Groups Communications by resolved Profile from the Memory Store.   A Profile is looked up or created for `CUSTOMER` Participant types. All Communications from the same Profile are in the same Conversation, regardless of address or channel. - `GROUP_BY_PARTICIPANT_ADDRESSES`: Groups Communications by Participant addresses across all channels.   A customer using +18005550100 will be in the same Conversation whether they contact by SMS, WhatsApp, or RCS. - `GROUP_BY_PARTICIPANT_ADDRESSES_AND_CHANNEL_TYPE`: Groups Communications by both Participant addresses AND channel.   A customer using +18005550100 by SMS will be in a different Conversation than the same customer by Voice. 
+                            # @param [memory_store_id]: [String] The memory store ID that Conversation Orchestrator uses for profile resolution.
+                            # @param [channel_settings]: [Hash<String, CreateConversationWithConfigRequestConfigurationChannelSettingsValue>] Status timeouts by channel type. Capture rules can only be set on a Configuration.
+                            # @param [memory_extraction_enabled]: [Boolean] Whether memory extraction is enabled for this Conversation. Without `configurationId`, defaults to false; with it, defaults to the Configuration's value.
                             # @param [intelligence_configuration_ids]: [Array<String>] A list of Conversational Intelligence configuration IDs.
                             # @param [trait_extraction_strategy_ids]: [Array<String>] A list of Trait Extraction Strategy IDs.
                             # @param [observation_extraction_strategy_ids]: [Array<String>] A list of Observation Extraction Strategy IDs.
+                            # @param [status_callbacks]: [Array<ConversationList.CreateConversationWithConfigRequestConfigurationStatusCallbacks>] The webhook configurations for this Conversation. Overrides the Configuration's own.
                             # @param [workflows]: [Array<ConversationList.ConversationWorkflow>] The Workflows to associate with this Conversation. Overrides the Configuration's own.
-                        attr_accessor :intelligence_configuration_ids, :trait_extraction_strategy_ids, :observation_extraction_strategy_ids, :workflows
+                        attr_accessor :conversation_grouping_type, :memory_store_id, :channel_settings, :memory_extraction_enabled, :intelligence_configuration_ids, :trait_extraction_strategy_ids, :observation_extraction_strategy_ids, :status_callbacks, :workflows
                         def initialize(payload)
+                                @conversation_grouping_type = payload["conversation_grouping_type"]
+                                @memory_store_id = payload["memory_store_id"]
+                                @channel_settings = payload["channel_settings"]
+                                @memory_extraction_enabled = payload["memory_extraction_enabled"]
                                 @intelligence_configuration_ids = payload["intelligence_configuration_ids"]
                                 @trait_extraction_strategy_ids = payload["trait_extraction_strategy_ids"]
                                 @observation_extraction_strategy_ids = payload["observation_extraction_strategy_ids"]
+                                @status_callbacks = payload["status_callbacks"]
                                 @workflows = payload["workflows"]
                         end
                         def to_json(options = {})
                         {
+                                "conversationGroupingType": @conversation_grouping_type,
+                                "memoryStoreId": @memory_store_id,
+                                "channelSettings": @channel_settings,
+                                "memoryExtractionEnabled": @memory_extraction_enabled,
                                 "intelligenceConfigurationIds": @intelligence_configuration_ids,
                                 "traitExtractionStrategyIds": @trait_extraction_strategy_ids,
                                 "observationExtractionStrategyIds": @observation_extraction_strategy_ids,
+                                "statusCallbacks": @status_callbacks,
                                 "workflows": @workflows,
                         }.to_json(options)
                         end
                     end
 
+                    class CreateConversationWithConfigRequestConfigurationChannelSettingsValue
+                            # @param [status_timeouts]: [CreateConversationWithConfigRequestConfigurationChannelSettingsValueStatusTimeouts] 
+                        attr_accessor :status_timeouts
+                        def initialize(payload)
+                                @status_timeouts = payload["status_timeouts"]
+                        end
+                        def to_json(options = {})
+                        {
+                                "statusTimeouts": @status_timeouts,
+                        }.to_json(options)
+                        end
+                    end
+
+                    class CreateConversationWithConfigRequestConfigurationChannelSettingsValueStatusTimeouts
+                            # @param [inactive]: [Integer] Inactivity timeout in minutes.
+                            # @param [closed]: [Integer] Close timeout in minutes.
+                        attr_accessor :inactive, :closed
+                        def initialize(payload)
+                                @inactive = payload["inactive"]
+                                @closed = payload["closed"]
+                        end
+                        def to_json(options = {})
+                        {
+                                "inactive": @inactive,
+                                "closed": @closed,
+                        }.to_json(options)
+                        end
+                    end
+
+                    class CreateConversationWithConfigRequestConfigurationStatusCallbacks
+                            # @param [url]: [String] Destination URL for webhooks.
+                            # @param [method]: [String] HTTP method used to invoke the webhook URL.
+                        attr_accessor :url, :method
+                        def initialize(payload)
+                                @url = payload["url"]
+                                @method = payload["method"]
+                        end
+                        def to_json(options = {})
+                        {
+                                "url": @url,
+                                "method": @method,
+                        }.to_json(options)
+                        end
+                    end
+
                     class CreateConversationWithConfigRequestParticipants
                             # @param [name]: [String] Display name for the Participant.
                             # @param [type]: [String] Type of Participant in the Conversation.
@@ -1250,6 +1430,7 @@ module Twilio
                             'trait_extraction_strategy_ids' => payload['trait_extraction_strategy_ids'],
                             'observation_extraction_strategy_ids' => payload['observation_extraction_strategy_ids'],
                             'memory_extraction_enabled' => payload['memory_extraction_enabled'],
+                            'redaction_configuration_id' => payload['redaction_configuration_id'],
                             'conversations_v1_bridge' => payload['conversations_v1_bridge'],
                             'version' => payload['version'],
                         }
@@ -1283,7 +1464,7 @@ module Twilio
                     end
                     
                     ##
-                    # @return [String] Configuration ID.
+                    # @return [String] Configuration ID. Null when the Conversation was created with an inline configuration.
                     def configuration_id
                         @properties['configuration_id']
                     end
@@ -1408,6 +1589,12 @@ module Twilio
                         @properties['memory_extraction_enabled']
                     end
                     
+                    ##
+                    # @return [String] The ID of the redaction configuration applied to communications in this configuration's conversations.
+                    def redaction_configuration_id
+                        @properties['redaction_configuration_id']
+                    end
+                    
                     ##
                     # @return [ConversationsV2ConversationsV1Bridge] 
                     def conversations_v1_bridge

data/lib/twilio-ruby/rest/memory/v1/bulk.rb

@@ -165,16 +165,37 @@ module Twilio
                         # Marshaled Properties
                         @properties = { 
                             'message' => payload['message'],
+                            'operation_id' => payload['operation_id'],
+                            'created_at' => Twilio.deserialize_iso8601_datetime(payload['created_at']),
+                            'status_url' => payload['status_url'],
                         }
                     end
 
                     
                     ##
-                    # @return [String] 
+                    # @return [String] Confirmation message for the operation.
                     def message
                         @properties['message']
                     end
                     
+                    ##
+                    # @return [String] The ID of an asynchronous profile domain operation.
+                    def operation_id
+                        @properties['operation_id']
+                    end
+                    
+                    ##
+                    # @return [Time] ISO 8601 timestamp when the operation was created.
+                    def created_at
+                        @properties['created_at']
+                    end
+                    
+                    ##
+                    # @return [String] URL to query the operation status.
+                    def status_url
+                        @properties['status_url']
+                    end
+                    
                     ##
                     # Provide a user friendly representation
                     def to_s

data/lib/twilio-ruby/rest/memory/v1/import.rb

@@ -475,9 +475,11 @@ module Twilio
                         @properties = { 
                             'import_id' => payload['import_id'],
                             'url' => payload['url'],
+                            'operation_id' => payload['operation_id'],
+                            'created_at' => Twilio.deserialize_iso8601_datetime(payload['created_at']),
+                            'status_url' => payload['status_url'],
                             'status' => payload['status'],
                             'filename' => payload['filename'],
-                            'created_at' => Twilio.deserialize_iso8601_datetime(payload['created_at']),
                             'updated_at' => Twilio.deserialize_iso8601_datetime(payload['updated_at']),
                             'file_size' => payload['file_size'] == nil ? payload['file_size'] : payload['file_size'].to_i,
                             'column_mappings' => payload['column_mappings'],
@@ -514,6 +516,24 @@ module Twilio
                         @properties['url']
                     end
                     
+                    ##
+                    # @return [String] The ID of an asynchronous profile domain operation.
+                    def operation_id
+                        @properties['operation_id']
+                    end
+                    
+                    ##
+                    # @return [Time] ISO 8601 timestamp when the operation was created.
+                    def created_at
+                        @properties['created_at']
+                    end
+                    
+                    ##
+                    # @return [String] URL to query the operation status.
+                    def status_url
+                        @properties['status_url']
+                    end
+                    
                     ##
                     # @return [String] Current processing status of the import task
                     def status
@@ -526,12 +546,6 @@ module Twilio
                         @properties['filename']
                     end
                     
-                    ##
-                    # @return [Time] Timestamp when the import was created
-                    def created_at
-                        @properties['created_at']
-                    end
-                    
                     ##
                     # @return [Time] Timestamp when the import was last updated
                     def updated_at

data/lib/twilio-ruby/rest/memory/v1/store.rb

@@ -613,6 +613,7 @@ module Twilio
                             'status' => payload['status'],
                             'intelligence_service_id' => payload['intelligence_service_id'],
                             'version' => payload['version'] == nil ? payload['version'] : payload['version'].to_i,
+                            'data_as_of' => Twilio.deserialize_iso8601_datetime(payload['data_as_of']),
                             'stores' => payload['stores'],
                             'meta' => payload['meta'],
                         }
@@ -681,6 +682,12 @@ module Twilio
                         @properties['version']
                     end
                     
+                    ##
+                    # @return [Time] The time up to which data sent to this Memory Store has been processed by downstream systems. Equals the time the Memory Store was created when no data has been processed yet. Omitted when no value is available. Represents a high water mark for ingested data.
+                    def data_as_of
+                        @properties['data_as_of']
+                    end
+                    
                     ##
                     # @return [Array<String>] List of Memory Store IDs associated with the Twilio account.
                     def stores

data/lib/twilio-ruby/rest/trusthub/v1/a2p_brand_registration.rb

@@ -25,14 +25,14 @@ module Twilio
                             # @param [friendly_name]: [String] A human-readable name for the brand registration.
                             # @param [notification_email]: [String] The email address to receive notifications about the registration.
                             # @param [business_name]: [String] The legal name of the business.
-                            # @param [business_registration_authority]: [String] The authority with which the business is registered.
+                            # @param [business_registration_authority]: [String] The authority with which the business is registered. The value is validated by the service; see the Twilio docs for accepted values.
                             # @param [business_registration_number]: [String] The business registration number (e.g., EIN, CBN, ACN). Maximum 21 characters.
-                            # @param [business_industry]: [String] The industry of the business.
+                            # @param [business_industry]: [String] The industry of the business. The value is validated by the service; see the Twilio docs for accepted values.
                             # @param [business_website]: [String] The business website URL (must use https://).
-                            # @param [business_type]: [String] The type of business entity.
+                            # @param [business_type]: [String] The type of business entity. The value is validated by the service; see the Twilio docs for accepted values.
                             # @param [business_stock_symbol]: [String] The stock symbol for publicly traded companies.
-                            # @param [business_stock_exchange]: [String] The stock exchange where the business is listed.
-                            # @param [business_tax_exempt_status]: [String] Nonprofit/political organization tax-exempt status per the U.S. tax code (e.g. 501c3, 501c1, 527). A value of 527 (political organization) requires a Campaign Verify token in brandExternalVettingToken.
+                            # @param [business_stock_exchange]: [String] The stock exchange where the business is listed. The value is validated by the service; see the Twilio docs for accepted values.
+                            # @param [business_tax_exempt_status]: [String] Nonprofit/political organization tax-exempt status per the U.S. tax code (e.g. 501c3, 501c1, 527). A value of 527 (political organization) requires a Campaign Verify token in brandExternalVettingToken. The value is validated by the service; see the Twilio docs for accepted values.
                             # @param [brand_external_vetting_token]: [String] Campaign Verify token for externally vetted brands.
                             # @param [business_street_address]: [String] The street address of the business.
                             # @param [business_street_address2]: [String] Additional street address information.

data/lib/twilio-ruby/rest/trusthub/v1/a2p_campaign_registration.rb

@@ -20,17 +20,17 @@ module Twilio
                 class A2PCampaignRegistrationList < ListResource
                 
                     class TrusthubV1A2pCampaignRegistrationRequest
-                            # @param [a2p_brand_registration_sid]: [String] The legacy Twilio A2P Brand SID (BN-prefixed) for the brand this campaign is registered under. This is a different identifier from the `id` returned by the Initialize Brand endpoint (which is formatted as `tri1.us1.account.AC.../registration.BU...`). Retrieve the BN brand SID via [GET /v1/a2p/BrandRegistrations/{Sid}](https://www.twilio.com/docs/messaging/api/brand-registration-resource) on `messaging.twilio.com`.
-                            # @param [messaging_service_sid]: [String] The SID of the Messaging Service.
+                            # @param [a2p_brand_registration_sid]: [String] The legacy Twilio A2P Brand SID (BN-prefixed) for the brand this campaign is registered under. This is a different identifier from the `id` returned by the Initialize Brand endpoint (which is formatted as `tri1.us1.account.AC.../registration.BU...`). Retrieve the BN brand SID via [GET /v1/a2p/BrandRegistrations/{Sid}](https://www.twilio.com/docs/messaging/api/brand-registration-resource) on `messaging.twilio.com`. This field keeps the legacy Sid name because it carries a legacy Twilio SID (BN prefix) from messaging.twilio.com.
+                            # @param [messaging_service_sid]: [String] The SID of the Messaging Service. This field keeps the legacy Sid name because it carries a legacy Twilio SID (MG prefix) from messaging.twilio.com.
                             # @param [theme_set_id]: [String] Theme ID for styling the inquiry form.
-                            # @param [use_case_categories]: [Array<String>] The categories of the messaging use case.
+                            # @param [use_case_categories]: [Array<String>] The categories of the messaging use case. The value is validated by the service; see the Twilio docs for accepted values.
                             # @param [use_case_description]: [String] A description of the messaging use case.
                             # @param [use_case_sample_message1]: [String] A sample message for the use case.
                             # @param [use_case_sample_message2]: [String] A second sample message for the use case.
                             # @param [use_case_sample_message3]: [String] A third sample message for the use case.
                             # @param [use_case_sample_message4]: [String] A fourth sample message for the use case.
                             # @param [use_case_sample_message5]: [String] A fifth sample message for the use case.
-                            # @param [use_case_opt_in_types]: [Array<String>] The opt-in methods for the use case.
+                            # @param [use_case_opt_in_types]: [Array<String>] The opt-in methods for the use case. The value is validated by the service; see the Twilio docs for accepted values.
                             # @param [use_case_opt_in_description]: [String] A description of the opt-in process.
                             # @param [has_embedded_links]: [Boolean] Whether messages will contain embedded links.
                             # @param [has_embedded_phone]: [Boolean] Whether messages will contain embedded phone numbers.

data/lib/twilio-ruby/rest/trusthub/v1.rb

@@ -45,7 +45,7 @@ module Twilio
                     @a2p_brand_registrations ||= A2PBrandRegistrationList.new self
                 end
                 ##
-                # @param [String] id The unique identifier for the A2P Brand Registration.
+                # @param [String] id The unique identifier for the A2P Brand Registration, as returned in the `id` field when the brand registration was created.
                 # @return [Twilio::REST::Trusthub::V1::A2PBrandRegistrationEmbeddedSessionList]
                 def a2p_brand_registration_embedded_sessions(id=:unset)
                     if id.nil?
@@ -64,7 +64,7 @@ module Twilio
                     @a2p_campaign_registrations ||= A2PCampaignRegistrationList.new self
                 end
                 ##
-                # @param [String] id The unique identifier for the A2P Campaign Registration. This can be either an A2P Campaign Registration ID (formatted `tri1.us1.account.AC.../registration.BU...`) returned from the Initialize Campaign endpoint, or a Messaging Service SID (`MG...`) for campaigns created outside the embeddable.
+                # @param [String] id The unique identifier for the A2P Campaign Registration. This is the A2P Campaign Registration ID (formatted `tri1.us1.account.AC.../registration.BU...`) returned in the `id` field when the campaign registration was created. For a campaign in FAILED status, use the Messaging Service SID (`MG...`) of the campaign instead.
                 # @return [Twilio::REST::Trusthub::V1::A2PCampaignRegistrationEmbeddedSessionList]
                 def a2p_campaign_registration_embedded_sessions(id=:unset)
                     if id.nil?