aws-sdk-connect 1.205.0 → 1.206.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 39a28c4f1432c98bef2243df566422c815e4c078cff15258ede474b1bf91afb3
-  data.tar.gz: 3d09162323c36c1e0e6b4846043624a1a8534f85bc2413fd891a9e18f5c39098
+  metadata.gz: 35bcd121540c0f93e903602302b096cc8b5ae3764495dac5c479e1b7733ede10
+  data.tar.gz: 9c7208c9bcb1f4fc1412d09af84a7f2ffd6a9f3382363b820ed82a65ba5ee074
 SHA512:
-  metadata.gz: 8c61365be493e3c6011c6bd356a905f033ea4730a681ad2b8be693a4e465d6b32daee3fc8e781f093b8dff075ccd2195643d6edc7d2e012ff2ce3975ef53a2e1
-  data.tar.gz: abd61361a57a007463baaf12235bee23f13c8172f60ed3fee6dc94709b243b091d417d289b758ed94d99fbec7107127129265fa6b4caf30ed503390d6e9d5628
+  metadata.gz: 5075fac512c0fa6702713fc5049c5930045930bbac3f017b89cf94c449ef6fce5681738682a9013913a62489f9fecf9f900c36f19ef468ce9bf46af0d05009f1
+  data.tar.gz: d2d287e971fecd5b3471a05b5b66ca4dd8cd1ed3a44d80906c165ef0e969b273ac0548b909c721e4c96c0cd661854139edf1452c43f4eca27a51b3663f451464

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.206.0 (2025-06-30)
+------------------
+
+* Feature - This release introduces ChatMetrics to the model, providing comprehensive analytics insights for Amazon Connect chat conversations. Users can access these detailed metrics through the AWS Connect API by using the DescribeContact operation with their specific instance and contact IDs
+
 1.205.0 (2025-06-27)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.205.0
+1.206.0

data/lib/aws-sdk-connect/client.rb

@@ -1769,12 +1769,26 @@ module Aws::Connect
       req.send_request(options)
     end
 
-    # Only the EMAIL and VOICE channels are supported. The supported
-    # initiation methods for EMAIL are: OUTBOUND, AGENT\_REPLY, and FLOW.
-    # For VOICE the supported initiation methods are TRANSFER and the
-    # subtype connect:ExternalAudio.
+    # Only the VOICE, EMAIL, and TASK channels are supported.
     #
-    # Creates a new EMAIL or VOICE contact.
+    #  * For VOICE: The supported initiation method is `TRANSFER`. The
+    #   contacts created with this initiation method have a subtype
+    #   `connect:ExternalAudio`.
+    #
+    # * For EMAIL: The supported initiation methods are `OUTBOUND`,
+    #   `AGENT_REPLY`, and `FLOW`.
+    #
+    # * For TASK: The supported initiation method is `API`. Contacts created
+    #   with this API have a sub-type of `connect:ExternalTask`.
+    #
+    # Creates a new VOICE, EMAIL, or TASK contact.
+    #
+    # After a contact is created, you can move it to the desired state by
+    # using the `InitiateAs` parameter. While you can use API to create task
+    # contacts that are in the `COMPLETED` state, you must contact Amazon
+    # Web Services Support before using it for bulk import use cases. Bulk
+    # import causes your requests to be throttled or fail if your
+    # CreateContact limits aren't high enough.
     #
     # @option params [required, String] :instance_id
     #   The identifier of the Amazon Connect instance. You can [find the
@@ -1812,26 +1826,29 @@ module Aws::Connect
     # @option params [Hash<String,Types::Reference>] :references
     #   A formatted URL that is shown to an agent in the Contact Control Panel
     #   (CCP). Tasks can have the following reference types at the time of
-    #   creation: URL \| NUMBER \| STRING \| DATE \| EMAIL \| ATTACHMENT.
+    #   creation: `URL` \| `NUMBER` \| `STRING` \| `DATE` \| `EMAIL` \|
+    #   `ATTACHMENT`.
     #
     # @option params [required, String] :channel
-    #   The channel for the contact
+    #   The channel for the contact.
     #
-    #   CreateContact only supports the EMAIL and VOICE channels. The
-    #   following information that states other channels are supported is
-    #   incorrect. We are working to update this topic.
+    #   The CHAT channel is not supported. The following information is
+    #   incorrect. We're working to correct it.
     #
     # @option params [required, String] :initiation_method
     #   Indicates how the contact was initiated.
     #
-    #   CreateContact only supports the following initiation methods:
+    #   CreateContact only supports the following initiation methods. Valid
+    #   values by channel are:
+    #
+    #    * For VOICE: `TRANSFER` and the subtype `connect:ExternalAudio`
     #
-    #    * For EMAIL: OUTBOUND, AGENT\_REPLY, and FLOW.
+    #   * For EMAIL: `OUTBOUND` \| `AGENT_REPLY` \| `FLOW`
     #
-    #   * For VOICE: TRANSFER and the subtype connect:ExternalAudio.
+    #   * For TASK: `API`
     #
-    #    The following information that states other initiation methods are
-    #   supported is incorrect. We are working to update this topic.
+    #    The other channels listed below are incorrect. We're working to
+    #   correct this information.
     #
     # @option params [Integer] :expiry_duration_in_minutes
     #   Number of minutes the contact will be active for before expiring
@@ -1839,11 +1856,12 @@ module Aws::Connect
     # @option params [Types::UserInfo] :user_info
     #   User details for the contact
     #
-    #   UserInfo is required when creating an EMAIL contact with OUTBOUND and
-    #   AGENT\_REPLY contact initiation methods.
+    #   UserInfo is required when creating an EMAIL contact with `OUTBOUND`
+    #   and `AGENT_REPLY` contact initiation methods.
     #
     # @option params [String] :initiate_as
-    #   Initial state of the contact when it's created
+    #   Initial state of the contact when it's created. Only TASK channel
+    #   contacts can be initiated with `COMPLETED` state.
     #
     # @option params [String] :name
     #   The name of a the contact.
@@ -5488,6 +5506,32 @@ module Aws::Connect
     #   resp.contact.quality_metrics.customer.audio.quality_score #=> Float
     #   resp.contact.quality_metrics.customer.audio.potential_quality_issues #=> Array
     #   resp.contact.quality_metrics.customer.audio.potential_quality_issues[0] #=> String
+    #   resp.contact.chat_metrics.chat_contact_metrics.multi_party #=> Boolean
+    #   resp.contact.chat_metrics.chat_contact_metrics.total_messages #=> Integer
+    #   resp.contact.chat_metrics.chat_contact_metrics.total_bot_messages #=> Integer
+    #   resp.contact.chat_metrics.chat_contact_metrics.total_bot_message_length_in_chars #=> Integer
+    #   resp.contact.chat_metrics.chat_contact_metrics.conversation_close_time_in_millis #=> Integer
+    #   resp.contact.chat_metrics.chat_contact_metrics.conversation_turn_count #=> Integer
+    #   resp.contact.chat_metrics.chat_contact_metrics.agent_first_response_timestamp #=> Time
+    #   resp.contact.chat_metrics.chat_contact_metrics.agent_first_response_time_in_millis #=> Integer
+    #   resp.contact.chat_metrics.agent_metrics.participant_id #=> String
+    #   resp.contact.chat_metrics.agent_metrics.participant_type #=> String, one of "ALL", "MANAGER", "AGENT", "CUSTOMER", "THIRDPARTY"
+    #   resp.contact.chat_metrics.agent_metrics.conversation_abandon #=> Boolean
+    #   resp.contact.chat_metrics.agent_metrics.messages_sent #=> Integer
+    #   resp.contact.chat_metrics.agent_metrics.num_responses #=> Integer
+    #   resp.contact.chat_metrics.agent_metrics.message_length_in_chars #=> Integer
+    #   resp.contact.chat_metrics.agent_metrics.total_response_time_in_millis #=> Integer
+    #   resp.contact.chat_metrics.agent_metrics.max_response_time_in_millis #=> Integer
+    #   resp.contact.chat_metrics.agent_metrics.last_message_timestamp #=> Time
+    #   resp.contact.chat_metrics.customer_metrics.participant_id #=> String
+    #   resp.contact.chat_metrics.customer_metrics.participant_type #=> String, one of "ALL", "MANAGER", "AGENT", "CUSTOMER", "THIRDPARTY"
+    #   resp.contact.chat_metrics.customer_metrics.conversation_abandon #=> Boolean
+    #   resp.contact.chat_metrics.customer_metrics.messages_sent #=> Integer
+    #   resp.contact.chat_metrics.customer_metrics.num_responses #=> Integer
+    #   resp.contact.chat_metrics.customer_metrics.message_length_in_chars #=> Integer
+    #   resp.contact.chat_metrics.customer_metrics.total_response_time_in_millis #=> Integer
+    #   resp.contact.chat_metrics.customer_metrics.max_response_time_in_millis #=> Integer
+    #   resp.contact.chat_metrics.customer_metrics.last_message_timestamp #=> Time
     #   resp.contact.disconnect_details.potential_disconnect_issue #=> String
     #   resp.contact.additional_email_recipients.to_list #=> Array
     #   resp.contact.additional_email_recipients.to_list[0].address #=> String
@@ -21208,7 +21252,7 @@ module Aws::Connect
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-connect'
-      context[:gem_version] = '1.205.0'
+      context[:gem_version] = '1.206.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-connect/client_api.rb

@@ -157,12 +157,14 @@ module Aws::Connect
     ChannelList = Shapes::ListShape.new(name: 'ChannelList')
     ChannelToCountMap = Shapes::MapShape.new(name: 'ChannelToCountMap')
     Channels = Shapes::ListShape.new(name: 'Channels')
+    ChatContactMetrics = Shapes::StructureShape.new(name: 'ChatContactMetrics')
     ChatContent = Shapes::StringShape.new(name: 'ChatContent')
     ChatContentType = Shapes::StringShape.new(name: 'ChatContentType')
     ChatDurationInMinutes = Shapes::IntegerShape.new(name: 'ChatDurationInMinutes')
     ChatEvent = Shapes::StructureShape.new(name: 'ChatEvent')
     ChatEventType = Shapes::StringShape.new(name: 'ChatEventType')
     ChatMessage = Shapes::StructureShape.new(name: 'ChatMessage')
+    ChatMetrics = Shapes::StructureShape.new(name: 'ChatMetrics')
     ChatParticipantRoleConfig = Shapes::StructureShape.new(name: 'ChatParticipantRoleConfig')
     ChatStreamingConfiguration = Shapes::StructureShape.new(name: 'ChatStreamingConfiguration')
     ChatStreamingEndpointARN = Shapes::StringShape.new(name: 'ChatStreamingEndpointARN')
@@ -249,6 +251,7 @@ module Aws::Connect
     ControlPlaneAttributeFilter = Shapes::StructureShape.new(name: 'ControlPlaneAttributeFilter')
     ControlPlaneTagFilter = Shapes::StructureShape.new(name: 'ControlPlaneTagFilter')
     ControlPlaneUserAttributeFilter = Shapes::StructureShape.new(name: 'ControlPlaneUserAttributeFilter')
+    Count = Shapes::IntegerShape.new(name: 'Count')
     CreateAgentStatusRequest = Shapes::StructureShape.new(name: 'CreateAgentStatusRequest')
     CreateAgentStatusResponse = Shapes::StructureShape.new(name: 'CreateAgentStatusResponse')
     CreateCaseActionDefinition = Shapes::StructureShape.new(name: 'CreateCaseActionDefinition')
@@ -472,6 +475,7 @@ module Aws::Connect
     DuplicateResourceException = Shapes::StructureShape.new(name: 'DuplicateResourceException')
     Duration = Shapes::IntegerShape.new(name: 'Duration')
     DurationInSeconds = Shapes::IntegerShape.new(name: 'DurationInSeconds')
+    DurationMillis = Shapes::IntegerShape.new(name: 'DurationMillis')
     EffectiveHoursOfOperationList = Shapes::ListShape.new(name: 'EffectiveHoursOfOperationList')
     EffectiveHoursOfOperations = Shapes::StructureShape.new(name: 'EffectiveHoursOfOperations')
     Email = Shapes::StringShape.new(name: 'Email')
@@ -894,6 +898,7 @@ module Aws::Connect
     NotificationContentType = Shapes::StringShape.new(name: 'NotificationContentType')
     NotificationDeliveryType = Shapes::StringShape.new(name: 'NotificationDeliveryType')
     NotificationRecipientType = Shapes::StructureShape.new(name: 'NotificationRecipientType')
+    NullableBoolean = Shapes::BooleanShape.new(name: 'NullableBoolean')
     NullableProficiencyLevel = Shapes::FloatShape.new(name: 'NullableProficiencyLevel')
     NullableProficiencyLimitValue = Shapes::IntegerShape.new(name: 'NullableProficiencyLimitValue')
     NumberComparisonType = Shapes::StringShape.new(name: 'NumberComparisonType')
@@ -925,6 +930,7 @@ module Aws::Connect
     ParticipantDetails = Shapes::StructureShape.new(name: 'ParticipantDetails')
     ParticipantDetailsToAdd = Shapes::StructureShape.new(name: 'ParticipantDetailsToAdd')
     ParticipantId = Shapes::StringShape.new(name: 'ParticipantId')
+    ParticipantMetrics = Shapes::StructureShape.new(name: 'ParticipantMetrics')
     ParticipantRole = Shapes::StringShape.new(name: 'ParticipantRole')
     ParticipantState = Shapes::StringShape.new(name: 'ParticipantState')
     ParticipantTimerAction = Shapes::StringShape.new(name: 'ParticipantTimerAction')
@@ -1967,6 +1973,16 @@ module Aws::Connect
 
     Channels.member = Shapes::ShapeRef.new(shape: Channel)
 
+    ChatContactMetrics.add_member(:multi_party, Shapes::ShapeRef.new(shape: NullableBoolean, location_name: "MultiParty"))
+    ChatContactMetrics.add_member(:total_messages, Shapes::ShapeRef.new(shape: Count, location_name: "TotalMessages"))
+    ChatContactMetrics.add_member(:total_bot_messages, Shapes::ShapeRef.new(shape: Count, location_name: "TotalBotMessages"))
+    ChatContactMetrics.add_member(:total_bot_message_length_in_chars, Shapes::ShapeRef.new(shape: Count, location_name: "TotalBotMessageLengthInChars"))
+    ChatContactMetrics.add_member(:conversation_close_time_in_millis, Shapes::ShapeRef.new(shape: DurationMillis, location_name: "ConversationCloseTimeInMillis"))
+    ChatContactMetrics.add_member(:conversation_turn_count, Shapes::ShapeRef.new(shape: Count, location_name: "ConversationTurnCount"))
+    ChatContactMetrics.add_member(:agent_first_response_timestamp, Shapes::ShapeRef.new(shape: timestamp, location_name: "AgentFirstResponseTimestamp"))
+    ChatContactMetrics.add_member(:agent_first_response_time_in_millis, Shapes::ShapeRef.new(shape: DurationMillis, location_name: "AgentFirstResponseTimeInMillis"))
+    ChatContactMetrics.struct_class = Types::ChatContactMetrics
+
     ChatEvent.add_member(:type, Shapes::ShapeRef.new(shape: ChatEventType, required: true, location_name: "Type"))
     ChatEvent.add_member(:content_type, Shapes::ShapeRef.new(shape: ChatContentType, location_name: "ContentType"))
     ChatEvent.add_member(:content, Shapes::ShapeRef.new(shape: ChatContent, location_name: "Content"))
@@ -1976,6 +1992,11 @@ module Aws::Connect
     ChatMessage.add_member(:content, Shapes::ShapeRef.new(shape: ChatContent, required: true, location_name: "Content"))
     ChatMessage.struct_class = Types::ChatMessage
 
+    ChatMetrics.add_member(:chat_contact_metrics, Shapes::ShapeRef.new(shape: ChatContactMetrics, location_name: "ChatContactMetrics"))
+    ChatMetrics.add_member(:agent_metrics, Shapes::ShapeRef.new(shape: ParticipantMetrics, location_name: "AgentMetrics"))
+    ChatMetrics.add_member(:customer_metrics, Shapes::ShapeRef.new(shape: ParticipantMetrics, location_name: "CustomerMetrics"))
+    ChatMetrics.struct_class = Types::ChatMetrics
+
     ChatParticipantRoleConfig.add_member(:participant_timer_config_list, Shapes::ShapeRef.new(shape: ParticipantTimerConfigList, required: true, location_name: "ParticipantTimerConfigList"))
     ChatParticipantRoleConfig.struct_class = Types::ChatParticipantRoleConfig
 
@@ -2069,6 +2090,7 @@ module Aws::Connect
     Contact.add_member(:answering_machine_detection_status, Shapes::ShapeRef.new(shape: AnsweringMachineDetectionStatus, location_name: "AnsweringMachineDetectionStatus"))
     Contact.add_member(:customer_voice_activity, Shapes::ShapeRef.new(shape: CustomerVoiceActivity, location_name: "CustomerVoiceActivity"))
     Contact.add_member(:quality_metrics, Shapes::ShapeRef.new(shape: QualityMetrics, location_name: "QualityMetrics"))
+    Contact.add_member(:chat_metrics, Shapes::ShapeRef.new(shape: ChatMetrics, location_name: "ChatMetrics"))
     Contact.add_member(:disconnect_details, Shapes::ShapeRef.new(shape: DisconnectDetails, location_name: "DisconnectDetails"))
     Contact.add_member(:additional_email_recipients, Shapes::ShapeRef.new(shape: AdditionalEmailRecipients, location_name: "AdditionalEmailRecipients"))
     Contact.add_member(:segment_attributes, Shapes::ShapeRef.new(shape: SegmentAttributes, location_name: "SegmentAttributes"))
@@ -4611,6 +4633,17 @@ module Aws::Connect
     ParticipantDetailsToAdd.add_member(:display_name, Shapes::ShapeRef.new(shape: DisplayName, location_name: "DisplayName"))
     ParticipantDetailsToAdd.struct_class = Types::ParticipantDetailsToAdd
 
+    ParticipantMetrics.add_member(:participant_id, Shapes::ShapeRef.new(shape: ParticipantId, location_name: "ParticipantId"))
+    ParticipantMetrics.add_member(:participant_type, Shapes::ShapeRef.new(shape: ParticipantType, location_name: "ParticipantType"))
+    ParticipantMetrics.add_member(:conversation_abandon, Shapes::ShapeRef.new(shape: NullableBoolean, location_name: "ConversationAbandon"))
+    ParticipantMetrics.add_member(:messages_sent, Shapes::ShapeRef.new(shape: Count, location_name: "MessagesSent"))
+    ParticipantMetrics.add_member(:num_responses, Shapes::ShapeRef.new(shape: Count, location_name: "NumResponses"))
+    ParticipantMetrics.add_member(:message_length_in_chars, Shapes::ShapeRef.new(shape: Count, location_name: "MessageLengthInChars"))
+    ParticipantMetrics.add_member(:total_response_time_in_millis, Shapes::ShapeRef.new(shape: DurationMillis, location_name: "TotalResponseTimeInMillis"))
+    ParticipantMetrics.add_member(:max_response_time_in_millis, Shapes::ShapeRef.new(shape: DurationMillis, location_name: "MaxResponseTimeInMillis"))
+    ParticipantMetrics.add_member(:last_message_timestamp, Shapes::ShapeRef.new(shape: timestamp, location_name: "LastMessageTimestamp"))
+    ParticipantMetrics.struct_class = Types::ParticipantMetrics
+
     ParticipantTimerConfigList.member = Shapes::ShapeRef.new(shape: ParticipantTimerConfiguration)
 
     ParticipantTimerConfiguration.add_member(:participant_role, Shapes::ShapeRef.new(shape: TimerEligibleParticipantRoles, required: true, location_name: "ParticipantRole"))

data/lib/aws-sdk-connect/types.rb

@@ -2046,6 +2046,61 @@ module Aws::Connect
       include Aws::Structure
     end
 
+    # Information about the overall participant interactions at the contact
+    # level.
+    #
+    # @!attribute [rw] multi_party
+    #   A boolean flag indicating whether multiparty chat or supervisor
+    #   barge were enabled on this contact.
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] total_messages
+    #   The number of chat messages on the contact.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] total_bot_messages
+    #   The total number of bot and automated messages on a chat contact.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] total_bot_message_length_in_chars
+    #   The total number of characters from bot and automated messages on a
+    #   chat contact.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] conversation_close_time_in_millis
+    #   The time it took for a contact to end after the last customer
+    #   message.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] conversation_turn_count
+    #   The number of conversation turns in a chat contact, which represents
+    #   the back-and-forth exchanges between customer and other
+    #   participants.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] agent_first_response_timestamp
+    #   The agent first response timestamp for a chat contact.
+    #   @return [Time]
+    #
+    # @!attribute [rw] agent_first_response_time_in_millis
+    #   The time for an agent to respond after obtaining a chat contact.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/ChatContactMetrics AWS API Documentation
+    #
+    class ChatContactMetrics < Struct.new(
+      :multi_party,
+      :total_messages,
+      :total_bot_messages,
+      :total_bot_message_length_in_chars,
+      :conversation_close_time_in_millis,
+      :conversation_turn_count,
+      :agent_first_response_timestamp,
+      :agent_first_response_time_in_millis)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Chat integration event containing payload to perform different chat
     # actions such as:
     #
@@ -2136,6 +2191,32 @@ module Aws::Connect
       include Aws::Structure
     end
 
+    # Information about how agent, bot, and customer interact in a chat
+    # contact.
+    #
+    # @!attribute [rw] chat_contact_metrics
+    #   Information about the overall participant interactions at the
+    #   contact level.
+    #   @return [Types::ChatContactMetrics]
+    #
+    # @!attribute [rw] agent_metrics
+    #   Information about agent interactions in a contact.
+    #   @return [Types::ParticipantMetrics]
+    #
+    # @!attribute [rw] customer_metrics
+    #   Information about customer interactions in a contact.
+    #   @return [Types::ParticipantMetrics]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/ChatMetrics AWS API Documentation
+    #
+    class ChatMetrics < Struct.new(
+      :chat_contact_metrics,
+      :agent_metrics,
+      :customer_metrics)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Configuration information for the chat participant role.
     #
     # @!attribute [rw] participant_timer_config_list
@@ -2667,6 +2748,11 @@ module Aws::Connect
     #   connection.
     #   @return [Types::QualityMetrics]
     #
+    # @!attribute [rw] chat_metrics
+    #   Information about how agent, bot, and customer interact in a chat
+    #   contact.
+    #   @return [Types::ChatMetrics]
+    #
     # @!attribute [rw] disconnect_details
     #   Information about the call disconnect experience.
     #   @return [Types::DisconnectDetails]
@@ -2744,6 +2830,7 @@ module Aws::Connect
       :answering_machine_detection_status,
       :customer_voice_activity,
       :quality_metrics,
+      :chat_metrics,
       :disconnect_details,
       :additional_email_recipients,
       :segment_attributes,
@@ -3923,29 +4010,31 @@ module Aws::Connect
     # @!attribute [rw] references
     #   A formatted URL that is shown to an agent in the Contact Control
     #   Panel (CCP). Tasks can have the following reference types at the
-    #   time of creation: URL \| NUMBER \| STRING \| DATE \| EMAIL \|
-    #   ATTACHMENT.
+    #   time of creation: `URL` \| `NUMBER` \| `STRING` \| `DATE` \| `EMAIL`
+    #   \| `ATTACHMENT`.
     #   @return [Hash<String,Types::Reference>]
     #
     # @!attribute [rw] channel
-    #   The channel for the contact
+    #   The channel for the contact.
     #
-    #   CreateContact only supports the EMAIL and VOICE channels. The
-    #   following information that states other channels are supported is
-    #   incorrect. We are working to update this topic.
+    #   The CHAT channel is not supported. The following information is
+    #   incorrect. We're working to correct it.
     #   @return [String]
     #
     # @!attribute [rw] initiation_method
     #   Indicates how the contact was initiated.
     #
-    #   CreateContact only supports the following initiation methods:
+    #   CreateContact only supports the following initiation methods. Valid
+    #   values by channel are:
     #
-    #    * For EMAIL: OUTBOUND, AGENT\_REPLY, and FLOW.
+    #    * For VOICE: `TRANSFER` and the subtype `connect:ExternalAudio`
     #
-    #   * For VOICE: TRANSFER and the subtype connect:ExternalAudio.
+    #   * For EMAIL: `OUTBOUND` \| `AGENT_REPLY` \| `FLOW`
     #
-    #    The following information that states other initiation methods are
-    #   supported is incorrect. We are working to update this topic.
+    #   * For TASK: `API`
+    #
+    #    The other channels listed below are incorrect. We're working to
+    #   correct this information.
     #   @return [String]
     #
     # @!attribute [rw] expiry_duration_in_minutes
@@ -3955,12 +4044,13 @@ module Aws::Connect
     # @!attribute [rw] user_info
     #   User details for the contact
     #
-    #   UserInfo is required when creating an EMAIL contact with OUTBOUND
-    #   and AGENT\_REPLY contact initiation methods.
+    #   UserInfo is required when creating an EMAIL contact with `OUTBOUND`
+    #   and `AGENT_REPLY` contact initiation methods.
     #   @return [Types::UserInfo]
     #
     # @!attribute [rw] initiate_as
-    #   Initial state of the contact when it's created
+    #   Initial state of the contact when it's created. Only TASK channel
+    #   contacts can be initiated with `COMPLETED` state.
     #   @return [String]
     #
     # @!attribute [rw] name
@@ -17401,6 +17491,62 @@ module Aws::Connect
       include Aws::Structure
     end
 
+    # Information about a participant's interactions in a contact.
+    #
+    # @!attribute [rw] participant_id
+    #   The Participant's ID.
+    #   @return [String]
+    #
+    # @!attribute [rw] participant_type
+    #   Information about the conversation participant. Following are the
+    #   participant types: \[Agent, Customer, Supervisor\].
+    #   @return [String]
+    #
+    # @!attribute [rw] conversation_abandon
+    #   A boolean flag indicating whether the chat conversation was
+    #   abandoned by a Participant.
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] messages_sent
+    #   Number of chat messages sent by Participant.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] num_responses
+    #   Number of chat messages sent by Participant.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] message_length_in_chars
+    #   Number of chat characters sent by Participant.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] total_response_time_in_millis
+    #   Total chat response time by Participant.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] max_response_time_in_millis
+    #   Maximum chat response time by Participant.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] last_message_timestamp
+    #   Timestamp of last chat message by Participant.
+    #   @return [Time]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/ParticipantMetrics AWS API Documentation
+    #
+    class ParticipantMetrics < Struct.new(
+      :participant_id,
+      :participant_type,
+      :conversation_abandon,
+      :messages_sent,
+      :num_responses,
+      :message_length_in_chars,
+      :total_response_time_in_millis,
+      :max_response_time_in_millis,
+      :last_message_timestamp)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Configuration information for the timer. After the timer configuration
     # is set, it persists for the duration of the chat. It persists across
     # new contacts in the chain, for example, transfer contacts.

data/lib/aws-sdk-connect.rb

@@ -54,7 +54,7 @@ module Aws::Connect
   autoload :EndpointProvider, 'aws-sdk-connect/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-connect/endpoints'
 
-  GEM_VERSION = '1.205.0'
+  GEM_VERSION = '1.206.0'
 
 end
 

data/sig/types.rbs

@@ -498,6 +498,18 @@ module Aws::Connect
       SENSITIVE: []
     end
 
+    class ChatContactMetrics
+      attr_accessor multi_party: bool
+      attr_accessor total_messages: ::Integer
+      attr_accessor total_bot_messages: ::Integer
+      attr_accessor total_bot_message_length_in_chars: ::Integer
+      attr_accessor conversation_close_time_in_millis: ::Integer
+      attr_accessor conversation_turn_count: ::Integer
+      attr_accessor agent_first_response_timestamp: ::Time
+      attr_accessor agent_first_response_time_in_millis: ::Integer
+      SENSITIVE: []
+    end
+
     class ChatEvent
       attr_accessor type: ("DISCONNECT" | "MESSAGE" | "EVENT")
       attr_accessor content_type: ::String
@@ -511,6 +523,13 @@ module Aws::Connect
       SENSITIVE: []
     end
 
+    class ChatMetrics
+      attr_accessor chat_contact_metrics: Types::ChatContactMetrics
+      attr_accessor agent_metrics: Types::ParticipantMetrics
+      attr_accessor customer_metrics: Types::ParticipantMetrics
+      SENSITIVE: []
+    end
+
     class ChatParticipantRoleConfig
       attr_accessor participant_timer_config_list: ::Array[Types::ParticipantTimerConfiguration]
       SENSITIVE: []
@@ -624,6 +643,7 @@ module Aws::Connect
       attr_accessor answering_machine_detection_status: ("ANSWERED" | "UNDETECTED" | "ERROR" | "HUMAN_ANSWERED" | "SIT_TONE_DETECTED" | "SIT_TONE_BUSY" | "SIT_TONE_INVALID_NUMBER" | "FAX_MACHINE_DETECTED" | "VOICEMAIL_BEEP" | "VOICEMAIL_NO_BEEP" | "AMD_UNRESOLVED" | "AMD_UNANSWERED" | "AMD_ERROR" | "AMD_NOT_APPLICABLE")
       attr_accessor customer_voice_activity: Types::CustomerVoiceActivity
       attr_accessor quality_metrics: Types::QualityMetrics
+      attr_accessor chat_metrics: Types::ChatMetrics
       attr_accessor disconnect_details: Types::DisconnectDetails
       attr_accessor additional_email_recipients: Types::AdditionalEmailRecipients
       attr_accessor segment_attributes: ::Hash[::String, Types::SegmentAttributeValue]
@@ -3932,6 +3952,19 @@ module Aws::Connect
       SENSITIVE: []
     end
 
+    class ParticipantMetrics
+      attr_accessor participant_id: ::String
+      attr_accessor participant_type: ("ALL" | "MANAGER" | "AGENT" | "CUSTOMER" | "THIRDPARTY")
+      attr_accessor conversation_abandon: bool
+      attr_accessor messages_sent: ::Integer
+      attr_accessor num_responses: ::Integer
+      attr_accessor message_length_in_chars: ::Integer
+      attr_accessor total_response_time_in_millis: ::Integer
+      attr_accessor max_response_time_in_millis: ::Integer
+      attr_accessor last_message_timestamp: ::Time
+      SENSITIVE: []
+    end
+
     class ParticipantTimerConfiguration
       attr_accessor participant_role: ("CUSTOMER" | "AGENT")
       attr_accessor timer_type: ("IDLE" | "DISCONNECT_NONCUSTOMER")

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-connect
 version: !ruby/object:Gem::Version
-  version: 1.205.0
+  version: 1.206.0
 platform: ruby
 authors:
 - Amazon Web Services