aws-sdk-connect 1.260.0 → 1.262.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e9123e06afd4ef5305d84d5e7d17b631eb4c91ee3ed350f2c575834344ae9908
-  data.tar.gz: bca228fa3222172924bf0fcb29f133db6446d4b79b129993a03ef5949579f7cf
+  metadata.gz: 72e9571637c2a02269bebb7c9b825f20b4bedb2e073d173423ed7f3e24587066
+  data.tar.gz: 291ec48c56aa24f1bb3346c86a27f350c8895f729fe298f38b7e576f13545c8b
 SHA512:
-  metadata.gz: 80018bb2f16a9e9cee184f388cb0dddfd4a554a1456b2a46eaf39a3c9f851c11ec5fa026c02c07dd8c4b9137733041319c0a96e41ee59595edd1ca07ff606ca5
-  data.tar.gz: 9c7161f05dd703e1022b0e3881c8355ca9ede20b608be09d8fa4084dda4fde64752750192e5bf4c85327197bea3afcd55bf1d81ef3d12dcceb4655201d9fc155
+  metadata.gz: ca7fb4ed8c3da2a157fe1f3928b68aaf5795fecf5b17c54bf3eef6befe337cc8248101da44c74b18a4b6792ac6dbd186c25328307a6558f953455e9dc2723758
+  data.tar.gz: 2e6ca17c37b8196f1030b89631cbd2cfeeb59229fcb231b4c6a366a1f8074c15a16bf9c0ec9d55ec6e61f1d36d5abe8d3f44f9de29c24535cbaedb21e7a1eede

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.262.0 (2026-07-01)
+------------------
+
+* Feature - Adds a new Amazon Connect Service API, SendOutboundWebNotification, that delivers web notifications to end-customer chat widget sessions. Callable only by the Amazon Connect Outbound Campaigns service principal.
+
+1.261.0 (2026-06-30)
+------------------
+
+* Feature - Amazon Connect - Added CreateAttachedFile and StartContactConversationalAnalyticsJob APIs to import call recordings and run conversational analytics.
+
 1.260.0 (2026-06-19)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.260.0
+1.262.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
@@ -10914,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
@@ -22883,6 +22976,111 @@ module Aws::Connect
       req.send_request(options)
     end
 
+    # Sends an outbound web notification to a customer's web browser for
+    # outbound campaigns. For more information about outbound campaigns, see
+    # [Set up Connect Customer outbound campaigns][1].
+    #
+    # <note markdown="1"> Only the Connect Customer outbound campaigns service principal is
+    # allowed to assume a role in your account and call this API.
+    #
+    #  </note>
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/connect/latest/adminguide/enable-outbound-campaigns.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 [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] :browser_id
+    #   A unique identifier for the customer's web browser instance to which
+    #   the notification is being sent.
+    #
+    # @option params [required, String] :session_id
+    #   A unique identifier for the customer's web session to which the
+    #   notification is being sent.
+    #
+    # @option params [required, Time,DateTime,Date,Integer,String] :expires_at
+    #   The timestamp, in Unix epoch time format, at which the web
+    #   notification expires. After this time, the notification is no longer
+    #   delivered to the customer's browser.
+    #
+    # @option params [required, Types::WebNotificationSource] :source
+    #   The source of the web notification. A `SourceCampaign` object
+    #   identifies the campaign and outbound request that triggered this
+    #   notification.
+    #
+    # @option params [required, Types::WidgetDestination] :destination
+    #   The destination for the web notification, specifying the communication
+    #   widget that delivers the notification and the customer profile of the
+    #   recipient.
+    #
+    # @option params [required, Types::WebNotificationContent] :content
+    #   The content of the web notification, including the notification type,
+    #   the view to render, and any optional attributes used to populate it.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.send_outbound_web_notification({
+    #     instance_id: "InstanceId", # required
+    #     client_token: "ClientToken",
+    #     browser_id: "WebBrowserId", # required
+    #     session_id: "WebSessionId", # required
+    #     expires_at: Time.now, # required
+    #     source: { # required
+    #       source_campaign: { # required
+    #         campaign_id: "CampaignId",
+    #         outbound_request_id: "OutboundRequestId",
+    #       },
+    #     },
+    #     destination: { # required
+    #       widget_id: "WidgetId", # required
+    #       profile_id: "CustomerProfileId", # required
+    #     },
+    #     content: { # required
+    #       type: "WIDGET_VIEW", # required, accepts WIDGET_VIEW, WIDGET_ACTION
+    #       view_arn: "ViewArn",
+    #       attributes: {
+    #         recommender_config: {
+    #           domain_name: "PersonalizeDomainName", # required
+    #           recommender_name: "RecommenderName", # required
+    #           context: {
+    #             "RecommenderContextKey" => "RecommenderContextValue",
+    #           },
+    #         },
+    #       },
+    #     },
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/SendOutboundWebNotification AWS API Documentation
+    #
+    # @overload send_outbound_web_notification(params = {})
+    # @param [Hash] params ({})
+    def send_outbound_web_notification(params = {}, options = {})
+      req = build_request(:send_outbound_web_notification, params)
+      req.send_request(options)
+    end
+
     # Provides a pre-signed Amazon S3 URL in response for uploading your
     # content.
     #
@@ -22962,7 +23160,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",
@@ -23225,6 +23423,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
@@ -29556,7 +29846,7 @@ module Aws::Connect
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-connect'
-      context[:gem_version] = '1.260.0'
+      context[:gem_version] = '1.262.0'
       Seahorse::Client::Request.new(handlers, context)
     end