aws-sdk-connect 1.144.0 → 1.146.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -1013,6 +1013,43 @@ module Aws::Connect
1013
1013
  req.send_request(options)
1014
1014
  end
1015
1015
 
1016
+ # >Associates a set of proficiencies with a user.
1017
+ #
1018
+ # @option params [required, String] :instance_id
1019
+ # The identifier of the Amazon Connect instance. You can find the
1020
+ # instance ID in the Amazon Resource Name (ARN of the instance).
1021
+ #
1022
+ # @option params [required, String] :user_id
1023
+ # The identifier of the user account.
1024
+ #
1025
+ # @option params [required, Array<Types::UserProficiency>] :user_proficiencies
1026
+ # The proficiencies to associate with the user.
1027
+ #
1028
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1029
+ #
1030
+ # @example Request syntax with placeholder values
1031
+ #
1032
+ # resp = client.associate_user_proficiencies({
1033
+ # instance_id: "InstanceId", # required
1034
+ # user_id: "UserId", # required
1035
+ # user_proficiencies: [ # required
1036
+ # {
1037
+ # attribute_name: "PredefinedAttributeName", # required
1038
+ # attribute_value: "PredefinedAttributeStringValue", # required
1039
+ # level: 1.0, # required
1040
+ # },
1041
+ # ],
1042
+ # })
1043
+ #
1044
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/AssociateUserProficiencies AWS API Documentation
1045
+ #
1046
+ # @overload associate_user_proficiencies(params = {})
1047
+ # @param [Hash] params ({})
1048
+ def associate_user_proficiencies(params = {}, options = {})
1049
+ req = build_request(:associate_user_proficiencies, params)
1050
+ req.send_request(options)
1051
+ end
1052
+
1016
1053
  # This API is in preview release for Amazon Connect and is subject to
1017
1054
  # change.
1018
1055
  #
@@ -2133,6 +2170,40 @@ module Aws::Connect
2133
2170
  req.send_request(options)
2134
2171
  end
2135
2172
 
2173
+ # Creates a new predefined attribute for the specified Amazon Connect
2174
+ # instance.
2175
+ #
2176
+ # @option params [required, String] :instance_id
2177
+ # The identifier of the Amazon Connect instance. You can find the
2178
+ # instance ID in the Amazon Resource Name (ARN) of the instance.
2179
+ #
2180
+ # @option params [required, String] :name
2181
+ # The name of the predefined attribute.
2182
+ #
2183
+ # @option params [required, Types::PredefinedAttributeValues] :values
2184
+ # The values of the predefined attribute.
2185
+ #
2186
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2187
+ #
2188
+ # @example Request syntax with placeholder values
2189
+ #
2190
+ # resp = client.create_predefined_attribute({
2191
+ # instance_id: "InstanceId", # required
2192
+ # name: "PredefinedAttributeName", # required
2193
+ # values: { # required
2194
+ # string_list: ["PredefinedAttributeStringValue"],
2195
+ # },
2196
+ # })
2197
+ #
2198
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/CreatePredefinedAttribute AWS API Documentation
2199
+ #
2200
+ # @overload create_predefined_attribute(params = {})
2201
+ # @param [Hash] params ({})
2202
+ def create_predefined_attribute(params = {}, options = {})
2203
+ req = build_request(:create_predefined_attribute, params)
2204
+ req.send_request(options)
2205
+ end
2206
+
2136
2207
  # Creates a prompt. For more information about prompts, such as
2137
2208
  # supported file types and maximum length, see [Create prompts][1] in
2138
2209
  # the *Amazon Connect Administrator's Guide*.
@@ -3650,6 +3721,34 @@ module Aws::Connect
3650
3721
  req.send_request(options)
3651
3722
  end
3652
3723
 
3724
+ # Deletes a predefined attribute from the specified Amazon Connect
3725
+ # instance.
3726
+ #
3727
+ # @option params [required, String] :instance_id
3728
+ # The identifier of the Amazon Connect instance. You can find the
3729
+ # instance ID in the Amazon Resource Name (ARN) of the instance.
3730
+ #
3731
+ # @option params [required, String] :name
3732
+ # The name of the predefined attribute.
3733
+ #
3734
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
3735
+ #
3736
+ # @example Request syntax with placeholder values
3737
+ #
3738
+ # resp = client.delete_predefined_attribute({
3739
+ # instance_id: "InstanceId", # required
3740
+ # name: "PredefinedAttributeName", # required
3741
+ # })
3742
+ #
3743
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/DeletePredefinedAttribute AWS API Documentation
3744
+ #
3745
+ # @overload delete_predefined_attribute(params = {})
3746
+ # @param [Hash] params ({})
3747
+ def delete_predefined_attribute(params = {}, options = {})
3748
+ req = build_request(:delete_predefined_attribute, params)
3749
+ req.send_request(options)
3750
+ end
3751
+
3653
3752
  # Deletes a prompt.
3654
3753
  #
3655
3754
  # @option params [required, String] :instance_id
@@ -4214,6 +4313,8 @@ module Aws::Connect
4214
4313
  # resp.contact.scheduled_timestamp #=> Time
4215
4314
  # resp.contact.related_contact_id #=> String
4216
4315
  # resp.contact.wisdom_info.session_arn #=> String
4316
+ # resp.contact.queue_time_adjustment_seconds #=> Integer
4317
+ # resp.contact.queue_priority #=> Integer
4217
4318
  # resp.contact.tags #=> Hash
4218
4319
  # resp.contact.tags["ContactTagKey"] #=> String
4219
4320
  #
@@ -4766,6 +4867,44 @@ module Aws::Connect
4766
4867
  req.send_request(options)
4767
4868
  end
4768
4869
 
4870
+ # Describes a predefined attribute for the specified Amazon Connect
4871
+ # instance.
4872
+ #
4873
+ # @option params [required, String] :instance_id
4874
+ # The identifier of the Amazon Connect instance. You can find the
4875
+ # instance ID in the Amazon Resource Name (ARN) of the instance.
4876
+ #
4877
+ # @option params [required, String] :name
4878
+ # The name of the predefined attribute.
4879
+ #
4880
+ # @return [Types::DescribePredefinedAttributeResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4881
+ #
4882
+ # * {Types::DescribePredefinedAttributeResponse#predefined_attribute #predefined_attribute} => Types::PredefinedAttribute
4883
+ #
4884
+ # @example Request syntax with placeholder values
4885
+ #
4886
+ # resp = client.describe_predefined_attribute({
4887
+ # instance_id: "InstanceId", # required
4888
+ # name: "PredefinedAttributeName", # required
4889
+ # })
4890
+ #
4891
+ # @example Response structure
4892
+ #
4893
+ # resp.predefined_attribute.name #=> String
4894
+ # resp.predefined_attribute.values.string_list #=> Array
4895
+ # resp.predefined_attribute.values.string_list[0] #=> String
4896
+ # resp.predefined_attribute.last_modified_time #=> Time
4897
+ # resp.predefined_attribute.last_modified_region #=> String
4898
+ #
4899
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/DescribePredefinedAttribute AWS API Documentation
4900
+ #
4901
+ # @overload describe_predefined_attribute(params = {})
4902
+ # @param [Hash] params ({})
4903
+ def describe_predefined_attribute(params = {}, options = {})
4904
+ req = build_request(:describe_predefined_attribute, params)
4905
+ req.send_request(options)
4906
+ end
4907
+
4769
4908
  # Describes the prompt.
4770
4909
  #
4771
4910
  # @option params [required, String] :instance_id
@@ -5896,6 +6035,42 @@ module Aws::Connect
5896
6035
  req.send_request(options)
5897
6036
  end
5898
6037
 
6038
+ # Disassociates a set of proficiencies from a user.
6039
+ #
6040
+ # @option params [required, String] :instance_id
6041
+ # The identifier of the Amazon Connect instance. You can find the
6042
+ # instance ID in the Amazon Resource Name (ARN) of the instance.
6043
+ #
6044
+ # @option params [required, String] :user_id
6045
+ # The identifier of the user account.
6046
+ #
6047
+ # @option params [required, Array<Types::UserProficiencyDisassociate>] :user_proficiencies
6048
+ # The proficiencies to disassociate from the user.
6049
+ #
6050
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
6051
+ #
6052
+ # @example Request syntax with placeholder values
6053
+ #
6054
+ # resp = client.disassociate_user_proficiencies({
6055
+ # instance_id: "InstanceId", # required
6056
+ # user_id: "UserId", # required
6057
+ # user_proficiencies: [ # required
6058
+ # {
6059
+ # attribute_name: "PredefinedAttributeName", # required
6060
+ # attribute_value: "PredefinedAttributeStringValue", # required
6061
+ # },
6062
+ # ],
6063
+ # })
6064
+ #
6065
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/DisassociateUserProficiencies AWS API Documentation
6066
+ #
6067
+ # @overload disassociate_user_proficiencies(params = {})
6068
+ # @param [Hash] params ({})
6069
+ def disassociate_user_proficiencies(params = {}, options = {})
6070
+ req = build_request(:disassociate_user_proficiencies, params)
6071
+ req.send_request(options)
6072
+ end
6073
+
5899
6074
  # Dismisses contacts from an agent’s CCP and returns the agent to an
5900
6075
  # available state, which allows the agent to receive a new routed
5901
6076
  # contact. Contacts can only be dismissed if they are in a `MISSED`,
@@ -6172,8 +6347,9 @@ module Aws::Connect
6172
6347
  # queues: ["QueueId"],
6173
6348
  # channels: ["VOICE"], # accepts VOICE, CHAT, TASK
6174
6349
  # routing_profiles: ["RoutingProfileId"],
6350
+ # routing_step_expressions: ["RoutingExpression"],
6175
6351
  # },
6176
- # groupings: ["QUEUE"], # accepts QUEUE, CHANNEL, ROUTING_PROFILE
6352
+ # groupings: ["QUEUE"], # accepts QUEUE, CHANNEL, ROUTING_PROFILE, ROUTING_STEP_EXPRESSION
6177
6353
  # current_metrics: [ # required
6178
6354
  # {
6179
6355
  # name: "AGENTS_ONLINE", # accepts AGENTS_ONLINE, AGENTS_AVAILABLE, AGENTS_ON_CALL, AGENTS_NON_PRODUCTIVE, AGENTS_AFTER_CONTACT_WORK, AGENTS_ERROR, AGENTS_STAFFED, CONTACTS_IN_QUEUE, OLDEST_CONTACT_AGE, CONTACTS_SCHEDULED, AGENTS_ON_CONTACT, SLOTS_ACTIVE, SLOTS_AVAILABLE
@@ -6199,6 +6375,7 @@ module Aws::Connect
6199
6375
  # resp.metric_results[0].dimensions.channel #=> String, one of "VOICE", "CHAT", "TASK"
6200
6376
  # resp.metric_results[0].dimensions.routing_profile.id #=> String
6201
6377
  # resp.metric_results[0].dimensions.routing_profile.arn #=> String
6378
+ # resp.metric_results[0].dimensions.routing_step_expression #=> String
6202
6379
  # resp.metric_results[0].collections #=> Array
6203
6380
  # resp.metric_results[0].collections[0].metric.name #=> String, one of "AGENTS_ONLINE", "AGENTS_AVAILABLE", "AGENTS_ON_CALL", "AGENTS_NON_PRODUCTIVE", "AGENTS_AFTER_CONTACT_WORK", "AGENTS_ERROR", "AGENTS_STAFFED", "CONTACTS_IN_QUEUE", "OLDEST_CONTACT_AGE", "CONTACTS_SCHEDULED", "AGENTS_ON_CONTACT", "SLOTS_ACTIVE", "SLOTS_AVAILABLE"
6204
6381
  # resp.metric_results[0].collections[0].metric.unit #=> String, one of "SECONDS", "COUNT", "PERCENT"
@@ -6699,8 +6876,9 @@ module Aws::Connect
6699
6876
  # queues: ["QueueId"],
6700
6877
  # channels: ["VOICE"], # accepts VOICE, CHAT, TASK
6701
6878
  # routing_profiles: ["RoutingProfileId"],
6879
+ # routing_step_expressions: ["RoutingExpression"],
6702
6880
  # },
6703
- # groupings: ["QUEUE"], # accepts QUEUE, CHANNEL, ROUTING_PROFILE
6881
+ # groupings: ["QUEUE"], # accepts QUEUE, CHANNEL, ROUTING_PROFILE, ROUTING_STEP_EXPRESSION
6704
6882
  # historical_metrics: [ # required
6705
6883
  # {
6706
6884
  # name: "CONTACTS_QUEUED", # accepts CONTACTS_QUEUED, CONTACTS_HANDLED, CONTACTS_ABANDONED, CONTACTS_CONSULTED, CONTACTS_AGENT_HUNG_UP_FIRST, CONTACTS_HANDLED_INCOMING, CONTACTS_HANDLED_OUTBOUND, CONTACTS_HOLD_ABANDONS, CONTACTS_TRANSFERRED_IN, CONTACTS_TRANSFERRED_OUT, CONTACTS_TRANSFERRED_IN_FROM_QUEUE, CONTACTS_TRANSFERRED_OUT_FROM_QUEUE, CONTACTS_MISSED, CALLBACK_CONTACTS_HANDLED, API_CONTACTS_HANDLED, OCCUPANCY, HANDLE_TIME, AFTER_CONTACT_WORK_TIME, QUEUED_TIME, ABANDON_TIME, QUEUE_ANSWER_TIME, HOLD_TIME, INTERACTION_TIME, INTERACTION_AND_HOLD_TIME, SERVICE_LEVEL
@@ -6725,6 +6903,7 @@ module Aws::Connect
6725
6903
  # resp.metric_results[0].dimensions.channel #=> String, one of "VOICE", "CHAT", "TASK"
6726
6904
  # resp.metric_results[0].dimensions.routing_profile.id #=> String
6727
6905
  # resp.metric_results[0].dimensions.routing_profile.arn #=> String
6906
+ # resp.metric_results[0].dimensions.routing_step_expression #=> String
6728
6907
  # resp.metric_results[0].collections #=> Array
6729
6908
  # resp.metric_results[0].collections[0].metric.name #=> String, one of "CONTACTS_QUEUED", "CONTACTS_HANDLED", "CONTACTS_ABANDONED", "CONTACTS_CONSULTED", "CONTACTS_AGENT_HUNG_UP_FIRST", "CONTACTS_HANDLED_INCOMING", "CONTACTS_HANDLED_OUTBOUND", "CONTACTS_HOLD_ABANDONS", "CONTACTS_TRANSFERRED_IN", "CONTACTS_TRANSFERRED_OUT", "CONTACTS_TRANSFERRED_IN_FROM_QUEUE", "CONTACTS_TRANSFERRED_OUT_FROM_QUEUE", "CONTACTS_MISSED", "CALLBACK_CONTACTS_HANDLED", "API_CONTACTS_HANDLED", "OCCUPANCY", "HANDLE_TIME", "AFTER_CONTACT_WORK_TIME", "QUEUED_TIME", "ABANDON_TIME", "QUEUE_ANSWER_TIME", "HOLD_TIME", "INTERACTION_TIME", "INTERACTION_AND_HOLD_TIME", "SERVICE_LEVEL"
6730
6909
  # resp.metric_results[0].collections[0].metric.threshold.comparison #=> String, one of "LT"
@@ -9129,6 +9308,52 @@ module Aws::Connect
9129
9308
  req.send_request(options)
9130
9309
  end
9131
9310
 
9311
+ # Lists predefined attributes for the specified Amazon Connect instance.
9312
+ #
9313
+ # @option params [required, String] :instance_id
9314
+ # The identifier of the Amazon Connect instance. You can find the
9315
+ # instance ID in the Amazon Resource Name (ARN) of the instance.
9316
+ #
9317
+ # @option params [String] :next_token
9318
+ # The token for the next set of results. Use the value returned in the
9319
+ # previous response in the next request to retrieve the next set of
9320
+ # results.
9321
+ #
9322
+ # @option params [Integer] :max_results
9323
+ # The maximum number of results to return per page.
9324
+ #
9325
+ # @return [Types::ListPredefinedAttributesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
9326
+ #
9327
+ # * {Types::ListPredefinedAttributesResponse#next_token #next_token} => String
9328
+ # * {Types::ListPredefinedAttributesResponse#predefined_attribute_summary_list #predefined_attribute_summary_list} => Array&lt;Types::PredefinedAttributeSummary&gt;
9329
+ #
9330
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
9331
+ #
9332
+ # @example Request syntax with placeholder values
9333
+ #
9334
+ # resp = client.list_predefined_attributes({
9335
+ # instance_id: "InstanceId", # required
9336
+ # next_token: "NextToken",
9337
+ # max_results: 1,
9338
+ # })
9339
+ #
9340
+ # @example Response structure
9341
+ #
9342
+ # resp.next_token #=> String
9343
+ # resp.predefined_attribute_summary_list #=> Array
9344
+ # resp.predefined_attribute_summary_list[0].name #=> String
9345
+ # resp.predefined_attribute_summary_list[0].last_modified_time #=> Time
9346
+ # resp.predefined_attribute_summary_list[0].last_modified_region #=> String
9347
+ #
9348
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/ListPredefinedAttributes AWS API Documentation
9349
+ #
9350
+ # @overload list_predefined_attributes(params = {})
9351
+ # @param [Hash] params ({})
9352
+ def list_predefined_attributes(params = {}, options = {})
9353
+ req = build_request(:list_predefined_attributes, params)
9354
+ req.send_request(options)
9355
+ end
9356
+
9132
9357
  # Provides information about the prompts for the specified Amazon
9133
9358
  # Connect instance.
9134
9359
  #
@@ -10227,6 +10452,60 @@ module Aws::Connect
10227
10452
  req.send_request(options)
10228
10453
  end
10229
10454
 
10455
+ # Lists proficiencies associated with a user.
10456
+ #
10457
+ # @option params [required, String] :instance_id
10458
+ # The identifier of the Amazon Connect instance. You can find the
10459
+ # instance ID in the Amazon Resource Name (ARN) of the instance.
10460
+ #
10461
+ # @option params [required, String] :user_id
10462
+ # The identifier of the user account.
10463
+ #
10464
+ # @option params [String] :next_token
10465
+ # The token for the next set of results. Use the value returned in the
10466
+ # previous response in the next request to retrieve the next set of
10467
+ # results.
10468
+ #
10469
+ # @option params [Integer] :max_results
10470
+ # The maximum number of results to return per page.
10471
+ #
10472
+ # @return [Types::ListUserProficienciesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
10473
+ #
10474
+ # * {Types::ListUserProficienciesResponse#next_token #next_token} => String
10475
+ # * {Types::ListUserProficienciesResponse#user_proficiency_list #user_proficiency_list} => Array&lt;Types::UserProficiency&gt;
10476
+ # * {Types::ListUserProficienciesResponse#last_modified_time #last_modified_time} => Time
10477
+ # * {Types::ListUserProficienciesResponse#last_modified_region #last_modified_region} => String
10478
+ #
10479
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
10480
+ #
10481
+ # @example Request syntax with placeholder values
10482
+ #
10483
+ # resp = client.list_user_proficiencies({
10484
+ # instance_id: "InstanceId", # required
10485
+ # user_id: "UserId", # required
10486
+ # next_token: "NextToken",
10487
+ # max_results: 1,
10488
+ # })
10489
+ #
10490
+ # @example Response structure
10491
+ #
10492
+ # resp.next_token #=> String
10493
+ # resp.user_proficiency_list #=> Array
10494
+ # resp.user_proficiency_list[0].attribute_name #=> String
10495
+ # resp.user_proficiency_list[0].attribute_value #=> String
10496
+ # resp.user_proficiency_list[0].level #=> Float
10497
+ # resp.last_modified_time #=> Time
10498
+ # resp.last_modified_region #=> String
10499
+ #
10500
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/ListUserProficiencies AWS API Documentation
10501
+ #
10502
+ # @overload list_user_proficiencies(params = {})
10503
+ # @param [Hash] params ({})
10504
+ def list_user_proficiencies(params = {}, options = {})
10505
+ req = build_request(:list_user_proficiencies, params)
10506
+ req.send_request(options)
10507
+ end
10508
+
10230
10509
  # Provides summary information about the users for the specified Amazon
10231
10510
  # Connect instance.
10232
10511
  #
@@ -10814,6 +11093,116 @@ module Aws::Connect
10814
11093
  req.send_request(options)
10815
11094
  end
10816
11095
 
11096
+ # Searches contacts in an Amazon Connect instance.
11097
+ #
11098
+ # @option params [required, String] :instance_id
11099
+ # The identifier of Amazon Connect instance. You can find the instance
11100
+ # ID in the Amazon Resource Name (ARN) of the instance.
11101
+ #
11102
+ # @option params [required, Types::SearchContactsTimeRange] :time_range
11103
+ # Time range that you want to search results.
11104
+ #
11105
+ # @option params [Types::SearchCriteria] :search_criteria
11106
+ # The search criteria to be used to return contacts.
11107
+ #
11108
+ # @option params [Integer] :max_results
11109
+ # The maximum number of results to return per page.
11110
+ #
11111
+ # @option params [String] :next_token
11112
+ # The token for the next set of results. Use the value returned in the
11113
+ # previous response in the next request to retrieve the next set of
11114
+ # results.
11115
+ #
11116
+ # @option params [Types::Sort] :sort
11117
+ # Specifies a field to sort by and a sort order.
11118
+ #
11119
+ # @return [Types::SearchContactsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
11120
+ #
11121
+ # * {Types::SearchContactsResponse#contacts #contacts} => Array&lt;Types::ContactSearchSummary&gt;
11122
+ # * {Types::SearchContactsResponse#next_token #next_token} => String
11123
+ # * {Types::SearchContactsResponse#total_count #total_count} => Integer
11124
+ #
11125
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
11126
+ #
11127
+ # @example Request syntax with placeholder values
11128
+ #
11129
+ # resp = client.search_contacts({
11130
+ # instance_id: "InstanceId", # required
11131
+ # time_range: { # required
11132
+ # type: "INITIATION_TIMESTAMP", # required, accepts INITIATION_TIMESTAMP, SCHEDULED_TIMESTAMP, CONNECTED_TO_AGENT_TIMESTAMP, DISCONNECT_TIMESTAMP
11133
+ # start_time: Time.now, # required
11134
+ # end_time: Time.now, # required
11135
+ # },
11136
+ # search_criteria: {
11137
+ # agent_ids: ["AgentResourceId"],
11138
+ # agent_hierarchy_groups: {
11139
+ # l1_ids: ["HierarchyGroupId"],
11140
+ # l2_ids: ["HierarchyGroupId"],
11141
+ # l3_ids: ["HierarchyGroupId"],
11142
+ # l4_ids: ["HierarchyGroupId"],
11143
+ # l5_ids: ["HierarchyGroupId"],
11144
+ # },
11145
+ # channels: ["VOICE"], # accepts VOICE, CHAT, TASK
11146
+ # contact_analysis: {
11147
+ # transcript: {
11148
+ # criteria: [ # required
11149
+ # {
11150
+ # participant_role: "AGENT", # required, accepts AGENT, CUSTOMER, SYSTEM, CUSTOM_BOT
11151
+ # search_text: ["SearchText"], # required
11152
+ # match_type: "MATCH_ALL", # required, accepts MATCH_ALL, MATCH_ANY
11153
+ # },
11154
+ # ],
11155
+ # match_type: "MATCH_ALL", # accepts MATCH_ALL, MATCH_ANY
11156
+ # },
11157
+ # },
11158
+ # initiation_methods: ["INBOUND"], # accepts INBOUND, OUTBOUND, TRANSFER, QUEUE_TRANSFER, CALLBACK, API, DISCONNECT, MONITOR, EXTERNAL_OUTBOUND
11159
+ # queue_ids: ["QueueId"],
11160
+ # searchable_contact_attributes: {
11161
+ # criteria: [ # required
11162
+ # {
11163
+ # key: "SearchableContactAttributeKey", # required
11164
+ # values: ["SearchableContactAttributeValue"], # required
11165
+ # },
11166
+ # ],
11167
+ # match_type: "MATCH_ALL", # accepts MATCH_ALL, MATCH_ANY
11168
+ # },
11169
+ # },
11170
+ # max_results: 1,
11171
+ # next_token: "LargeNextToken",
11172
+ # sort: {
11173
+ # field_name: "INITIATION_TIMESTAMP", # required, accepts INITIATION_TIMESTAMP, SCHEDULED_TIMESTAMP, CONNECTED_TO_AGENT_TIMESTAMP, DISCONNECT_TIMESTAMP, INITIATION_METHOD, CHANNEL
11174
+ # order: "ASCENDING", # required, accepts ASCENDING, DESCENDING
11175
+ # },
11176
+ # })
11177
+ #
11178
+ # @example Response structure
11179
+ #
11180
+ # resp.contacts #=> Array
11181
+ # resp.contacts[0].arn #=> String
11182
+ # resp.contacts[0].id #=> String
11183
+ # resp.contacts[0].initial_contact_id #=> String
11184
+ # resp.contacts[0].previous_contact_id #=> String
11185
+ # resp.contacts[0].initiation_method #=> String, one of "INBOUND", "OUTBOUND", "TRANSFER", "QUEUE_TRANSFER", "CALLBACK", "API", "DISCONNECT", "MONITOR", "EXTERNAL_OUTBOUND"
11186
+ # resp.contacts[0].channel #=> String, one of "VOICE", "CHAT", "TASK"
11187
+ # resp.contacts[0].queue_info.id #=> String
11188
+ # resp.contacts[0].queue_info.enqueue_timestamp #=> Time
11189
+ # resp.contacts[0].agent_info.id #=> String
11190
+ # resp.contacts[0].agent_info.connected_to_agent_timestamp #=> Time
11191
+ # resp.contacts[0].initiation_timestamp #=> Time
11192
+ # resp.contacts[0].disconnect_timestamp #=> Time
11193
+ # resp.contacts[0].scheduled_timestamp #=> Time
11194
+ # resp.next_token #=> String
11195
+ # resp.total_count #=> Integer
11196
+ #
11197
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/SearchContacts AWS API Documentation
11198
+ #
11199
+ # @overload search_contacts(params = {})
11200
+ # @param [Hash] params ({})
11201
+ def search_contacts(params = {}, options = {})
11202
+ req = build_request(:search_contacts, params)
11203
+ req.send_request(options)
11204
+ end
11205
+
10817
11206
  # Searches the hours of operation in an Amazon Connect instance, with
10818
11207
  # optional filtering.
10819
11208
  #
@@ -10924,6 +11313,76 @@ module Aws::Connect
10924
11313
  req.send_request(options)
10925
11314
  end
10926
11315
 
11316
+ # Predefined attributes that meet certain criteria.
11317
+ #
11318
+ # @option params [required, String] :instance_id
11319
+ # The identifier of the Amazon Connect instance. You can find the
11320
+ # instance ID in the Amazon Resource Name (ARN) of the instance.
11321
+ #
11322
+ # @option params [String] :next_token
11323
+ # The token for the next set of results. Use the value returned in the
11324
+ # previous response in the next request to retrieve the next set of
11325
+ # results.
11326
+ #
11327
+ # @option params [Integer] :max_results
11328
+ # The maximum number of results to return per page.
11329
+ #
11330
+ # @option params [Types::PredefinedAttributeSearchCriteria] :search_criteria
11331
+ # The search criteria to be used to return predefined attributes.
11332
+ #
11333
+ # @return [Types::SearchPredefinedAttributesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
11334
+ #
11335
+ # * {Types::SearchPredefinedAttributesResponse#predefined_attributes #predefined_attributes} => Array&lt;Types::PredefinedAttribute&gt;
11336
+ # * {Types::SearchPredefinedAttributesResponse#next_token #next_token} => String
11337
+ # * {Types::SearchPredefinedAttributesResponse#approximate_total_count #approximate_total_count} => Integer
11338
+ #
11339
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
11340
+ #
11341
+ # @example Request syntax with placeholder values
11342
+ #
11343
+ # resp = client.search_predefined_attributes({
11344
+ # instance_id: "InstanceId", # required
11345
+ # next_token: "NextToken2500",
11346
+ # max_results: 1,
11347
+ # search_criteria: {
11348
+ # or_conditions: [
11349
+ # {
11350
+ # # recursive PredefinedAttributeSearchCriteria
11351
+ # },
11352
+ # ],
11353
+ # and_conditions: [
11354
+ # {
11355
+ # # recursive PredefinedAttributeSearchCriteria
11356
+ # },
11357
+ # ],
11358
+ # string_condition: {
11359
+ # field_name: "String",
11360
+ # value: "String",
11361
+ # comparison_type: "STARTS_WITH", # accepts STARTS_WITH, CONTAINS, EXACT
11362
+ # },
11363
+ # },
11364
+ # })
11365
+ #
11366
+ # @example Response structure
11367
+ #
11368
+ # resp.predefined_attributes #=> Array
11369
+ # resp.predefined_attributes[0].name #=> String
11370
+ # resp.predefined_attributes[0].values.string_list #=> Array
11371
+ # resp.predefined_attributes[0].values.string_list[0] #=> String
11372
+ # resp.predefined_attributes[0].last_modified_time #=> Time
11373
+ # resp.predefined_attributes[0].last_modified_region #=> String
11374
+ # resp.next_token #=> String
11375
+ # resp.approximate_total_count #=> Integer
11376
+ #
11377
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/SearchPredefinedAttributes AWS API Documentation
11378
+ #
11379
+ # @overload search_predefined_attributes(params = {})
11380
+ # @param [Hash] params ({})
11381
+ def search_predefined_attributes(params = {}, options = {})
11382
+ req = build_request(:search_predefined_attributes, params)
11383
+ req.send_request(options)
11384
+ end
11385
+
10927
11386
  # Searches prompts in an Amazon Connect instance, with optional
10928
11387
  # filtering.
10929
11388
  #
@@ -13651,6 +14110,68 @@ module Aws::Connect
13651
14110
  req.send_request(options)
13652
14111
  end
13653
14112
 
14113
+ # This API is in preview release for Amazon Connect and is subject to
14114
+ # change.
14115
+ #
14116
+ # Updates routing priority and age on the contact (**QueuePriority** and
14117
+ # **QueueTimeAdjustmentInSeconds**). These properties can be used to
14118
+ # change a customer's position in the queue. For example, you can move
14119
+ # a contact to the back of the queue by setting a lower routing priority
14120
+ # relative to other contacts in queue; or you can move a contact to the
14121
+ # front of the queue by increasing the routing age which will make the
14122
+ # contact look artificially older and therefore higher up in the
14123
+ # first-in-first-out routing order. Note that adjusting the routing age
14124
+ # of a contact affects only its position in queue, and not its actual
14125
+ # queue wait time as reported through metrics. These properties can also
14126
+ # be updated by using [the Set routing priority / age flow block][1].
14127
+ #
14128
+ #
14129
+ #
14130
+ # [1]: https://docs.aws.amazon.com/connect/latest/adminguide/change-routing-priority.html
14131
+ #
14132
+ # @option params [required, String] :instance_id
14133
+ # The identifier of the Amazon Connect instance. You can [find the
14134
+ # instance ID][1] in the Amazon Resource Name (ARN) of the instance.
14135
+ #
14136
+ #
14137
+ #
14138
+ # [1]: https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html
14139
+ #
14140
+ # @option params [required, String] :contact_id
14141
+ # The identifier of the contact in this instance of Amazon Connect.
14142
+ #
14143
+ # @option params [Integer] :queue_time_adjustment_seconds
14144
+ # The number of seconds to add or subtract from the contact's routing
14145
+ # age. Contacts are routed to agents on a first-come, first-serve basis.
14146
+ # This means that changing their amount of time in queue compared to
14147
+ # others also changes their position in queue.
14148
+ #
14149
+ # @option params [Integer] :queue_priority
14150
+ # Priority of the contact in the queue. The default priority for new
14151
+ # contacts is 5. You can raise the priority of a contact compared to
14152
+ # other contacts in the queue by assigning them a higher priority, such
14153
+ # as 1 or 2.
14154
+ #
14155
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
14156
+ #
14157
+ # @example Request syntax with placeholder values
14158
+ #
14159
+ # resp = client.update_contact_routing_data({
14160
+ # instance_id: "InstanceId", # required
14161
+ # contact_id: "ContactId", # required
14162
+ # queue_time_adjustment_seconds: 1,
14163
+ # queue_priority: 1,
14164
+ # })
14165
+ #
14166
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/UpdateContactRoutingData AWS API Documentation
14167
+ #
14168
+ # @overload update_contact_routing_data(params = {})
14169
+ # @param [Hash] params ({})
14170
+ def update_contact_routing_data(params = {}, options = {})
14171
+ req = build_request(:update_contact_routing_data, params)
14172
+ req.send_request(options)
14173
+ end
14174
+
13654
14175
  # Updates the scheduled time of a task contact that is already
13655
14176
  # scheduled.
13656
14177
  #
@@ -14205,6 +14726,40 @@ module Aws::Connect
14205
14726
  req.send_request(options)
14206
14727
  end
14207
14728
 
14729
+ # Updates a predefined attribute for the specified Amazon Connect
14730
+ # instance.
14731
+ #
14732
+ # @option params [required, String] :instance_id
14733
+ # The identifier of the Amazon Connect instance. You can find the
14734
+ # instance ID in the Amazon Resource Name (ARN) of the instance.
14735
+ #
14736
+ # @option params [required, String] :name
14737
+ # The name of the predefined attribute.
14738
+ #
14739
+ # @option params [Types::PredefinedAttributeValues] :values
14740
+ # The values of the predefined attribute.
14741
+ #
14742
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
14743
+ #
14744
+ # @example Request syntax with placeholder values
14745
+ #
14746
+ # resp = client.update_predefined_attribute({
14747
+ # instance_id: "InstanceId", # required
14748
+ # name: "PredefinedAttributeName", # required
14749
+ # values: {
14750
+ # string_list: ["PredefinedAttributeStringValue"],
14751
+ # },
14752
+ # })
14753
+ #
14754
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/UpdatePredefinedAttribute AWS API Documentation
14755
+ #
14756
+ # @overload update_predefined_attribute(params = {})
14757
+ # @param [Hash] params ({})
14758
+ def update_predefined_attribute(params = {}, options = {})
14759
+ req = build_request(:update_predefined_attribute, params)
14760
+ req.send_request(options)
14761
+ end
14762
+
14208
14763
  # Updates a prompt.
14209
14764
  #
14210
14765
  # @option params [required, String] :instance_id
@@ -15411,6 +15966,45 @@ module Aws::Connect
15411
15966
  req.send_request(options)
15412
15967
  end
15413
15968
 
15969
+ # Updates the properties associated with the proficiencies of a user.
15970
+ #
15971
+ # @option params [required, String] :instance_id
15972
+ # The identifier of the Amazon Connect instance. You can find the
15973
+ # instance ID in the Amazon Resource Name (ARN) of the instance.
15974
+ #
15975
+ # @option params [required, String] :user_id
15976
+ # The identifier of the user account.
15977
+ #
15978
+ # @option params [required, Array<Types::UserProficiency>] :user_proficiencies
15979
+ # The proficiencies to be updated for the user. Proficiencies must first
15980
+ # be associated to the user. You can do this using
15981
+ # AssociateUserProficiencies API.
15982
+ #
15983
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
15984
+ #
15985
+ # @example Request syntax with placeholder values
15986
+ #
15987
+ # resp = client.update_user_proficiencies({
15988
+ # instance_id: "InstanceId", # required
15989
+ # user_id: "UserId", # required
15990
+ # user_proficiencies: [ # required
15991
+ # {
15992
+ # attribute_name: "PredefinedAttributeName", # required
15993
+ # attribute_value: "PredefinedAttributeStringValue", # required
15994
+ # level: 1.0, # required
15995
+ # },
15996
+ # ],
15997
+ # })
15998
+ #
15999
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/UpdateUserProficiencies AWS API Documentation
16000
+ #
16001
+ # @overload update_user_proficiencies(params = {})
16002
+ # @param [Hash] params ({})
16003
+ def update_user_proficiencies(params = {}, options = {})
16004
+ req = build_request(:update_user_proficiencies, params)
16005
+ req.send_request(options)
16006
+ end
16007
+
15414
16008
  # Assigns the specified routing profile to the specified user.
15415
16009
  #
15416
16010
  # @option params [required, String] :routing_profile_id
@@ -15601,7 +16195,7 @@ module Aws::Connect
15601
16195
  params: params,
15602
16196
  config: config)
15603
16197
  context[:gem_name] = 'aws-sdk-connect'
15604
- context[:gem_version] = '1.144.0'
16198
+ context[:gem_version] = '1.146.0'
15605
16199
  Seahorse::Client::Request.new(handlers, context)
15606
16200
  end
15607
16201