Skip to content

Commit 19c214e

Browse files
author
awstools
committed
docs(client-connect): Updated the CreateContact API documentation to indicate that it only applies to EMAIL contacts.
1 parent e8bd309 commit 19c214e

File tree

6 files changed

+55
-29
lines changed

6 files changed

+55
-29
lines changed

clients/client-connect/src/commands/CreateContactCommand.ts

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,11 @@ export interface CreateContactCommandInput extends CreateContactRequest {}
2929
export interface CreateContactCommandOutput extends CreateContactResponse, __MetadataBearer {}
3030

3131
/**
32-
* <p>Creates a new contact.</p>
32+
* <important>
33+
* <p>Only the EMAIL channel is supported. The supported initiation
34+
* methods are: OUTBOUND, AGENT_REPLY, and FLOW.</p>
35+
* </important>
36+
* <p>Creates a new EMAIL contact. </p>
3337
* @example
3438
* Use a bare-bones client and the command you need to make an API call.
3539
* ```javascript

clients/client-connect/src/commands/UpdateTrafficDistributionCommand.ts

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,11 @@ export interface UpdateTrafficDistributionCommandOutput extends UpdateTrafficDis
2929

3030
/**
3131
* <p>Updates the traffic distribution for a given traffic distribution group. </p>
32+
* <important>
33+
* <p>When you shift telephony traffic, also shift agents and/or agent sign-ins to ensure they
34+
* can handle the calls in the other Region. If you don't shift the agents, voice calls will go to
35+
* the shifted Region but there won't be any agents available to receive the calls.</p>
36+
* </important>
3237
* <note>
3338
* <p>The <code>SignInConfig</code> distribution is available only on a
3439
* default <code>TrafficDistributionGroup</code> (see the <code>IsDefault</code> parameter in the

clients/client-connect/src/models/models_0.ts

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5312,7 +5312,9 @@ export interface NotificationRecipientType {
53125312
UserTags?: Record<string, string> | undefined;
53135313

53145314
/**
5315-
* <p>A list of user IDs.</p>
5315+
* <p>A list of user IDs. Supports variable injection of
5316+
* <code>$.ContactLens.ContactEvaluation.Agent.AgentId</code> for
5317+
* <code>OnContactEvaluationSubmit</code> event source. </p>
53165318
* @public
53175319
*/
53185320
UserIds?: string[] | undefined;
@@ -5689,9 +5691,10 @@ export interface CreateSecurityProfileRequest {
56895691
AllowedAccessControlTags?: Record<string, string> | undefined;
56905692

56915693
/**
5692-
* <p>The list of resources that a security profile applies tag restrictions to in Amazon Connect. Following are acceptable ResourceNames: <code>User</code> |
5693-
* <code>SecurityProfile</code> | <code>Queue</code> | <code>RoutingProfile</code>
5694-
* </p>
5694+
* <p>The list of resources that a security profile applies tag restrictions to in Amazon Connect. For a list of Amazon Connect resources that you can tag, see
5695+
* <a href="https://docs.aws.amazon.com/connect/latest/adminguide/tagging.html">Add tags to resources
5696+
* in Amazon Connect</a> in the <i>Amazon Connect Administrator
5697+
* Guide</i>. </p>
56955698
* @public
56965699
*/
56975700
TagRestrictedResources?: string[] | undefined;

clients/client-connect/src/models/models_2.ts

Lines changed: 19 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -3613,34 +3613,41 @@ export interface SearchResourceTagsRequest {
36133613

36143614
/**
36153615
* <p>The list of resource types to be used to search tags from. If not provided or if any empty
3616-
* list is provided, this API will search from all supported resource types.</p>
3616+
* list is provided, this API will search from all supported resource types. Note that lowercase and
3617+
* - are required.</p>
36173618
* <p class="title">
36183619
* <b>Supported resource types</b>
36193620
* </p>
36203621
* <ul>
36213622
* <li>
3622-
* <p>AGENT</p>
3623+
* <p>agent</p>
36233624
* </li>
36243625
* <li>
3625-
* <p>ROUTING_PROFILE</p>
3626+
* <p>agent-state</p>
36263627
* </li>
36273628
* <li>
3628-
* <p>STANDARD_QUEUE</p>
3629+
* <p>routing-profile</p>
36293630
* </li>
36303631
* <li>
3631-
* <p>SECURITY_PROFILE</p>
3632+
* <p>standard-queue</p>
36323633
* </li>
36333634
* <li>
3634-
* <p>OPERATING_HOURS</p>
3635+
* <p>security-profile</p>
36353636
* </li>
36363637
* <li>
3637-
* <p>PROMPT</p>
3638+
* <p>operating-hours</p>
36383639
* </li>
36393640
* <li>
3640-
* <p>CONTACT_FLOW</p>
3641+
* <p>prompt</p>
36413642
* </li>
36423643
* <li>
3643-
* <p>FLOW_MODULE</p>
3644+
* <p>contact-flow</p>
3645+
* </li>
3646+
* <li>
3647+
* <p>flow- module</p>
3648+
* </li>
3649+
* <li>
3650+
* <p>transfer-destination (also known as quick connect)</p>
36443651
* </li>
36453652
* </ul>
36463653
* @public
@@ -6417,8 +6424,9 @@ export interface UpdateContactAttributesRequest {
64176424
* other contact attributes.</p>
64186425
* <p>You can have up to 32,768 UTF-8 bytes across all attributes for a contact. Attribute keys
64196426
* can include only alphanumeric, dash, and underscore characters.</p>
6420-
* <p>When the attributes for a contact exceed 32 KB, the contact is routed down the Error branch
6421-
* of the flow. As a mitigation, consider the following options:</p>
6427+
* <p>In the <a href="https://docs.aws.amazon.com/connect/latest/adminguide/set-contact-attributes.html">Set contact attributes</a>
6428+
* block, when the attributes for a contact exceed 32 KB, the contact is routed down the Error
6429+
* branch of the flow. As a mitigation, consider the following options:</p>
64226430
* <ul>
64236431
* <li>
64246432
* <p>Remove unnecessary attributes by setting their values to empty.</p>

clients/client-connect/src/models/models_3.ts

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1028,12 +1028,21 @@ export interface CreateContactRequest {
10281028

10291029
/**
10301030
* <p>The channel for the contact</p>
1031+
* <important>
1032+
* <p>CreateContact only supports the EMAIL channel. The following information that states other
1033+
* channels are supported is incorrect. We are working to update this topic.</p>
1034+
* </important>
10311035
* @public
10321036
*/
10331037
Channel: Channel | undefined;
10341038

10351039
/**
1036-
* <p>Indicates how the contact was initiated.</p>
1040+
* <p>Indicates how the contact was initiated. </p>
1041+
* <important>
1042+
* <p>CreateContact only supports the following initiation methods: OUTBOUND, AGENT_REPLY, and
1043+
* FLOW. The following information that states other initiation methods are supported is incorrect. We are
1044+
* working to update this topic.</p>
1045+
* </important>
10371046
* @public
10381047
*/
10391048
InitiationMethod: ContactInitiationMethod | undefined;
@@ -2848,9 +2857,6 @@ export interface SearchUserHierarchyGroupsRequest {
28482857
export interface SearchUsersRequest {
28492858
/**
28502859
* <p>The identifier of the Amazon Connect instance. You can <a href="https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html">find the instance ID</a> in the Amazon Resource Name (ARN) of the instance.</p>
2851-
* <note>
2852-
* <p>InstanceID is a required field. The "Required: No" below is incorrect.</p>
2853-
* </note>
28542860
* @public
28552861
*/
28562862
InstanceId: string | undefined;

codegen/sdk-codegen/aws-models/connect.json

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -7184,7 +7184,7 @@
71847184
}
71857185
],
71867186
"traits": {
7187-
"smithy.api#documentation": "<p>Creates a new contact.</p>",
7187+
"smithy.api#documentation": "<important>\n <p>Only the EMAIL channel is supported. The supported initiation\n methods are: OUTBOUND, AGENT_REPLY, and FLOW.</p>\n </important>\n <p>Creates a new EMAIL contact. </p>",
71887188
"smithy.api#http": {
71897189
"method": "PUT",
71907190
"uri": "/contact/create-contact",
@@ -7586,14 +7586,14 @@
75867586
"Channel": {
75877587
"target": "com.amazonaws.connect#Channel",
75887588
"traits": {
7589-
"smithy.api#documentation": "<p>The channel for the contact</p>",
7589+
"smithy.api#documentation": "<p>The channel for the contact</p>\n <important>\n <p>CreateContact only supports the EMAIL channel. The following information that states other\n channels are supported is incorrect. We are working to update this topic.</p>\n </important>",
75907590
"smithy.api#required": {}
75917591
}
75927592
},
75937593
"InitiationMethod": {
75947594
"target": "com.amazonaws.connect#ContactInitiationMethod",
75957595
"traits": {
7596-
"smithy.api#documentation": "<p>Indicates how the contact was initiated.</p>",
7596+
"smithy.api#documentation": "<p>Indicates how the contact was initiated. </p>\n <important>\n <p>CreateContact only supports the following initiation methods: OUTBOUND, AGENT_REPLY, and\n FLOW. The following information that states other initiation methods are supported is incorrect. We are\n working to update this topic.</p>\n </important>",
75977597
"smithy.api#required": {}
75987598
}
75997599
},
@@ -9342,7 +9342,7 @@
93429342
"TagRestrictedResources": {
93439343
"target": "com.amazonaws.connect#TagRestrictedResourceList",
93449344
"traits": {
9345-
"smithy.api#documentation": "<p>The list of resources that a security profile applies tag restrictions to in Amazon Connect. Following are acceptable ResourceNames: <code>User</code> |\n <code>SecurityProfile</code> | <code>Queue</code> | <code>RoutingProfile</code>\n </p>"
9345+
"smithy.api#documentation": "<p>The list of resources that a security profile applies tag restrictions to in Amazon Connect. For a list of Amazon Connect resources that you can tag, see\n <a href=\"https://docs.aws.amazon.com/connect/latest/adminguide/tagging.html\">Add tags to resources\n in Amazon Connect</a> in the <i>Amazon Connect Administrator\n Guide</i>. </p>"
93469346
}
93479347
},
93489348
"Applications": {
@@ -27449,7 +27449,7 @@
2744927449
"UserIds": {
2745027450
"target": "com.amazonaws.connect#UserIdList",
2745127451
"traits": {
27452-
"smithy.api#documentation": "<p>A list of user IDs.</p>"
27452+
"smithy.api#documentation": "<p>A list of user IDs. Supports variable injection of\n <code>$.ContactLens.ContactEvaluation.Agent.AgentId</code> for\n <code>OnContactEvaluationSubmit</code> event source. </p>"
2745327453
}
2745427454
}
2745527455
},
@@ -35185,7 +35185,7 @@
3518535185
"ResourceTypes": {
3518635186
"target": "com.amazonaws.connect#ResourceTypeList",
3518735187
"traits": {
35188-
"smithy.api#documentation": "<p>The list of resource types to be used to search tags from. If not provided or if any empty\n list is provided, this API will search from all supported resource types.</p>\n <p class=\"title\">\n <b>Supported resource types</b>\n </p>\n <ul>\n <li>\n <p>AGENT</p>\n </li>\n <li>\n <p>ROUTING_PROFILE</p>\n </li>\n <li>\n <p>STANDARD_QUEUE</p>\n </li>\n <li>\n <p>SECURITY_PROFILE</p>\n </li>\n <li>\n <p>OPERATING_HOURS</p>\n </li>\n <li>\n <p>PROMPT</p>\n </li>\n <li>\n <p>CONTACT_FLOW</p>\n </li>\n <li>\n <p>FLOW_MODULE</p>\n </li>\n </ul>"
35188+
"smithy.api#documentation": "<p>The list of resource types to be used to search tags from. If not provided or if any empty\n list is provided, this API will search from all supported resource types. Note that lowercase and\n - are required.</p>\n <p class=\"title\">\n <b>Supported resource types</b>\n </p>\n <ul>\n <li>\n <p>agent</p>\n </li>\n <li>\n <p>agent-state</p>\n </li>\n <li>\n <p>routing-profile</p>\n </li>\n <li>\n <p>standard-queue</p>\n </li>\n <li>\n <p>security-profile</p>\n </li>\n <li>\n <p>operating-hours</p>\n </li>\n <li>\n <p>prompt</p>\n </li>\n <li>\n <p>contact-flow</p>\n </li>\n <li>\n <p>flow- module</p>\n </li>\n <li>\n <p>transfer-destination (also known as quick connect)</p>\n </li>\n </ul>"
3518935189
}
3519035190
},
3519135191
"NextToken": {
@@ -35614,7 +35614,7 @@
3561435614
"InstanceId": {
3561535615
"target": "com.amazonaws.connect#InstanceId",
3561635616
"traits": {
35617-
"smithy.api#documentation": "<p>The identifier of the Amazon Connect instance. You can <a href=\"https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html\">find the instance ID</a> in the Amazon Resource Name (ARN) of the instance.</p>\n <note>\n <p>InstanceID is a required field. The \"Required: No\" below is incorrect.</p>\n </note>",
35617+
"smithy.api#documentation": "<p>The identifier of the Amazon Connect instance. You can <a href=\"https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html\">find the instance ID</a> in the Amazon Resource Name (ARN) of the instance.</p>",
3561835618
"smithy.api#required": {}
3561935619
}
3562035620
},
@@ -40686,7 +40686,7 @@
4068640686
"Attributes": {
4068740687
"target": "com.amazonaws.connect#Attributes",
4068840688
"traits": {
40689-
"smithy.api#documentation": "<p>The Amazon Connect attributes. These attributes can be accessed in flows just like any\n other contact attributes.</p>\n <p>You can have up to 32,768 UTF-8 bytes across all attributes for a contact. Attribute keys\n can include only alphanumeric, dash, and underscore characters.</p>\n <p>When the attributes for a contact exceed 32 KB, the contact is routed down the Error branch\n of the flow. As a mitigation, consider the following options:</p>\n <ul>\n <li>\n <p>Remove unnecessary attributes by setting their values to empty.</p>\n </li>\n <li>\n <p>If the attributes are only used in one flow and don't need to be referred to outside of\n that flow (for example, by a Lambda or another flow), then use flow attributes. This way you\n aren't needlessly persisting the 32 KB of information from one flow to another. For more\n information, see <a href=\"https://docs.aws.amazon.com/connect/latest/adminguide/set-contact-attributes.html\">Flow block: Set contact\n attributes</a> in the <i>Amazon Connect Administrator Guide</i>. </p>\n </li>\n </ul>",
40689+
"smithy.api#documentation": "<p>The Amazon Connect attributes. These attributes can be accessed in flows just like any\n other contact attributes.</p>\n <p>You can have up to 32,768 UTF-8 bytes across all attributes for a contact. Attribute keys\n can include only alphanumeric, dash, and underscore characters.</p>\n <p>In the <a href=\"https://docs.aws.amazon.com/connect/latest/adminguide/set-contact-attributes.html\">Set contact attributes</a>\n block, when the attributes for a contact exceed 32 KB, the contact is routed down the Error\n branch of the flow. As a mitigation, consider the following options:</p>\n <ul>\n <li>\n <p>Remove unnecessary attributes by setting their values to empty.</p>\n </li>\n <li>\n <p>If the attributes are only used in one flow and don't need to be referred to outside of\n that flow (for example, by a Lambda or another flow), then use flow attributes. This way you\n aren't needlessly persisting the 32 KB of information from one flow to another. For more\n information, see <a href=\"https://docs.aws.amazon.com/connect/latest/adminguide/set-contact-attributes.html\">Flow block: Set contact\n attributes</a> in the <i>Amazon Connect Administrator Guide</i>. </p>\n </li>\n </ul>",
4069040690
"smithy.api#required": {}
4069140691
}
4069240692
}
@@ -43806,7 +43806,7 @@
4380643806
}
4380743807
],
4380843808
"traits": {
43809-
"smithy.api#documentation": "<p>Updates the traffic distribution for a given traffic distribution group. </p>\n <note>\n <p>The <code>SignInConfig</code> distribution is available only on a \ndefault <code>TrafficDistributionGroup</code> (see the <code>IsDefault</code> parameter in the \n<a href=\"https://docs.aws.amazon.com/connect/latest/APIReference/API_TrafficDistributionGroup.html\">TrafficDistributionGroup</a>\n data type). If you call\n <code>UpdateTrafficDistribution</code> with a modified <code>SignInConfig</code> and a non-default <code>TrafficDistributionGroup</code>,\n an <code>InvalidRequestException</code> is returned.</p>\n </note>\n <p>For more information about updating a traffic distribution group, see <a href=\"https://docs.aws.amazon.com/connect/latest/adminguide/update-telephony-traffic-distribution.html\">Update telephony\n traffic distribution across Amazon Web Services Regions\n </a> in the <i>Amazon Connect Administrator Guide</i>. </p>",
43809+
"smithy.api#documentation": "<p>Updates the traffic distribution for a given traffic distribution group. </p>\n <important>\n <p>When you shift telephony traffic, also shift agents and/or agent sign-ins to ensure they\n can handle the calls in the other Region. If you don't shift the agents, voice calls will go to\n the shifted Region but there won't be any agents available to receive the calls.</p>\n </important>\n <note>\n <p>The <code>SignInConfig</code> distribution is available only on a \ndefault <code>TrafficDistributionGroup</code> (see the <code>IsDefault</code> parameter in the \n<a href=\"https://docs.aws.amazon.com/connect/latest/APIReference/API_TrafficDistributionGroup.html\">TrafficDistributionGroup</a>\n data type). If you call\n <code>UpdateTrafficDistribution</code> with a modified <code>SignInConfig</code> and a non-default <code>TrafficDistributionGroup</code>,\n an <code>InvalidRequestException</code> is returned.</p>\n </note>\n <p>For more information about updating a traffic distribution group, see <a href=\"https://docs.aws.amazon.com/connect/latest/adminguide/update-telephony-traffic-distribution.html\">Update telephony\n traffic distribution across Amazon Web Services Regions\n </a> in the <i>Amazon Connect Administrator Guide</i>. </p>",
4381043810
"smithy.api#http": {
4381143811
"method": "PUT",
4381243812
"uri": "/traffic-distribution/{Id}",

0 commit comments

Comments
 (0)