aws-sdk-connect 1.220.0 → 1.221.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 31621736ca1416962a6bca7223848f4cd6a58175c4682691c41ae0a7e1516d06
-  data.tar.gz: 9855a0362076146218b3e5364e1c4fe780ee78b92ab7b3d96bb623049aed9599
+  metadata.gz: ab08ce1849ecbc797a5895f4d941ad25fb4e3526e1134afe3f3e360ad8b0b40f
+  data.tar.gz: 45d31372bb834c7358ee2731c5787590530a06e58cbc5a4877aaaf8707e6b05e
 SHA512:
-  metadata.gz: 70965ec551adfc0491d81f6abe123f7d61f4dd590ae5ff27c02cfc272ea63b95538fae1e00650858eb7ca5fddc73be9d3f447857468067fb946be9fd9b830d07
-  data.tar.gz: 88d0516c625fd823df4f780b59dabff09bb1fccabcd836d2727fac9374ef052a58e1d34c136dc4ac2f1930acf1e126fca283bc2aa1efb4a7cc61645c5baa0e21
+  metadata.gz: 64b9ef9b6db2fd003e6b2fef98199242a82a661076737ce749a87a7927ba7d9cf7602ed12732819bed4c259e1d0283d4447e5a3cbd8675808832af38edd37749
+  data.tar.gz: 0d8e98afdc7d1d9da4a318993db4076b6b7737668f50d1cabde77ada302a7e71286d87adab118a7219cfc9abb4518475e1f0f6a64285eeaf5a58475314d0cdc5

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.221.0 (2025-10-22)
+------------------
+
+* Feature - This release added support for email address alias configuration and outbound campaign preview mode.
+
 1.220.0 (2025-10-21)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.220.0
+1.221.0

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

@@ -801,6 +801,134 @@ module Aws::Connect
       req.send_request(options)
     end
 
+    # Associates an email address alias with an existing email address in an
+    # Amazon Connect instance. This creates a forwarding relationship where
+    # emails sent to the alias email address are automatically forwarded to
+    # the primary email address.
+    #
+    # **Use cases**
+    #
+    # Following are common uses cases for this API:
+    #
+    # * **Unified customer support**: Create multiple entry points (for
+    #   example, support@example.com, help@example.com,
+    #   customercare@example.com) that all forward to a single agent queue
+    #   for streamlined management.
+    #
+    # * **Department consolidation**: Forward emails from legacy department
+    #   addresses (for example, sales@example.com, info@example.com) to a
+    #   centralized customer service email during organizational
+    #   restructuring.
+    #
+    # * **Brand management**: Enable you to use familiar brand-specific
+    #   email addresses that forward to the appropriate Amazon Connect
+    #   instance email address.
+    #
+    # **Important things to know**
+    #
+    # * Each email address can have a maximum of one alias. You cannot
+    #   create multiple aliases for the same email address.
+    #
+    # * If the alias email address already receives direct emails, it
+    #   continues to receive direct emails plus forwarded emails.
+    #
+    # * You cannot chain email aliases together (that is, create an alias of
+    #   an alias).
+    #
+    # `AssociateEmailAddressAlias` does not return the following
+    # information:
+    #
+    # * A confirmation of the alias relationship details (you must call
+    #   [DescribeEmailAddress][1] to verify).
+    #
+    # * The timestamp of when the association occurred.
+    #
+    # * The status of the forwarding configuration.
+    #
+    # **Endpoints**: See [Amazon Connect endpoints and quotas][2].
+    #
+    # **Related operations**
+    #
+    # * [DisassociateEmailAddressAlias][3]: Removes the alias association
+    #   between two email addresses in an Amazon Connect instance.
+    #
+    # * [DescribeEmailAddress][1]: View current alias configurations for an
+    #   email address.
+    #
+    # * [SearchEmailAddresses][4]: Find email addresses and their alias
+    #   relationships across an instance.
+    #
+    # * [CreateEmailAddress][5]: Create new email addresses that can
+    #   participate in alias relationships.
+    #
+    # * [DeleteEmailAddress][6]: Remove email addresses (automatically
+    #   removes any alias relationships).
+    #
+    # * [UpdateEmailAddressMetadata][7]: Modify email address properties
+    #   (does not affect alias relationships).
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeEmailAddress.html
+    # [2]: https://docs.aws.amazon.com/general/latest/gr/connect_region.html
+    # [3]: https://docs.aws.amazon.com/connect/latest/APIReference/API_DisassociateEmailAddressAlias.html
+    # [4]: https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchEmailAddresses.html
+    # [5]: https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateEmailAddress.html
+    # [6]: https://docs.aws.amazon.com/connect/latest/APIReference/API_DeleteEmailAddress.html
+    # [7]: https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateEmailAddressMetadata.html
+    #
+    # @option params [required, String] :email_address_id
+    #   The identifier of the email address.
+    #
+    # @option params [required, String] :instance_id
+    #   The identifier of the Amazon Connect 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, Types::AliasConfiguration] :alias_configuration
+    #   Configuration object that specifies which email address will serve as
+    #   the alias. The specified email address must already exist in the
+    #   Amazon Connect instance and cannot already be configured as an alias
+    #   or have an alias of its own.
+    #
+    # @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/
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.associate_email_address_alias({
+    #     email_address_id: "EmailAddressId", # required
+    #     instance_id: "InstanceId", # required
+    #     alias_configuration: { # required
+    #       email_address_id: "EmailAddressId", # required
+    #     },
+    #     client_token: "ClientToken",
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/AssociateEmailAddressAlias AWS API Documentation
+    #
+    # @overload associate_email_address_alias(params = {})
+    # @param [Hash] params ({})
+    def associate_email_address_alias(params = {}, options = {})
+      req = build_request(:associate_email_address_alias, params)
+      req.send_request(options)
+    end
+
     # Associates a connect resource to a flow.
     #
     # @option params [required, String] :instance_id
@@ -1617,6 +1745,19 @@ module Aws::Connect
     #         campaign: {
     #           campaign_id: "CampaignId",
     #         },
+    #         outbound_strategy: {
+    #           type: "AGENT_FIRST", # required, accepts AGENT_FIRST
+    #           config: {
+    #             agent_first: {
+    #               preview: {
+    #                 post_accept_timeout_config: { # required
+    #                   duration_in_seconds: 1, # required
+    #                 },
+    #                 allowed_user_actions: ["CALL"], # required, accepts CALL, DISCARD
+    #               },
+    #             },
+    #           },
+    #         },
     #       },
     #     ],
     #   })
@@ -1628,7 +1769,7 @@ module Aws::Connect
     #   resp.successful_request_list[0].contact_id #=> String
     #   resp.failed_request_list #=> Array
     #   resp.failed_request_list[0].request_identifier #=> String
-    #   resp.failed_request_list[0].failure_reason_code #=> String, one of "INVALID_ATTRIBUTE_KEY", "INVALID_CUSTOMER_ENDPOINT", "INVALID_SYSTEM_ENDPOINT", "INVALID_QUEUE", "MISSING_CAMPAIGN", "MISSING_CUSTOMER_ENDPOINT", "MISSING_QUEUE_ID_AND_SYSTEM_ENDPOINT", "REQUEST_THROTTLED", "IDEMPOTENCY_EXCEPTION", "INTERNAL_ERROR"
+    #   resp.failed_request_list[0].failure_reason_code #=> String, one of "INVALID_ATTRIBUTE_KEY", "INVALID_CUSTOMER_ENDPOINT", "INVALID_SYSTEM_ENDPOINT", "INVALID_QUEUE", "INVALID_OUTBOUND_STRATEGY", "MISSING_CAMPAIGN", "MISSING_CUSTOMER_ENDPOINT", "MISSING_QUEUE_ID_AND_SYSTEM_ENDPOINT", "REQUEST_THROTTLED", "IDEMPOTENCY_EXCEPTION", "INTERNAL_ERROR"
     #   resp.failed_request_list[0].failure_reason_message #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/BatchPutContact AWS API Documentation
@@ -5464,8 +5605,8 @@ module Aws::Connect
     end
 
     # This API is in preview release for Amazon Connect and is subject to
-    # change. To request access to this API, contact Amazon Web Services
-    # Support.
+    # change. To request access to this API, contact Amazon Web
+    # ServicesSupport.
     #
     # Describes the target authentication profile.
     #
@@ -5593,6 +5734,8 @@ module Aws::Connect
     #   resp.contact.queue_info.id #=> String
     #   resp.contact.queue_info.enqueue_timestamp #=> Time
     #   resp.contact.agent_info.id #=> String
+    #   resp.contact.agent_info.accepted_by_agent_timestamp #=> Time
+    #   resp.contact.agent_info.preview_end_timestamp #=> Time
     #   resp.contact.agent_info.connected_to_agent_timestamp #=> Time
     #   resp.contact.agent_info.agent_pause_duration_in_seconds #=> Integer
     #   resp.contact.agent_info.hierarchy_groups.level_1.arn #=> String
@@ -5741,6 +5884,10 @@ module Aws::Connect
     #   resp.contact.task_template_info.name #=> String
     #   resp.contact.contact_details.name #=> String
     #   resp.contact.contact_details.description #=> String
+    #   resp.contact.outbound_strategy.type #=> String, one of "AGENT_FIRST"
+    #   resp.contact.outbound_strategy.config.agent_first.preview.post_accept_timeout_config.duration_in_seconds #=> Integer
+    #   resp.contact.outbound_strategy.config.agent_first.preview.allowed_user_actions #=> Array
+    #   resp.contact.outbound_strategy.config.agent_first.preview.allowed_user_actions[0] #=> String, one of "CALL", "DISCARD"
     #   resp.contact.attributes #=> Hash
     #   resp.contact.attributes["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
     #
@@ -5993,6 +6140,7 @@ module Aws::Connect
     #   * {Types::DescribeEmailAddressResponse#description #description} => String
     #   * {Types::DescribeEmailAddressResponse#create_timestamp #create_timestamp} => String
     #   * {Types::DescribeEmailAddressResponse#modified_timestamp #modified_timestamp} => String
+    #   * {Types::DescribeEmailAddressResponse#alias_configurations #alias_configurations} => Array&lt;Types::AliasConfiguration&gt;
     #   * {Types::DescribeEmailAddressResponse#tags #tags} => Hash&lt;String,String&gt;
     #
     # @example Request syntax with placeholder values
@@ -6011,6 +6159,8 @@ module Aws::Connect
     #   resp.description #=> String
     #   resp.create_timestamp #=> String
     #   resp.modified_timestamp #=> String
+    #   resp.alias_configurations #=> Array
+    #   resp.alias_configurations[0].email_address_id #=> String
     #   resp.tags #=> Hash
     #   resp.tags["TagKey"] #=> String
     #
@@ -7335,6 +7485,134 @@ module Aws::Connect
       req.send_request(options)
     end
 
+    # Removes the alias association between two email addresses in an Amazon
+    # Connect instance. After disassociation, emails sent to the former
+    # alias email address are no longer forwarded to the primary email
+    # address. Both email addresses continue to exist independently and can
+    # receive emails directly.
+    #
+    # **Use cases**
+    #
+    # Following are common uses cases for this API:
+    #
+    # * **Department separation**: Remove alias relationships when splitting
+    #   a consolidated support queue back into separate department-specific
+    #   queues.
+    #
+    # * **Email address retirement**: Cleanly remove forwarding
+    #   relationships before decommissioning old email addresses.
+    #
+    # * **Organizational restructuring**: Reconfigure email routing when
+    #   business processes change and aliases are no longer needed.
+    #
+    # **Important things to know**
+    #
+    # * Concurrent operations: This API uses distributed locking, so
+    #   concurrent operations on the same email addresses may be temporarily
+    #   blocked.
+    #
+    # * Emails sent to the former alias address are still delivered directly
+    #   to that address if it exists.
+    #
+    # * You do not need to delete the email addresses after disassociation.
+    #   Both addresses remain active independently.
+    #
+    # * After a successful disassociation, you can immediately create a new
+    #   alias relationship with the same addresses.
+    #
+    # * 200 status means alias was successfully disassociated.
+    #
+    # `DisassociateEmailAddressAlias` does not return the following
+    # information:
+    #
+    # * Details in the response about the email that was disassociated. The
+    #   response returns an empty body.
+    #
+    # * The timestamp of when the disassociation occurred.
+    #
+    # **Endpoints**: See [Amazon Connect endpoints and quotas][1].
+    #
+    # **Related operations**
+    #
+    # * [AssociateEmailAddressAlias][2]: Associates an email address alias
+    #   with an existing email address in an Amazon Connect instance.
+    #
+    # * [DescribeEmailAddress][3]: View current alias configurations for an
+    #   email address.
+    #
+    # * [SearchEmailAddresses][4]: Find email addresses and their alias
+    #   relationships across an instance.
+    #
+    # * [CreateEmailAddress][5]: Create new email addresses that can
+    #   participate in alias relationships.
+    #
+    # * [DeleteEmailAddress][6]: Remove email addresses (automatically
+    #   removes any alias relationships).
+    #
+    # * [UpdateEmailAddressMetadata][7]: Modify email address properties
+    #   (does not affect alias relationships).
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/general/latest/gr/connect_region.html
+    # [2]: https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateEmailAddressAlias.html
+    # [3]: https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeEmailAddress.html
+    # [4]: https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchEmailAddresses.html
+    # [5]: https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateEmailAddress.html
+    # [6]: https://docs.aws.amazon.com/connect/latest/APIReference/API_DeleteEmailAddress.html
+    # [7]: https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateEmailAddressMetadata.html
+    #
+    # @option params [required, String] :email_address_id
+    #   The identifier of the email address.
+    #
+    # @option params [required, String] :instance_id
+    #   The identifier of the Amazon Connect 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, Types::AliasConfiguration] :alias_configuration
+    #   Configuration object that specifies which alias relationship to
+    #   remove. The alias association must currently exist between the primary
+    #   email address and the specified alias email address.
+    #
+    # @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/
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.disassociate_email_address_alias({
+    #     email_address_id: "EmailAddressId", # required
+    #     instance_id: "InstanceId", # required
+    #     alias_configuration: { # required
+    #       email_address_id: "EmailAddressId", # required
+    #     },
+    #     client_token: "ClientToken",
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/DisassociateEmailAddressAlias AWS API Documentation
+    #
+    # @overload disassociate_email_address_alias(params = {})
+    # @param [Hash] params ({})
+    def disassociate_email_address_alias(params = {}, options = {})
+      req = build_request(:disassociate_email_address_alias, params)
+      req.send_request(options)
+    end
+
     # Disassociates a connect resource from a flow.
     #
     # @option params [required, String] :instance_id
@@ -11069,7 +11347,7 @@ module Aws::Connect
     # service level quota of 99 phone numbers, and in any 180 day period you
     # release 99, claim 99, and then release 99, you will have exceeded the
     # 200% limit. At that point you are blocked from claiming any more
-    # numbers until you open an Amazon Web Services Support ticket.
+    # numbers until you open an Amazon Web ServicesSupport ticket.
     #
     #
     #
@@ -11413,8 +11691,8 @@ module Aws::Connect
     end
 
     # This API is in preview release for Amazon Connect and is subject to
-    # change. To request access to this API, contact Amazon Web Services
-    # Support.
+    # change. To request access to this API, contact Amazon Web
+    # ServicesSupport.
     #
     # Provides summary information about the authentication profiles in a
     # specified Amazon Connect instance.
@@ -14390,7 +14668,7 @@ module Aws::Connect
     #  After releasing a phone number, the phone number enters into a
     # cooldown period for up to 180 days. It cannot be searched for or
     # claimed again until the period has ended. If you accidentally release
-    # a phone number, contact Amazon Web Services Support.
+    # a phone number, contact Amazon Web ServicesSupport.
     #
     # If you plan to claim and release numbers frequently, contact us for a
     # service quota exception. Otherwise, it is possible you will be blocked
@@ -15268,6 +15546,8 @@ module Aws::Connect
     #   resp.email_addresses[0].email_address #=> String
     #   resp.email_addresses[0].description #=> String
     #   resp.email_addresses[0].display_name #=> String
+    #   resp.email_addresses[0].alias_configurations #=> Array
+    #   resp.email_addresses[0].alias_configurations[0].email_address_id #=> String
     #   resp.approximate_total_count #=> Integer
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/SearchEmailAddresses AWS API Documentation
@@ -16982,8 +17262,8 @@ module Aws::Connect
     #
     # If you use the `ChatDurationInMinutes` parameter and receive a 400
     # error, your account may not support the ability to configure custom
-    # chat durations. For more information, contact Amazon Web Services
-    # Support.
+    # chat durations. For more information, contact Amazon Web
+    # ServicesSupport.
     #
     # For more information about chat, see the following topics in the
     # *Amazon Connect Administrator Guide*:
@@ -17984,6 +18264,9 @@ module Aws::Connect
     #   Use `CAMPAIGN` if `EnableAnswerMachineDetection` is set to `true`. For
     #   all other cases, use `GENERAL`.
     #
+    # @option params [Types::OutboundStrategy] :outbound_strategy
+    #   Information about the outbound strategy.
+    #
     # @return [Types::StartOutboundVoiceContactResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::StartOutboundVoiceContactResponse#contact_id #contact_id} => String
@@ -18018,6 +18301,19 @@ module Aws::Connect
     #     },
     #     campaign_id: "CampaignId",
     #     traffic_type: "GENERAL", # accepts GENERAL, CAMPAIGN
+    #     outbound_strategy: {
+    #       type: "AGENT_FIRST", # required, accepts AGENT_FIRST
+    #       config: {
+    #         agent_first: {
+    #           preview: {
+    #             post_accept_timeout_config: { # required
+    #               duration_in_seconds: 1, # required
+    #             },
+    #             allowed_user_actions: ["CALL"], # required, accepts CALL, DISCARD
+    #           },
+    #         },
+    #       },
+    #     },
     #   })
     #
     # @example Response structure
@@ -18475,7 +18771,14 @@ module Aws::Connect
     #
     # @option params [Types::DisconnectReason] :disconnect_reason
     #   The reason a contact can be disconnected. Only Amazon Connect outbound
-    #   campaigns can provide this field.
+    #   campaigns can provide this field. For a list and description of all
+    #   the possible disconnect reasons by channel (including outbound
+    #   campaign voice contacts) see DisconnectReason under
+    #   [ContactTraceRecord][1] in the *Amazon Connect Administrator Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/connect/latest/adminguide/ctr-data-model.html#ctr-ContactTraceRecord
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -19004,8 +19307,8 @@ module Aws::Connect
     end
 
     # This API is in preview release for Amazon Connect and is subject to
-    # change. To request access to this API, contact Amazon Web Services
-    # Support.
+    # change. To request access to this API, contact Amazon Web
+    # ServicesSupport.
     #
     # Updates the selected authentication profile.
     #
@@ -20108,7 +20411,7 @@ module Aws::Connect
     #   The type of attribute.
     #
     #   <note markdown="1"> Only allowlisted customers can consume USE\_CUSTOM\_TTS\_VOICES. To
-    #   access this feature, contact Amazon Web Services Support for
+    #   access this feature, contact Amazon Web ServicesSupport for
     #   allowlisting.
     #
     #    </note>
@@ -22078,7 +22381,7 @@ module Aws::Connect
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-connect'
-      context[:gem_version] = '1.220.0'
+      context[:gem_version] = '1.221.0'
       Seahorse::Client::Request.new(handlers, context)
     end