aws-sdk-connect 1.259.0 → 1.261.0

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

@@ -2049,7 +2049,7 @@ module Aws::Connect
     #   resp.files[0].file_status #=> String, one of "APPROVED", "REJECTED", "PROCESSING", "FAILED"
     #   resp.files[0].created_by.connect_user_arn #=> String
     #   resp.files[0].created_by.aws_identity_arn #=> String
-    #   resp.files[0].file_use_case_type #=> String, one of "CONTACT_ANALYSIS", "EMAIL_MESSAGE", "EMAIL_MESSAGE_PLAIN_TEXT", "EMAIL_MESSAGE_REDACTED", "EMAIL_MESSAGE_PLAIN_TEXT_REDACTED", "ATTACHMENT"
+    #   resp.files[0].file_use_case_type #=> String, one of "CONTACT_ANALYSIS", "EMAIL_MESSAGE", "EMAIL_MESSAGE_PLAIN_TEXT", "EMAIL_MESSAGE_REDACTED", "EMAIL_MESSAGE_PLAIN_TEXT_REDACTED", "ATTACHMENT", "VOICE_RECORDING"
     #   resp.files[0].associated_resource_arn #=> String
     #   resp.files[0].tags #=> Hash
     #   resp.files[0].tags["TagKey"] #=> String
@@ -2512,6 +2512,99 @@ module Aws::Connect
       req.send_request(options)
     end
 
+    # Creates an attached file for a completed voice contact by copying a
+    # recording from a source S3 URI into Connect Customer managed storage.
+    # Use this API to attach voice recordings to contacts for downstream
+    # processing such as conversational analytics.
+    #
+    # The `AssociatedResourceArn` must be the ARN of a completed voice
+    # contact, `FileUseCaseType` must be set to `VOICE_RECORDING`, and
+    # `FileSourceUri` must be a valid S3 URI.
+    #
+    # <note markdown="1"> For example, you can call `CreateContact`, then `CreateAttachedFile`,
+    # then `StartContactConversationalAnalyticsJob` to create a contact,
+    # attach a recording, and run post-call analytics.
+    #
+    #  </note>
+    #
+    # @option params [String] :client_token
+    #   A unique, case-sensitive identifier that you provide to ensure the
+    #   idempotency of the request. If not provided, the Amazon Web Services
+    #   SDK populates this field. For more information about idempotency, see
+    #   [Making retries safe with idempotent APIs][1].
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.**
+    #
+    #
+    #
+    #   [1]: https://aws.amazon.com/builders-library/making-retries-safe-with-idempotent-APIs/
+    #
+    # @option params [required, String] :instance_id
+    #   The identifier of the Connect Customer instance. You can [find the
+    #   instance ID][1] in the Amazon Resource Name (ARN) of the instance.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html
+    #
+    # @option params [required, String] :file_use_case_type
+    #   The use case for the file.
+    #
+    #   Only `VOICE_RECORDING` is supported.
+    #
+    # @option params [required, String] :file_source_uri
+    #   The S3 URI of the file to be attached. Only S3 source URIs are
+    #   supported.
+    #
+    # @option params [required, String] :associated_resource_arn
+    #   The ARN of the completed voice contact to attach the file to. Only
+    #   voice contacts with Telephony subtype are supported.
+    #
+    #   <note markdown="1"> This value must be a valid ARN.
+    #
+    #    </note>
+    #
+    # @option params [Hash<String,String>] :tags
+    #   The tags used to organize, track, or control access for this resource.
+    #   For example, `{ "Tags": {"key1":"value1", "key2":"value2"} }`.
+    #
+    # @return [Types::CreateAttachedFileResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateAttachedFileResponse#file_arn #file_arn} => String
+    #   * {Types::CreateAttachedFileResponse#file_id #file_id} => String
+    #   * {Types::CreateAttachedFileResponse#creation_time #creation_time} => String
+    #   * {Types::CreateAttachedFileResponse#file_status #file_status} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_attached_file({
+    #     client_token: "ClientToken",
+    #     instance_id: "InstanceId", # required
+    #     file_use_case_type: "CONTACT_ANALYSIS", # required, accepts CONTACT_ANALYSIS, EMAIL_MESSAGE, EMAIL_MESSAGE_PLAIN_TEXT, EMAIL_MESSAGE_REDACTED, EMAIL_MESSAGE_PLAIN_TEXT_REDACTED, ATTACHMENT, VOICE_RECORDING
+    #     file_source_uri: "FileSourceUri", # required
+    #     associated_resource_arn: "ARN", # required
+    #     tags: {
+    #       "TagKey" => "TagValue",
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.file_arn #=> String
+    #   resp.file_id #=> String
+    #   resp.creation_time #=> String
+    #   resp.file_status #=> String, one of "APPROVED", "REJECTED", "PROCESSING", "FAILED"
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/CreateAttachedFile AWS API Documentation
+    #
+    # @overload create_attached_file(params = {})
+    # @param [Hash] params ({})
+    def create_attached_file(params = {}, options = {})
+      req = build_request(:create_attached_file, params)
+      req.send_request(options)
+    end
+
     # Only the VOICE, EMAIL, and TASK channels are supported.
     #
     #  * For VOICE: The supported initiation method is `TRANSFER`. The
@@ -3362,6 +3455,14 @@ module Aws::Connect
     #             # recursive EvaluationFormItemsList
     #           },
     #           weight: 1.0,
+    #           is_excluded_from_scoring: false,
+    #           score_thresholds: [
+    #             {
+    #               performance_category: "NEEDS_IMPROVEMENT", # required, accepts NEEDS_IMPROVEMENT, EXCEEDS_EXPECTATIONS
+    #               min_score_percentage: 1.0,
+    #               max_score_percentage: 1.0,
+    #             },
+    #           ],
     #         },
     #         question: {
     #           title: "EvaluationFormQuestionTitle", # required
@@ -3382,6 +3483,10 @@ module Aws::Connect
     #                   automatic_fail_configuration: {
     #                     target_section: "ReferenceId",
     #                   },
+    #                   points_configuration: {
+    #                     point_value: 1, # required
+    #                     is_bonus: false,
+    #                   },
     #                 },
     #               ],
     #               automation: {
@@ -3403,6 +3508,10 @@ module Aws::Connect
     #                   automatic_fail_configuration: {
     #                     target_section: "ReferenceId",
     #                   },
+    #                   points_configuration: {
+    #                     point_value: 1, # required
+    #                     is_bonus: false,
+    #                   },
     #                 },
     #               ],
     #               display_as: "DROPDOWN", # accepts DROPDOWN, RADIO
@@ -3434,6 +3543,15 @@ module Aws::Connect
     #                 {
     #                   ref_id: "ReferenceId", # required
     #                   text: "EvaluationFormMultiSelectQuestionOptionText", # required
+    #                   score: 1,
+    #                   automatic_fail: false,
+    #                   automatic_fail_configuration: {
+    #                     target_section: "ReferenceId",
+    #                   },
+    #                   points_configuration: {
+    #                     point_value: 1, # required
+    #                     is_bonus: false,
+    #                   },
     #                 },
     #               ],
     #               display_as: "DROPDOWN", # accepts DROPDOWN, CHECKBOX
@@ -3482,12 +3600,34 @@ module Aws::Connect
     #             default_action: "DISABLE", # accepts DISABLE, ENABLE
     #           },
     #           weight: 1.0,
+    #           scoring_configuration: {
+    #             points_configuration: {
+    #               max_point_value: 1,
+    #               min_point_value: 1,
+    #               is_bonus: false,
+    #             },
+    #             is_excluded_from_scoring: false,
+    #             score_thresholds: [
+    #               {
+    #                 performance_category: "NEEDS_IMPROVEMENT", # required, accepts NEEDS_IMPROVEMENT, EXCEEDS_EXPECTATIONS
+    #                 min_score_percentage: 1.0,
+    #                 max_score_percentage: 1.0,
+    #               },
+    #             ],
+    #           },
     #         },
     #       },
     #     ],
     #     scoring_strategy: {
-    #       mode: "QUESTION_ONLY", # required, accepts QUESTION_ONLY, SECTION_ONLY
+    #       mode: "QUESTION_ONLY", # required, accepts QUESTION_ONLY, SECTION_ONLY, POINTS_BASED
     #       status: "ENABLED", # required, accepts ENABLED, DISABLED
+    #       score_thresholds: [
+    #         {
+    #           performance_category: "NEEDS_IMPROVEMENT", # required, accepts NEEDS_IMPROVEMENT, EXCEEDS_EXPECTATIONS
+    #           min_score_percentage: 1.0,
+    #           max_score_percentage: 1.0,
+    #         },
+    #       ],
     #     },
     #     auto_evaluation_configuration: {
     #       enabled: false, # required
@@ -7774,6 +7914,9 @@ module Aws::Connect
     #   resp.evaluation.metadata.score.not_applicable #=> Boolean
     #   resp.evaluation.metadata.score.automatic_fail #=> Boolean
     #   resp.evaluation.metadata.score.applied_weight #=> Float
+    #   resp.evaluation.metadata.score.earned_points #=> Integer
+    #   resp.evaluation.metadata.score.max_base_point #=> Integer
+    #   resp.evaluation.metadata.score.performance_category #=> String, one of "NEEDS_IMPROVEMENT", "EXCEEDS_EXPECTATIONS"
     #   resp.evaluation.metadata.auto_evaluation.auto_evaluation_enabled #=> Boolean
     #   resp.evaluation.metadata.auto_evaluation.auto_evaluation_status #=> String, one of "IN_PROGRESS", "FAILED", "SUCCEEDED"
     #   resp.evaluation.metadata.acknowledgement.acknowledged_time #=> Time
@@ -7832,6 +7975,9 @@ module Aws::Connect
     #   resp.evaluation.scores["ResourceId"].not_applicable #=> Boolean
     #   resp.evaluation.scores["ResourceId"].automatic_fail #=> Boolean
     #   resp.evaluation.scores["ResourceId"].applied_weight #=> Float
+    #   resp.evaluation.scores["ResourceId"].earned_points #=> Integer
+    #   resp.evaluation.scores["ResourceId"].max_base_point #=> Integer
+    #   resp.evaluation.scores["ResourceId"].performance_category #=> String, one of "NEEDS_IMPROVEMENT", "EXCEEDS_EXPECTATIONS"
     #   resp.evaluation.created_time #=> Time
     #   resp.evaluation.last_modified_time #=> Time
     #   resp.evaluation.evaluation_type #=> String, one of "STANDARD", "CALIBRATION"
@@ -7848,6 +7994,11 @@ module Aws::Connect
     #   resp.evaluation_form.items[0].section.instructions #=> String
     #   resp.evaluation_form.items[0].section.items #=> Types::EvaluationFormItemsList
     #   resp.evaluation_form.items[0].section.weight #=> Float
+    #   resp.evaluation_form.items[0].section.is_excluded_from_scoring #=> Boolean
+    #   resp.evaluation_form.items[0].section.score_thresholds #=> Array
+    #   resp.evaluation_form.items[0].section.score_thresholds[0].performance_category #=> String, one of "NEEDS_IMPROVEMENT", "EXCEEDS_EXPECTATIONS"
+    #   resp.evaluation_form.items[0].section.score_thresholds[0].min_score_percentage #=> Float
+    #   resp.evaluation_form.items[0].section.score_thresholds[0].max_score_percentage #=> Float
     #   resp.evaluation_form.items[0].question.title #=> String
     #   resp.evaluation_form.items[0].question.instructions #=> String
     #   resp.evaluation_form.items[0].question.ref_id #=> String
@@ -7861,6 +8012,8 @@ module Aws::Connect
     #   resp.evaluation_form.items[0].question.question_type_properties.numeric.options[0].score #=> Integer
     #   resp.evaluation_form.items[0].question.question_type_properties.numeric.options[0].automatic_fail #=> Boolean
     #   resp.evaluation_form.items[0].question.question_type_properties.numeric.options[0].automatic_fail_configuration.target_section #=> String
+    #   resp.evaluation_form.items[0].question.question_type_properties.numeric.options[0].points_configuration.point_value #=> Integer
+    #   resp.evaluation_form.items[0].question.question_type_properties.numeric.options[0].points_configuration.is_bonus #=> Boolean
     #   resp.evaluation_form.items[0].question.question_type_properties.numeric.automation.property_value.label #=> String, one of "OVERALL_CUSTOMER_SENTIMENT_SCORE", "OVERALL_AGENT_SENTIMENT_SCORE", "CUSTOMER_SENTIMENT_SCORE_WITHOUT_AGENT", "CUSTOMER_SENTIMENT_SCORE_WITH_AGENT", "NON_TALK_TIME", "NON_TALK_TIME_PERCENTAGE", "NUMBER_OF_INTERRUPTIONS", "CONTACT_DURATION", "AGENT_INTERACTION_DURATION", "CUSTOMER_HOLD_TIME", "LONGEST_HOLD_DURATION", "NUMBER_OF_HOLDS", "AGENT_INTERACTION_AND_HOLD_DURATION"
     #   resp.evaluation_form.items[0].question.question_type_properties.numeric.automation.answer_source.source_type #=> String, one of "CONTACT_LENS_DATA", "GEN_AI"
     #   resp.evaluation_form.items[0].question.question_type_properties.single_select.options #=> Array
@@ -7869,6 +8022,8 @@ module Aws::Connect
     #   resp.evaluation_form.items[0].question.question_type_properties.single_select.options[0].score #=> Integer
     #   resp.evaluation_form.items[0].question.question_type_properties.single_select.options[0].automatic_fail #=> Boolean
     #   resp.evaluation_form.items[0].question.question_type_properties.single_select.options[0].automatic_fail_configuration.target_section #=> String
+    #   resp.evaluation_form.items[0].question.question_type_properties.single_select.options[0].points_configuration.point_value #=> Integer
+    #   resp.evaluation_form.items[0].question.question_type_properties.single_select.options[0].points_configuration.is_bonus #=> Boolean
     #   resp.evaluation_form.items[0].question.question_type_properties.single_select.display_as #=> String, one of "DROPDOWN", "RADIO"
     #   resp.evaluation_form.items[0].question.question_type_properties.single_select.automation.options #=> Array
     #   resp.evaluation_form.items[0].question.question_type_properties.single_select.automation.options[0].rule_category.category #=> String
@@ -7880,6 +8035,11 @@ module Aws::Connect
     #   resp.evaluation_form.items[0].question.question_type_properties.multi_select.options #=> Array
     #   resp.evaluation_form.items[0].question.question_type_properties.multi_select.options[0].ref_id #=> String
     #   resp.evaluation_form.items[0].question.question_type_properties.multi_select.options[0].text #=> String
+    #   resp.evaluation_form.items[0].question.question_type_properties.multi_select.options[0].score #=> Integer
+    #   resp.evaluation_form.items[0].question.question_type_properties.multi_select.options[0].automatic_fail #=> Boolean
+    #   resp.evaluation_form.items[0].question.question_type_properties.multi_select.options[0].automatic_fail_configuration.target_section #=> String
+    #   resp.evaluation_form.items[0].question.question_type_properties.multi_select.options[0].points_configuration.point_value #=> Integer
+    #   resp.evaluation_form.items[0].question.question_type_properties.multi_select.options[0].points_configuration.is_bonus #=> Boolean
     #   resp.evaluation_form.items[0].question.question_type_properties.multi_select.display_as #=> String, one of "DROPDOWN", "CHECKBOX"
     #   resp.evaluation_form.items[0].question.question_type_properties.multi_select.automation.options #=> Array
     #   resp.evaluation_form.items[0].question.question_type_properties.multi_select.automation.options[0].rule_category.category #=> String
@@ -7901,8 +8061,20 @@ module Aws::Connect
     #   resp.evaluation_form.items[0].question.enablement.action #=> String, one of "DISABLE", "ENABLE"
     #   resp.evaluation_form.items[0].question.enablement.default_action #=> String, one of "DISABLE", "ENABLE"
     #   resp.evaluation_form.items[0].question.weight #=> Float
-    #   resp.evaluation_form.scoring_strategy.mode #=> String, one of "QUESTION_ONLY", "SECTION_ONLY"
+    #   resp.evaluation_form.items[0].question.scoring_configuration.points_configuration.max_point_value #=> Integer
+    #   resp.evaluation_form.items[0].question.scoring_configuration.points_configuration.min_point_value #=> Integer
+    #   resp.evaluation_form.items[0].question.scoring_configuration.points_configuration.is_bonus #=> Boolean
+    #   resp.evaluation_form.items[0].question.scoring_configuration.is_excluded_from_scoring #=> Boolean
+    #   resp.evaluation_form.items[0].question.scoring_configuration.score_thresholds #=> Array
+    #   resp.evaluation_form.items[0].question.scoring_configuration.score_thresholds[0].performance_category #=> String, one of "NEEDS_IMPROVEMENT", "EXCEEDS_EXPECTATIONS"
+    #   resp.evaluation_form.items[0].question.scoring_configuration.score_thresholds[0].min_score_percentage #=> Float
+    #   resp.evaluation_form.items[0].question.scoring_configuration.score_thresholds[0].max_score_percentage #=> Float
+    #   resp.evaluation_form.scoring_strategy.mode #=> String, one of "QUESTION_ONLY", "SECTION_ONLY", "POINTS_BASED"
     #   resp.evaluation_form.scoring_strategy.status #=> String, one of "ENABLED", "DISABLED"
+    #   resp.evaluation_form.scoring_strategy.score_thresholds #=> Array
+    #   resp.evaluation_form.scoring_strategy.score_thresholds[0].performance_category #=> String, one of "NEEDS_IMPROVEMENT", "EXCEEDS_EXPECTATIONS"
+    #   resp.evaluation_form.scoring_strategy.score_thresholds[0].min_score_percentage #=> Float
+    #   resp.evaluation_form.scoring_strategy.score_thresholds[0].max_score_percentage #=> Float
     #   resp.evaluation_form.auto_evaluation_configuration.enabled #=> Boolean
     #   resp.evaluation_form.target_configuration.contact_interaction_type #=> String, one of "AGENT", "AUTOMATED", "CUSTOMER"
     #   resp.evaluation_form.language_configuration.form_language #=> String, one of "de-DE", "en-US", "es-ES", "fr-FR", "it-IT", "pt-BR", "ja-JP", "ko-KR", "zh-CN"
@@ -8311,6 +8483,11 @@ module Aws::Connect
     #   resp.evaluation_form.items[0].section.instructions #=> String
     #   resp.evaluation_form.items[0].section.items #=> Types::EvaluationFormItemsList
     #   resp.evaluation_form.items[0].section.weight #=> Float
+    #   resp.evaluation_form.items[0].section.is_excluded_from_scoring #=> Boolean
+    #   resp.evaluation_form.items[0].section.score_thresholds #=> Array
+    #   resp.evaluation_form.items[0].section.score_thresholds[0].performance_category #=> String, one of "NEEDS_IMPROVEMENT", "EXCEEDS_EXPECTATIONS"
+    #   resp.evaluation_form.items[0].section.score_thresholds[0].min_score_percentage #=> Float
+    #   resp.evaluation_form.items[0].section.score_thresholds[0].max_score_percentage #=> Float
     #   resp.evaluation_form.items[0].question.title #=> String
     #   resp.evaluation_form.items[0].question.instructions #=> String
     #   resp.evaluation_form.items[0].question.ref_id #=> String
@@ -8324,6 +8501,8 @@ module Aws::Connect
     #   resp.evaluation_form.items[0].question.question_type_properties.numeric.options[0].score #=> Integer
     #   resp.evaluation_form.items[0].question.question_type_properties.numeric.options[0].automatic_fail #=> Boolean
     #   resp.evaluation_form.items[0].question.question_type_properties.numeric.options[0].automatic_fail_configuration.target_section #=> String
+    #   resp.evaluation_form.items[0].question.question_type_properties.numeric.options[0].points_configuration.point_value #=> Integer
+    #   resp.evaluation_form.items[0].question.question_type_properties.numeric.options[0].points_configuration.is_bonus #=> Boolean
     #   resp.evaluation_form.items[0].question.question_type_properties.numeric.automation.property_value.label #=> String, one of "OVERALL_CUSTOMER_SENTIMENT_SCORE", "OVERALL_AGENT_SENTIMENT_SCORE", "CUSTOMER_SENTIMENT_SCORE_WITHOUT_AGENT", "CUSTOMER_SENTIMENT_SCORE_WITH_AGENT", "NON_TALK_TIME", "NON_TALK_TIME_PERCENTAGE", "NUMBER_OF_INTERRUPTIONS", "CONTACT_DURATION", "AGENT_INTERACTION_DURATION", "CUSTOMER_HOLD_TIME", "LONGEST_HOLD_DURATION", "NUMBER_OF_HOLDS", "AGENT_INTERACTION_AND_HOLD_DURATION"
     #   resp.evaluation_form.items[0].question.question_type_properties.numeric.automation.answer_source.source_type #=> String, one of "CONTACT_LENS_DATA", "GEN_AI"
     #   resp.evaluation_form.items[0].question.question_type_properties.single_select.options #=> Array
@@ -8332,6 +8511,8 @@ module Aws::Connect
     #   resp.evaluation_form.items[0].question.question_type_properties.single_select.options[0].score #=> Integer
     #   resp.evaluation_form.items[0].question.question_type_properties.single_select.options[0].automatic_fail #=> Boolean
     #   resp.evaluation_form.items[0].question.question_type_properties.single_select.options[0].automatic_fail_configuration.target_section #=> String
+    #   resp.evaluation_form.items[0].question.question_type_properties.single_select.options[0].points_configuration.point_value #=> Integer
+    #   resp.evaluation_form.items[0].question.question_type_properties.single_select.options[0].points_configuration.is_bonus #=> Boolean
     #   resp.evaluation_form.items[0].question.question_type_properties.single_select.display_as #=> String, one of "DROPDOWN", "RADIO"
     #   resp.evaluation_form.items[0].question.question_type_properties.single_select.automation.options #=> Array
     #   resp.evaluation_form.items[0].question.question_type_properties.single_select.automation.options[0].rule_category.category #=> String
@@ -8343,6 +8524,11 @@ module Aws::Connect
     #   resp.evaluation_form.items[0].question.question_type_properties.multi_select.options #=> Array
     #   resp.evaluation_form.items[0].question.question_type_properties.multi_select.options[0].ref_id #=> String
     #   resp.evaluation_form.items[0].question.question_type_properties.multi_select.options[0].text #=> String
+    #   resp.evaluation_form.items[0].question.question_type_properties.multi_select.options[0].score #=> Integer
+    #   resp.evaluation_form.items[0].question.question_type_properties.multi_select.options[0].automatic_fail #=> Boolean
+    #   resp.evaluation_form.items[0].question.question_type_properties.multi_select.options[0].automatic_fail_configuration.target_section #=> String
+    #   resp.evaluation_form.items[0].question.question_type_properties.multi_select.options[0].points_configuration.point_value #=> Integer
+    #   resp.evaluation_form.items[0].question.question_type_properties.multi_select.options[0].points_configuration.is_bonus #=> Boolean
     #   resp.evaluation_form.items[0].question.question_type_properties.multi_select.display_as #=> String, one of "DROPDOWN", "CHECKBOX"
     #   resp.evaluation_form.items[0].question.question_type_properties.multi_select.automation.options #=> Array
     #   resp.evaluation_form.items[0].question.question_type_properties.multi_select.automation.options[0].rule_category.category #=> String
@@ -8364,8 +8550,20 @@ module Aws::Connect
     #   resp.evaluation_form.items[0].question.enablement.action #=> String, one of "DISABLE", "ENABLE"
     #   resp.evaluation_form.items[0].question.enablement.default_action #=> String, one of "DISABLE", "ENABLE"
     #   resp.evaluation_form.items[0].question.weight #=> Float
-    #   resp.evaluation_form.scoring_strategy.mode #=> String, one of "QUESTION_ONLY", "SECTION_ONLY"
+    #   resp.evaluation_form.items[0].question.scoring_configuration.points_configuration.max_point_value #=> Integer
+    #   resp.evaluation_form.items[0].question.scoring_configuration.points_configuration.min_point_value #=> Integer
+    #   resp.evaluation_form.items[0].question.scoring_configuration.points_configuration.is_bonus #=> Boolean
+    #   resp.evaluation_form.items[0].question.scoring_configuration.is_excluded_from_scoring #=> Boolean
+    #   resp.evaluation_form.items[0].question.scoring_configuration.score_thresholds #=> Array
+    #   resp.evaluation_form.items[0].question.scoring_configuration.score_thresholds[0].performance_category #=> String, one of "NEEDS_IMPROVEMENT", "EXCEEDS_EXPECTATIONS"
+    #   resp.evaluation_form.items[0].question.scoring_configuration.score_thresholds[0].min_score_percentage #=> Float
+    #   resp.evaluation_form.items[0].question.scoring_configuration.score_thresholds[0].max_score_percentage #=> Float
+    #   resp.evaluation_form.scoring_strategy.mode #=> String, one of "QUESTION_ONLY", "SECTION_ONLY", "POINTS_BASED"
     #   resp.evaluation_form.scoring_strategy.status #=> String, one of "ENABLED", "DISABLED"
+    #   resp.evaluation_form.scoring_strategy.score_thresholds #=> Array
+    #   resp.evaluation_form.scoring_strategy.score_thresholds[0].performance_category #=> String, one of "NEEDS_IMPROVEMENT", "EXCEEDS_EXPECTATIONS"
+    #   resp.evaluation_form.scoring_strategy.score_thresholds[0].min_score_percentage #=> Float
+    #   resp.evaluation_form.scoring_strategy.score_thresholds[0].max_score_percentage #=> Float
     #   resp.evaluation_form.created_time #=> Time
     #   resp.evaluation_form.created_by #=> String
     #   resp.evaluation_form.last_modified_time #=> Time
@@ -8379,6 +8577,8 @@ module Aws::Connect
     #   resp.evaluation_form.tags["TagKey"] #=> String
     #   resp.evaluation_form.target_configuration.contact_interaction_type #=> String, one of "AGENT", "AUTOMATED", "CUSTOMER"
     #   resp.evaluation_form.language_configuration.form_language #=> String, one of "de-DE", "en-US", "es-ES", "fr-FR", "it-IT", "pt-BR", "ja-JP", "ko-KR", "zh-CN"
+    #   resp.evaluation_form.latest_validation_status #=> String, one of "IN_PROGRESS", "COMPLETED", "FAILED"
+    #   resp.evaluation_form.last_validation_time #=> Time
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/DescribeEvaluationForm AWS API Documentation
     #
@@ -10807,7 +11007,7 @@ module Aws::Connect
     #   resp.file_name #=> String
     #   resp.file_size_in_bytes #=> Integer
     #   resp.associated_resource_arn #=> String
-    #   resp.file_use_case_type #=> String, one of "CONTACT_ANALYSIS", "EMAIL_MESSAGE", "EMAIL_MESSAGE_PLAIN_TEXT", "EMAIL_MESSAGE_REDACTED", "EMAIL_MESSAGE_PLAIN_TEXT_REDACTED", "ATTACHMENT"
+    #   resp.file_use_case_type #=> String, one of "CONTACT_ANALYSIS", "EMAIL_MESSAGE", "EMAIL_MESSAGE_PLAIN_TEXT", "EMAIL_MESSAGE_REDACTED", "EMAIL_MESSAGE_PLAIN_TEXT_REDACTED", "ATTACHMENT", "VOICE_RECORDING"
     #   resp.created_by.connect_user_arn #=> String
     #   resp.created_by.aws_identity_arn #=> String
     #   resp.download_url_metadata.url #=> String
@@ -11466,6 +11666,74 @@ module Aws::Connect
       req.send_request(options)
     end
 
+    # Retrieves the status and results of a validation process started by
+    # [StartEvaluationFormValidation][1]. Returns the current execution
+    # status (`IN_PROGRESS`, `COMPLETED`, or `FAILED`), the validated form
+    # version, and when completed, a list of findings that identify
+    # structural issues and quality improvements for the evaluation form,
+    # and may include suggested fixes. If the validation failed, a reason is
+    # provided indicating the cause of the failure.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/connect/latest/APIReference/API_StartEvaluationFormValidation.html
+    #
+    # @option params [required, String] :instance_id
+    #   The identifier of the Connect Customer instance. You can [find the
+    #   instance ID][1] in the Amazon Resource Name (ARN) of the instance.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html
+    #
+    # @option params [required, String] :evaluation_form_id
+    #   The unique identifier for the evaluation form.
+    #
+    # @option params [Integer] :evaluation_form_version
+    #   The version of the evaluation form to retrieve validation results for.
+    #
+    # @return [Types::GetEvaluationFormValidationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetEvaluationFormValidationResponse#status #status} => String
+    #   * {Types::GetEvaluationFormValidationResponse#failure_reason #failure_reason} => String
+    #   * {Types::GetEvaluationFormValidationResponse#evaluation_form_id #evaluation_form_id} => String
+    #   * {Types::GetEvaluationFormValidationResponse#evaluation_form_version #evaluation_form_version} => Integer
+    #   * {Types::GetEvaluationFormValidationResponse#started_time #started_time} => Time
+    #   * {Types::GetEvaluationFormValidationResponse#findings #findings} => Array&lt;Types::EvaluationFormValidationFinding&gt;
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_evaluation_form_validation({
+    #     instance_id: "InstanceId", # required
+    #     evaluation_form_id: "ResourceId", # required
+    #     evaluation_form_version: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.status #=> String, one of "IN_PROGRESS", "COMPLETED", "FAILED"
+    #   resp.failure_reason #=> String
+    #   resp.evaluation_form_id #=> String
+    #   resp.evaluation_form_version #=> Integer
+    #   resp.started_time #=> Time
+    #   resp.findings #=> Array
+    #   resp.findings[0].issue_code #=> String
+    #   resp.findings[0].items #=> Array
+    #   resp.findings[0].items[0].ref_id #=> String
+    #   resp.findings[0].items[0].property #=> String
+    #   resp.findings[0].description #=> String
+    #   resp.findings[0].suggestion #=> String
+    #   resp.findings[0].severity #=> String, one of "WARNING", "ERROR"
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/GetEvaluationFormValidation AWS API Documentation
+    #
+    # @overload get_evaluation_form_validation(params = {})
+    # @param [Hash] params ({})
+    def get_evaluation_form_validation(params = {}, options = {})
+      req = build_request(:get_evaluation_form_validation, params)
+      req.send_request(options)
+    end
+
     # Supports SAML sign-in for Connect Customer. Retrieves a token for
     # federation. The token is for the Connect Customer user which
     # corresponds to the IAM credentials that were used to invoke this
@@ -12140,9 +12408,9 @@ module Aws::Connect
     #     for the `contact/segmentAttributes/connect:Subtype` filter key.
     #
     #   * `ROUTING_STEP_EXPRESSION` accepts a filter value up to 3,000
-    #     characters in length. This filter is case-sensitive and
-    #     order-sensitive. JSON string fields must be sorted in ascending
-    #     order, and JSON array order must be preserved.
+    #     characters in length. Filter values are case-sensitive. JSON object
+    #     key order and whitespace may be arbitrary; array order and tree
+    #     structure must be preserved.
     #
     #   * TRUE and FALSE are the only valid filter values for the
     #     `Q_CONNECT_ENABLED` filter key.
@@ -15222,6 +15490,9 @@ module Aws::Connect
     #   resp.evaluation_summary_list[0].score.not_applicable #=> Boolean
     #   resp.evaluation_summary_list[0].score.automatic_fail #=> Boolean
     #   resp.evaluation_summary_list[0].score.applied_weight #=> Float
+    #   resp.evaluation_summary_list[0].score.earned_points #=> Integer
+    #   resp.evaluation_summary_list[0].score.max_base_point #=> Integer
+    #   resp.evaluation_summary_list[0].score.performance_category #=> String, one of "NEEDS_IMPROVEMENT", "EXCEEDS_EXPECTATIONS"
     #   resp.evaluation_summary_list[0].acknowledgement.acknowledged_time #=> Time
     #   resp.evaluation_summary_list[0].acknowledgement.acknowledged_by #=> String
     #   resp.evaluation_summary_list[0].acknowledgement.acknowledger_comment #=> String
@@ -19588,6 +19859,55 @@ module Aws::Connect
     #           tag_value: "String",
     #         },
     #       },
+    #       contact_evaluation_attribute_filter: {
+    #         or_conditions: [
+    #           {
+    #             tag_conditions: [
+    #               {
+    #                 tag_key: "String",
+    #                 tag_value: "String",
+    #               },
+    #             ],
+    #             attribute_conditions: [
+    #               {
+    #                 attribute_key: "ContactAgentId", # accepts ContactAgentId
+    #                 attribute_value: {
+    #                   string_value: "String",
+    #                 },
+    #                 comparison_type: "EXACT", # accepts EXACT
+    #               },
+    #             ],
+    #           },
+    #         ],
+    #         and_condition: {
+    #           tag_conditions: [
+    #             {
+    #               tag_key: "String",
+    #               tag_value: "String",
+    #             },
+    #           ],
+    #           attribute_conditions: [
+    #             {
+    #               attribute_key: "ContactAgentId", # accepts ContactAgentId
+    #               attribute_value: {
+    #                 string_value: "String",
+    #               },
+    #               comparison_type: "EXACT", # accepts EXACT
+    #             },
+    #           ],
+    #         },
+    #         tag_condition: {
+    #           tag_key: "String",
+    #           tag_value: "String",
+    #         },
+    #         contact_evaluation_attribute_condition: {
+    #           attribute_key: "ContactAgentId", # accepts ContactAgentId
+    #           attribute_value: {
+    #             string_value: "String",
+    #           },
+    #           comparison_type: "EXACT", # accepts EXACT
+    #         },
+    #       },
     #     },
     #   })
     #
@@ -19615,6 +19935,9 @@ module Aws::Connect
     #   resp.evaluation_search_summary_list[0].metadata.review_id #=> String
     #   resp.evaluation_search_summary_list[0].metadata.contact_participant_role #=> String, one of "AGENT", "SYSTEM", "CUSTOM_BOT", "CUSTOMER"
     #   resp.evaluation_search_summary_list[0].metadata.contact_participant_id #=> String
+    #   resp.evaluation_search_summary_list[0].metadata.earned_points #=> Integer
+    #   resp.evaluation_search_summary_list[0].metadata.max_base_point #=> Integer
+    #   resp.evaluation_search_summary_list[0].metadata.performance_category #=> String, one of "NEEDS_IMPROVEMENT", "EXCEEDS_EXPECTATIONS"
     #   resp.evaluation_search_summary_list[0].status #=> String, one of "DRAFT", "SUBMITTED", "REVIEW_REQUESTED", "UNDER_REVIEW"
     #   resp.evaluation_search_summary_list[0].evaluation_type #=> String, one of "STANDARD", "CALIBRATION"
     #   resp.evaluation_search_summary_list[0].created_time #=> Time
@@ -22732,7 +23055,7 @@ module Aws::Connect
     #     file_name: "FileName", # required
     #     file_size_in_bytes: 1, # required
     #     url_expiry_in_seconds: 1,
-    #     file_use_case_type: "CONTACT_ANALYSIS", # required, accepts CONTACT_ANALYSIS, EMAIL_MESSAGE, EMAIL_MESSAGE_PLAIN_TEXT, EMAIL_MESSAGE_REDACTED, EMAIL_MESSAGE_PLAIN_TEXT_REDACTED, ATTACHMENT
+    #     file_use_case_type: "CONTACT_ANALYSIS", # required, accepts CONTACT_ANALYSIS, EMAIL_MESSAGE, EMAIL_MESSAGE_PLAIN_TEXT, EMAIL_MESSAGE_REDACTED, EMAIL_MESSAGE_PLAIN_TEXT_REDACTED, ATTACHMENT, VOICE_RECORDING
     #     associated_resource_arn: "ARN", # required
     #     created_by: {
     #       connect_user_arn: "ARN",
@@ -22995,6 +23318,98 @@ module Aws::Connect
       req.send_request(options)
     end
 
+    # Starts a Contact Lens post-call analytics job for the specified
+    # contact. This API runs Conversational Analytics post-contact analysis
+    # on a voice recording that is already attached to the contact,
+    # generating transcription, sentiment analysis, redaction, and
+    # summarization results based on the provided configuration.
+    #
+    # A voice recording must already be attached to the contact before
+    # calling this API. Use `CreateAttachedFile` to attach a recording from
+    # an S3 source URI.
+    #
+    # <note markdown="1"> For example, you can call `CreateContact`, then `CreateAttachedFile`,
+    # then `StartContactConversationalAnalyticsJob` to create a contact,
+    # attach a recording, and run post-call analytics.
+    #
+    #  </note>
+    #
+    # @option params [required, String] :instance_id
+    #   The identifier of the Connect Customer instance. You can [find the
+    #   instance ID][1] in the Amazon Resource Name (ARN) of the instance.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html
+    #
+    # @option params [required, String] :contact_id
+    #   The identifier of the contact in this instance of Connect Customer.
+    #
+    # @option params [required, Array<String>] :analytics_modes
+    #   The analytics modes to run for the contact. Valid values:
+    #   `PostContact`.
+    #
+    # @option params [required, Types::AnalyticsConfiguration] :analytics_configuration
+    #   The configuration for the conversational analytics job.
+    #
+    # @option params [String] :client_token
+    #   A unique, case-sensitive identifier that you provide to ensure the
+    #   idempotency of the request. If not provided, the Amazon Web Services
+    #   SDK populates this field. For more information about idempotency, see
+    #   [Making retries safe with idempotent APIs][1].
+    #
+    #
+    #
+    #   [1]: https://aws.amazon.com/builders-library/making-retries-safe-with-idempotent-APIs/
+    #
+    # @return [Types::StartContactConversationalAnalyticsJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::StartContactConversationalAnalyticsJobResponse#instance_id #instance_id} => String
+    #   * {Types::StartContactConversationalAnalyticsJobResponse#contact_id #contact_id} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.start_contact_conversational_analytics_job({
+    #     instance_id: "InstanceId", # required
+    #     contact_id: "ContactId", # required
+    #     analytics_modes: ["PostContact"], # required, accepts PostContact, RealTime, ContactLens, AutomatedInteraction
+    #     analytics_configuration: { # required
+    #       language_configuration: { # required
+    #         language_locale: "LanguageLocale",
+    #       },
+    #       redaction_configuration: { # required
+    #         behavior: "Enable", # required, accepts Enable, Disable
+    #         policy: "None", # required, accepts None, RedactedOnly, RedactedAndOriginal
+    #         entities: ["Entity"],
+    #         mask_mode: "PII", # accepts PII, EntityType
+    #       },
+    #       sentiment_configuration: { # required
+    #         behavior: "Enable", # required, accepts Enable, Disable
+    #       },
+    #       summary_configuration: { # required
+    #         summary_modes: ["PostContact"], # required, accepts PostContact, AutomatedInteraction, ContactChain
+    #       },
+    #       rules_configuration: { # required
+    #         behavior: "Enable", # accepts Enable, Disable
+    #       },
+    #     },
+    #     client_token: "ClientToken",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.instance_id #=> String
+    #   resp.contact_id #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/StartContactConversationalAnalyticsJob AWS API Documentation
+    #
+    # @overload start_contact_conversational_analytics_job(params = {})
+    # @param [Hash] params ({})
+    def start_contact_conversational_analytics_job(params = {}, options = {})
+      req = build_request(:start_contact_conversational_analytics_job, params)
+      req.send_request(options)
+    end
+
     # Starts an empty evaluation in the specified Connect Customer instance,
     # using the given evaluation form for the particular contact. The
     # evaluation form version used for the contact evaluation corresponds to
@@ -23450,6 +23865,62 @@ module Aws::Connect
       req.send_request(options)
     end
 
+    # Starts an asynchronous validation process for an evaluation form
+    # version in the specified Connect Customer instance. The validation
+    # first performs structural checks on the form content (such as
+    # verifying required fields, valid scoring configuration, and correct
+    # conditional logic), then asynchronously analyzes questions configured
+    # for generative AI evaluation against a set of best practices. Use
+    # [GetEvaluationFormValidation][1] to retrieve the status and results
+    # once the validation completes.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/connect/latest/APIReference/API_GetEvaluationFormValidation.html
+    #
+    # @option params [required, String] :instance_id
+    #   The identifier of the Connect Customer instance. You can [find the
+    #   instance ID][1] in the Amazon Resource Name (ARN) of the instance.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html
+    #
+    # @option params [required, String] :evaluation_form_id
+    #   The unique identifier for the evaluation form.
+    #
+    # @option params [required, Integer] :evaluation_form_version
+    #   The version of the evaluation form to validate.
+    #
+    # @return [Types::StartEvaluationFormValidationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::StartEvaluationFormValidationResponse#evaluation_form_id #evaluation_form_id} => String
+    #   * {Types::StartEvaluationFormValidationResponse#evaluation_form_arn #evaluation_form_arn} => String
+    #   * {Types::StartEvaluationFormValidationResponse#evaluation_form_version #evaluation_form_version} => Integer
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.start_evaluation_form_validation({
+    #     instance_id: "InstanceId", # required
+    #     evaluation_form_id: "ResourceId", # required
+    #     evaluation_form_version: 1, # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.evaluation_form_id #=> String
+    #   resp.evaluation_form_arn #=> String
+    #   resp.evaluation_form_version #=> Integer
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/StartEvaluationFormValidation AWS API Documentation
+    #
+    # @overload start_evaluation_form_validation(params = {})
+    # @param [Hash] params ({})
+    def start_evaluation_form_validation(params = {}, options = {})
+      req = build_request(:start_evaluation_form_validation, params)
+      req.send_request(options)
+    end
+
     # Initiates a new outbound SMS or WhatsApp contact to a customer.
     # Response of this API provides the `ContactId` of the outbound SMS or
     # WhatsApp contact created.
@@ -26344,6 +26815,14 @@ module Aws::Connect
     #             # recursive EvaluationFormItemsList
     #           },
     #           weight: 1.0,
+    #           is_excluded_from_scoring: false,
+    #           score_thresholds: [
+    #             {
+    #               performance_category: "NEEDS_IMPROVEMENT", # required, accepts NEEDS_IMPROVEMENT, EXCEEDS_EXPECTATIONS
+    #               min_score_percentage: 1.0,
+    #               max_score_percentage: 1.0,
+    #             },
+    #           ],
     #         },
     #         question: {
     #           title: "EvaluationFormQuestionTitle", # required
@@ -26364,6 +26843,10 @@ module Aws::Connect
     #                   automatic_fail_configuration: {
     #                     target_section: "ReferenceId",
     #                   },
+    #                   points_configuration: {
+    #                     point_value: 1, # required
+    #                     is_bonus: false,
+    #                   },
     #                 },
     #               ],
     #               automation: {
@@ -26385,6 +26868,10 @@ module Aws::Connect
     #                   automatic_fail_configuration: {
     #                     target_section: "ReferenceId",
     #                   },
+    #                   points_configuration: {
+    #                     point_value: 1, # required
+    #                     is_bonus: false,
+    #                   },
     #                 },
     #               ],
     #               display_as: "DROPDOWN", # accepts DROPDOWN, RADIO
@@ -26416,6 +26903,15 @@ module Aws::Connect
     #                 {
     #                   ref_id: "ReferenceId", # required
     #                   text: "EvaluationFormMultiSelectQuestionOptionText", # required
+    #                   score: 1,
+    #                   automatic_fail: false,
+    #                   automatic_fail_configuration: {
+    #                     target_section: "ReferenceId",
+    #                   },
+    #                   points_configuration: {
+    #                     point_value: 1, # required
+    #                     is_bonus: false,
+    #                   },
     #                 },
     #               ],
     #               display_as: "DROPDOWN", # accepts DROPDOWN, CHECKBOX
@@ -26464,12 +26960,34 @@ module Aws::Connect
     #             default_action: "DISABLE", # accepts DISABLE, ENABLE
     #           },
     #           weight: 1.0,
+    #           scoring_configuration: {
+    #             points_configuration: {
+    #               max_point_value: 1,
+    #               min_point_value: 1,
+    #               is_bonus: false,
+    #             },
+    #             is_excluded_from_scoring: false,
+    #             score_thresholds: [
+    #               {
+    #                 performance_category: "NEEDS_IMPROVEMENT", # required, accepts NEEDS_IMPROVEMENT, EXCEEDS_EXPECTATIONS
+    #                 min_score_percentage: 1.0,
+    #                 max_score_percentage: 1.0,
+    #               },
+    #             ],
+    #           },
     #         },
     #       },
     #     ],
     #     scoring_strategy: {
-    #       mode: "QUESTION_ONLY", # required, accepts QUESTION_ONLY, SECTION_ONLY
+    #       mode: "QUESTION_ONLY", # required, accepts QUESTION_ONLY, SECTION_ONLY, POINTS_BASED
     #       status: "ENABLED", # required, accepts ENABLED, DISABLED
+    #       score_thresholds: [
+    #         {
+    #           performance_category: "NEEDS_IMPROVEMENT", # required, accepts NEEDS_IMPROVEMENT, EXCEEDS_EXPECTATIONS
+    #           min_score_percentage: 1.0,
+    #           max_score_percentage: 1.0,
+    #         },
+    #       ],
     #     },
     #     auto_evaluation_configuration: {
     #       enabled: false, # required
@@ -29223,7 +29741,7 @@ module Aws::Connect
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-connect'
-      context[:gem_version] = '1.259.0'
+      context[:gem_version] = '1.261.0'
       Seahorse::Client::Request.new(handlers, context)
     end