aws-sdk-connect 1.133.0 → 1.134.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: d0962bfa7dfc82b9a5d65f1071bac4fad48f57d948dc1322769fc7731ae4d455
4
- data.tar.gz: 4d77e3b49d33b079895b13207da5ac5c8ec62b98baf371328b83b6ef0d59d51b
3
+ metadata.gz: ce6fdd94a84dd02f31c43ba3dc9306abce8ccfcff6502d199db6bb651f74a752
4
+ data.tar.gz: 3ff5eba413b29c6f08c1c262f204b2146c223a2dc9fd9f6db355e711fba19ae8
5
5
  SHA512:
6
- metadata.gz: 91cb3394d0582441e8422e065a6231f9cd2e4864dd439299988640f002bb387e1de2979aec9fa302d6c59f9414d1da40148f2a7f2eb05e3a0ce4710afcfaa14d
7
- data.tar.gz: 812cee2541e4c2e935c0785fc9f64f62cecd910a64a1558589d81d45f23a66a2a57c8790d83facaf021e1083a2ab5767c965e90f11e9ad7cddd781a61e6ef431
6
+ metadata.gz: d8ab1d3ca621875c98780cfdf0e509a2e62f55d7243728368c8e08ac4870f688b7873bae980e788ecca6ed2c4f73d5538bcb56babac8a9f083b1f5a2de665d7d
7
+ data.tar.gz: 2f8b4105d238ea93efe9fae7dba69227dd5565e5e392739c4bc355430e0a41e1a30e3dfd169d4822ae7762e6ce77dc72172a2783fb0de0cb898860d49b2adcd8
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.134.0 (2023-11-03)
5
+ ------------------
6
+
7
+ * Feature - Amazon Connect Chat introduces Create Persistent Contact Association API, allowing customers to choose when to resume previous conversations from previous chats, eliminating the need to repeat themselves and allowing agents to provide personalized service with access to entire conversation history.
8
+
4
9
  1.133.0 (2023-11-02)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.133.0
1
+ 1.134.0
@@ -1704,6 +1704,131 @@ module Aws::Connect
1704
1704
  req.send_request(options)
1705
1705
  end
1706
1706
 
1707
+ # Enables rehydration of chats for the lifespan of a contact. For more
1708
+ # information about chat rehydration, see [Enable persistent chat][1] in
1709
+ # the *Amazon Connect Administrator Guide*.
1710
+ #
1711
+ #
1712
+ #
1713
+ # [1]: https://docs.aws.amazon.com/connect/latest/adminguide/chat-persistence.html
1714
+ #
1715
+ # @option params [required, String] :instance_id
1716
+ # The identifier of the Amazon Connect instance. You can [find the
1717
+ # instance ID][1] in the Amazon Resource Name (ARN) of the instance.
1718
+ #
1719
+ #
1720
+ #
1721
+ # [1]: https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html
1722
+ #
1723
+ # @option params [required, String] :initial_contact_id
1724
+ # This is the contactId of the current contact that the
1725
+ # `CreatePersistentContactAssociation` API is being called from.
1726
+ #
1727
+ # @option params [required, String] :rehydration_type
1728
+ # The contactId chosen for rehydration depends on the type chosen.
1729
+ #
1730
+ # * `ENTIRE_PAST_SESSION`: Rehydrates a chat from the most recently
1731
+ # terminated past chat contact of the specified past ended chat
1732
+ # session. To use this type, provide the `initialContactId` of the
1733
+ # past ended chat session in the `sourceContactId` field. In this
1734
+ # type, Amazon Connect determines what the most recent chat contact on
1735
+ # the past ended chat session and uses it to start a persistent chat.
1736
+ #
1737
+ # * `FROM_SEGMENT`: Rehydrates a chat from the specified past chat
1738
+ # contact provided in the `sourceContactId` field.
1739
+ #
1740
+ # The actual contactId used for rehydration is provided in the response
1741
+ # of this API.
1742
+ #
1743
+ # To illustrate how to use rehydration type, consider the following
1744
+ # example: A customer starts a chat session. Agent a1 accepts the chat
1745
+ # and a conversation starts between the customer and Agent a1. This
1746
+ # first contact creates a contact ID **C1**. Agent a1 then transfers the
1747
+ # chat to Agent a2. This creates another contact ID **C2**. At this
1748
+ # point Agent a2 ends the chat. The customer is forwarded to the
1749
+ # disconnect flow for a post chat survey that creates another contact ID
1750
+ # **C3**. After the chat survey, the chat session ends. Later, the
1751
+ # customer returns and wants to resume their past chat session. At this
1752
+ # point, the customer can have following use cases:
1753
+ #
1754
+ # * **Use Case 1**: The customer wants to continue the past chat session
1755
+ # but they want to hide the post chat survey. For this they will use
1756
+ # the following configuration:
1757
+ #
1758
+ # * **Configuration**
1759
+ #
1760
+ # * SourceContactId = "C2"
1761
+ #
1762
+ # * RehydrationType = "FROM\_SEGMENT"
1763
+ #
1764
+ # * **Expected behavior**
1765
+ #
1766
+ # * This starts a persistent chat session from the specified past
1767
+ # ended contact (C2). Transcripts of past chat sessions C2 and C1
1768
+ # are accessible in the current persistent chat session. Note that
1769
+ # chat segment C3 is dropped from the persistent chat session.
1770
+ #
1771
+ # ^
1772
+ #
1773
+ # * **Use Case 2**: The customer wants to continue the past chat session
1774
+ # and see the transcript of the entire past engagement, including the
1775
+ # post chat survey. For this they will use the following
1776
+ # configuration:
1777
+ #
1778
+ # * **Configuration**
1779
+ #
1780
+ # * SourceContactId = "C1"
1781
+ #
1782
+ # * RehydrationType = "ENTIRE\_PAST\_SESSION"
1783
+ #
1784
+ # * **Expected behavior**
1785
+ #
1786
+ # * This starts a persistent chat session from the most recently
1787
+ # ended chat contact (C3). Transcripts of past chat sessions C3,
1788
+ # C2 and C1 are accessible in the current persistent chat session.
1789
+ #
1790
+ # ^
1791
+ #
1792
+ # @option params [required, String] :source_contact_id
1793
+ # The contactId from which a persistent chat session must be started.
1794
+ #
1795
+ # @option params [String] :client_token
1796
+ # A unique, case-sensitive identifier that you provide to ensure the
1797
+ # idempotency of the request. If not provided, the Amazon Web Services
1798
+ # SDK populates this field. For more information about idempotency, see
1799
+ # [Making retries safe with idempotent APIs][1].
1800
+ #
1801
+ #
1802
+ #
1803
+ # [1]: https://aws.amazon.com/builders-library/making-retries-safe-with-idempotent-APIs/
1804
+ #
1805
+ # @return [Types::CreatePersistentContactAssociationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1806
+ #
1807
+ # * {Types::CreatePersistentContactAssociationResponse#continued_from_contact_id #continued_from_contact_id} => String
1808
+ #
1809
+ # @example Request syntax with placeholder values
1810
+ #
1811
+ # resp = client.create_persistent_contact_association({
1812
+ # instance_id: "InstanceId", # required
1813
+ # initial_contact_id: "ContactId", # required
1814
+ # rehydration_type: "ENTIRE_PAST_SESSION", # required, accepts ENTIRE_PAST_SESSION, FROM_SEGMENT
1815
+ # source_contact_id: "ContactId", # required
1816
+ # client_token: "ClientToken",
1817
+ # })
1818
+ #
1819
+ # @example Response structure
1820
+ #
1821
+ # resp.continued_from_contact_id #=> String
1822
+ #
1823
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/CreatePersistentContactAssociation AWS API Documentation
1824
+ #
1825
+ # @overload create_persistent_contact_association(params = {})
1826
+ # @param [Hash] params ({})
1827
+ def create_persistent_contact_association(params = {}, options = {})
1828
+ req = build_request(:create_persistent_contact_association, params)
1829
+ req.send_request(options)
1830
+ end
1831
+
1707
1832
  # Creates a prompt. For more information about prompts, such as
1708
1833
  # supported file types and maximum length, see [Create prompts][1] in
1709
1834
  # the *Amazon Connect Administrator's Guide*.
@@ -14078,7 +14203,7 @@ module Aws::Connect
14078
14203
  params: params,
14079
14204
  config: config)
14080
14205
  context[:gem_name] = 'aws-sdk-connect'
14081
- context[:gem_version] = '1.133.0'
14206
+ context[:gem_version] = '1.134.0'
14082
14207
  Seahorse::Client::Request.new(handlers, context)
14083
14208
  end
14084
14209
 
@@ -148,6 +148,8 @@ module Aws::Connect
148
148
  CreateIntegrationAssociationResponse = Shapes::StructureShape.new(name: 'CreateIntegrationAssociationResponse')
149
149
  CreateParticipantRequest = Shapes::StructureShape.new(name: 'CreateParticipantRequest')
150
150
  CreateParticipantResponse = Shapes::StructureShape.new(name: 'CreateParticipantResponse')
151
+ CreatePersistentContactAssociationRequest = Shapes::StructureShape.new(name: 'CreatePersistentContactAssociationRequest')
152
+ CreatePersistentContactAssociationResponse = Shapes::StructureShape.new(name: 'CreatePersistentContactAssociationResponse')
151
153
  CreatePromptRequest = Shapes::StructureShape.new(name: 'CreatePromptRequest')
152
154
  CreatePromptResponse = Shapes::StructureShape.new(name: 'CreatePromptResponse')
153
155
  CreateQueueRequest = Shapes::StructureShape.new(name: 'CreateQueueRequest')
@@ -1405,6 +1407,16 @@ module Aws::Connect
1405
1407
  CreateParticipantResponse.add_member(:participant_id, Shapes::ShapeRef.new(shape: ParticipantId, location_name: "ParticipantId"))
1406
1408
  CreateParticipantResponse.struct_class = Types::CreateParticipantResponse
1407
1409
 
1410
+ CreatePersistentContactAssociationRequest.add_member(:instance_id, Shapes::ShapeRef.new(shape: InstanceId, required: true, location: "uri", location_name: "InstanceId"))
1411
+ CreatePersistentContactAssociationRequest.add_member(:initial_contact_id, Shapes::ShapeRef.new(shape: ContactId, required: true, location: "uri", location_name: "InitialContactId"))
1412
+ CreatePersistentContactAssociationRequest.add_member(:rehydration_type, Shapes::ShapeRef.new(shape: RehydrationType, required: true, location_name: "RehydrationType"))
1413
+ CreatePersistentContactAssociationRequest.add_member(:source_contact_id, Shapes::ShapeRef.new(shape: ContactId, required: true, location_name: "SourceContactId"))
1414
+ CreatePersistentContactAssociationRequest.add_member(:client_token, Shapes::ShapeRef.new(shape: ClientToken, location_name: "ClientToken"))
1415
+ CreatePersistentContactAssociationRequest.struct_class = Types::CreatePersistentContactAssociationRequest
1416
+
1417
+ CreatePersistentContactAssociationResponse.add_member(:continued_from_contact_id, Shapes::ShapeRef.new(shape: ContactId, location_name: "ContinuedFromContactId"))
1418
+ CreatePersistentContactAssociationResponse.struct_class = Types::CreatePersistentContactAssociationResponse
1419
+
1408
1420
  CreatePromptRequest.add_member(:instance_id, Shapes::ShapeRef.new(shape: InstanceId, required: true, location: "uri", location_name: "InstanceId"))
1409
1421
  CreatePromptRequest.add_member(:name, Shapes::ShapeRef.new(shape: CommonNameLength127, required: true, location_name: "Name"))
1410
1422
  CreatePromptRequest.add_member(:description, Shapes::ShapeRef.new(shape: PromptDescription, location_name: "Description"))
@@ -4707,6 +4719,20 @@ module Aws::Connect
4707
4719
  o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
4708
4720
  end)
4709
4721
 
4722
+ api.add_operation(:create_persistent_contact_association, Seahorse::Model::Operation.new.tap do |o|
4723
+ o.name = "CreatePersistentContactAssociation"
4724
+ o.http_method = "POST"
4725
+ o.http_request_uri = "/contact/persistent-contact-association/{InstanceId}/{InitialContactId}"
4726
+ o.input = Shapes::ShapeRef.new(shape: CreatePersistentContactAssociationRequest)
4727
+ o.output = Shapes::ShapeRef.new(shape: CreatePersistentContactAssociationResponse)
4728
+ o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
4729
+ o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
4730
+ o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
4731
+ o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
4732
+ o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
4733
+ o.errors << Shapes::ShapeRef.new(shape: InternalServiceException)
4734
+ end)
4735
+
4710
4736
  api.add_operation(:create_prompt, Seahorse::Model::Operation.new.tap do |o|
4711
4737
  o.name = "CreatePrompt"
4712
4738
  o.http_method = "PUT"
@@ -320,6 +320,20 @@ module Aws::Connect
320
320
  end
321
321
  end
322
322
 
323
+ class CreatePersistentContactAssociation
324
+ def self.build(context)
325
+ unless context.config.regional_endpoint
326
+ endpoint = context.config.endpoint.to_s
327
+ end
328
+ Aws::Connect::EndpointParameters.new(
329
+ region: context.config.region,
330
+ use_dual_stack: context.config.use_dualstack_endpoint,
331
+ use_fips: context.config.use_fips_endpoint,
332
+ endpoint: endpoint,
333
+ )
334
+ end
335
+ end
336
+
323
337
  class CreatePrompt
324
338
  def self.build(context)
325
339
  unless context.config.regional_endpoint
@@ -100,6 +100,8 @@ module Aws::Connect
100
100
  Aws::Connect::Endpoints::CreateIntegrationAssociation.build(context)
101
101
  when :create_participant
102
102
  Aws::Connect::Endpoints::CreateParticipant.build(context)
103
+ when :create_persistent_contact_association
104
+ Aws::Connect::Endpoints::CreatePersistentContactAssociation.build(context)
103
105
  when :create_prompt
104
106
  Aws::Connect::Endpoints::CreatePrompt.build(context)
105
107
  when :create_queue
@@ -1945,6 +1945,129 @@ module Aws::Connect
1945
1945
  include Aws::Structure
1946
1946
  end
1947
1947
 
1948
+ # @!attribute [rw] instance_id
1949
+ # The identifier of the Amazon Connect instance. You can [find the
1950
+ # instance ID][1] in the Amazon Resource Name (ARN) of the instance.
1951
+ #
1952
+ #
1953
+ #
1954
+ # [1]: https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html
1955
+ # @return [String]
1956
+ #
1957
+ # @!attribute [rw] initial_contact_id
1958
+ # This is the contactId of the current contact that the
1959
+ # `CreatePersistentContactAssociation` API is being called from.
1960
+ # @return [String]
1961
+ #
1962
+ # @!attribute [rw] rehydration_type
1963
+ # The contactId chosen for rehydration depends on the type chosen.
1964
+ #
1965
+ # * `ENTIRE_PAST_SESSION`: Rehydrates a chat from the most recently
1966
+ # terminated past chat contact of the specified past ended chat
1967
+ # session. To use this type, provide the `initialContactId` of the
1968
+ # past ended chat session in the `sourceContactId` field. In this
1969
+ # type, Amazon Connect determines what the most recent chat contact
1970
+ # on the past ended chat session and uses it to start a persistent
1971
+ # chat.
1972
+ #
1973
+ # * `FROM_SEGMENT`: Rehydrates a chat from the specified past chat
1974
+ # contact provided in the `sourceContactId` field.
1975
+ #
1976
+ # The actual contactId used for rehydration is provided in the
1977
+ # response of this API.
1978
+ #
1979
+ # To illustrate how to use rehydration type, consider the following
1980
+ # example: A customer starts a chat session. Agent a1 accepts the chat
1981
+ # and a conversation starts between the customer and Agent a1. This
1982
+ # first contact creates a contact ID **C1**. Agent a1 then transfers
1983
+ # the chat to Agent a2. This creates another contact ID **C2**. At
1984
+ # this point Agent a2 ends the chat. The customer is forwarded to the
1985
+ # disconnect flow for a post chat survey that creates another contact
1986
+ # ID **C3**. After the chat survey, the chat session ends. Later, the
1987
+ # customer returns and wants to resume their past chat session. At
1988
+ # this point, the customer can have following use cases:
1989
+ #
1990
+ # * **Use Case 1**: The customer wants to continue the past chat
1991
+ # session but they want to hide the post chat survey. For this they
1992
+ # will use the following configuration:
1993
+ #
1994
+ # * **Configuration**
1995
+ #
1996
+ # * SourceContactId = "C2"
1997
+ #
1998
+ # * RehydrationType = "FROM\_SEGMENT"
1999
+ #
2000
+ # * **Expected behavior**
2001
+ #
2002
+ # * This starts a persistent chat session from the specified past
2003
+ # ended contact (C2). Transcripts of past chat sessions C2 and
2004
+ # C1 are accessible in the current persistent chat session. Note
2005
+ # that chat segment C3 is dropped from the persistent chat
2006
+ # session.
2007
+ #
2008
+ # ^
2009
+ #
2010
+ # * **Use Case 2**: The customer wants to continue the past chat
2011
+ # session and see the transcript of the entire past engagement,
2012
+ # including the post chat survey. For this they will use the
2013
+ # following configuration:
2014
+ #
2015
+ # * **Configuration**
2016
+ #
2017
+ # * SourceContactId = "C1"
2018
+ #
2019
+ # * RehydrationType = "ENTIRE\_PAST\_SESSION"
2020
+ #
2021
+ # * **Expected behavior**
2022
+ #
2023
+ # * This starts a persistent chat session from the most recently
2024
+ # ended chat contact (C3). Transcripts of past chat sessions C3,
2025
+ # C2 and C1 are accessible in the current persistent chat
2026
+ # session.
2027
+ #
2028
+ # ^
2029
+ # @return [String]
2030
+ #
2031
+ # @!attribute [rw] source_contact_id
2032
+ # The contactId from which a persistent chat session must be started.
2033
+ # @return [String]
2034
+ #
2035
+ # @!attribute [rw] client_token
2036
+ # A unique, case-sensitive identifier that you provide to ensure the
2037
+ # idempotency of the request. If not provided, the Amazon Web Services
2038
+ # SDK populates this field. For more information about idempotency,
2039
+ # see [Making retries safe with idempotent APIs][1].
2040
+ #
2041
+ #
2042
+ #
2043
+ # [1]: https://aws.amazon.com/builders-library/making-retries-safe-with-idempotent-APIs/
2044
+ # @return [String]
2045
+ #
2046
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/CreatePersistentContactAssociationRequest AWS API Documentation
2047
+ #
2048
+ class CreatePersistentContactAssociationRequest < Struct.new(
2049
+ :instance_id,
2050
+ :initial_contact_id,
2051
+ :rehydration_type,
2052
+ :source_contact_id,
2053
+ :client_token)
2054
+ SENSITIVE = []
2055
+ include Aws::Structure
2056
+ end
2057
+
2058
+ # @!attribute [rw] continued_from_contact_id
2059
+ # The contactId from which a persistent chat session is started. This
2060
+ # field is populated only for persistent chat.
2061
+ # @return [String]
2062
+ #
2063
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/CreatePersistentContactAssociationResponse AWS API Documentation
2064
+ #
2065
+ class CreatePersistentContactAssociationResponse < Struct.new(
2066
+ :continued_from_contact_id)
2067
+ SENSITIVE = []
2068
+ include Aws::Structure
2069
+ end
2070
+
1948
2071
  # @!attribute [rw] instance_id
1949
2072
  # The identifier of the Amazon Connect instance. You can [find the
1950
2073
  # instance ID][1] in the Amazon Resource Name (ARN) of the instance.
@@ -52,6 +52,6 @@ require_relative 'aws-sdk-connect/customizations'
52
52
  # @!group service
53
53
  module Aws::Connect
54
54
 
55
- GEM_VERSION = '1.133.0'
55
+ GEM_VERSION = '1.134.0'
56
56
 
57
57
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-connect
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.133.0
4
+ version: 1.134.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2023-11-02 00:00:00.000000000 Z
11
+ date: 2023-11-03 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core