Skip to content

Commit a7ec4aa

Browse files
author
awstools
committed
feat(client-connect): Amazon Connect Service Feature: Add support to enable multi-user in-app, web, and video calling.
1 parent d595af9 commit a7ec4aa

File tree

4 files changed

+34
-13
lines changed

4 files changed

+34
-13
lines changed

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

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -28,8 +28,9 @@ export interface CreateParticipantCommandInput extends CreateParticipantRequest
2828
export interface CreateParticipantCommandOutput extends CreateParticipantResponse, __MetadataBearer {}
2929

3030
/**
31-
* <p>Adds a new participant into an on-going chat contact. For more information, see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/chat-customize-flow.html">Customize chat
32-
* flow experiences by integrating custom participants</a>.</p>
31+
* <p>Adds a new participant into an on-going chat contact or webRTC call. For more information, see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/chat-customize-flow.html">Customize chat
32+
* flow experiences by integrating custom participants</a>
33+
* or <a href="https://docs.aws.amazon.com/connect/latest/adminguide/enable-multiuser-inapp.html">Enable multi-user web, in-app, and video calling</a>.</p>
3334
* @example
3435
* Use a bare-bones client and the command you need to make an API call.
3536
* ```javascript
@@ -43,6 +44,10 @@ export interface CreateParticipantCommandOutput extends CreateParticipantRespons
4344
* ParticipantDetails: { // ParticipantDetailsToAdd
4445
* ParticipantRole: "AGENT" || "CUSTOMER" || "SYSTEM" || "CUSTOM_BOT" || "SUPERVISOR",
4546
* DisplayName: "STRING_VALUE",
47+
* ParticipantCapabilities: { // ParticipantCapabilities
48+
* Video: "SEND",
49+
* ScreenShare: "SEND",
50+
* },
4651
* },
4752
* };
4853
* const command = new CreateParticipantCommand(input);
@@ -63,6 +68,10 @@ export interface CreateParticipantCommandOutput extends CreateParticipantRespons
6368
* @see {@link CreateParticipantCommandOutput} for command's `response` shape.
6469
* @see {@link ConnectClientResolvedConfig | config} for ConnectClient's `config` shape.
6570
*
71+
* @throws {@link ConflictException} (client fault)
72+
* <p>Operation cannot be performed at this time as there is a conflict with another operation or
73+
* contact state.</p>
74+
*
6675
* @throws {@link InternalServiceException} (server fault)
6776
* <p>Request processing failed because of an error or failure with the service.</p>
6877
*

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

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -59,9 +59,6 @@ export interface GetCurrentMetricDataCommandOutput extends GetCurrentMetricDataR
5959
* <p>If the response is slow due to large result sets, try these approaches:</p>
6060
* <ul>
6161
* <li>
62-
* <p>Narrow the time range of your request</p>
63-
* </li>
64-
* <li>
6562
* <p>Add filters to reduce the amount of data returned</p>
6663
* </li>
6764
* </ul>

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

Lines changed: 13 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4457,6 +4457,14 @@ export interface ParticipantDetailsToAdd {
44574457
* @public
44584458
*/
44594459
DisplayName?: string | undefined;
4460+
4461+
/**
4462+
* <p>The configuration for the allowed video and screen sharing capabilities for participants
4463+
* present over the call. For more information, see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/inapp-calling.html">Set up in-app, web, video calling, and screen
4464+
* sharing capabilities</a> in the <i>Amazon Connect Administrator Guide</i>.</p>
4465+
* @public
4466+
*/
4467+
ParticipantCapabilities?: ParticipantCapabilities | undefined;
44604468
}
44614469

44624470
/**
@@ -4470,7 +4478,9 @@ export interface CreateParticipantRequest {
44704478
InstanceId: string | undefined;
44714479

44724480
/**
4473-
* <p>The identifier of the contact in this instance of Amazon Connect. Only contacts in the CHAT channel are supported.</p>
4481+
* <p>The identifier of the contact in this instance of Amazon Connect. Supports contacts in the CHAT channel and VOICE (WebRTC) channels.
4482+
* For WebRTC calls, this should be the initial contact ID that was generated when
4483+
* the contact was first created (from the StartWebRTCContact API) in the VOICE channel</p>
44744484
* @public
44754485
*/
44764486
ContactId: string | undefined;
@@ -4487,9 +4497,8 @@ export interface CreateParticipantRequest {
44874497
/**
44884498
* <p>Information identifying the participant.</p>
44894499
* <important>
4490-
* <p>The only Valid value for <code>ParticipantRole</code> is <code>CUSTOM_BOT</code>. </p>
4491-
* <p>
4492-
* <code>DisplayName</code> is <b>Required</b>.</p>
4500+
* <p>The only valid value for <code>ParticipantRole</code> is <code>CUSTOM_BOT</code>
4501+
* for chat contact and <code>CUSTOMER</code> for voice contact.</p>
44934502
* </important>
44944503
* @public
44954504
*/

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

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8810,6 +8810,9 @@
88108810
"target": "com.amazonaws.connect#CreateParticipantResponse"
88118811
},
88128812
"errors": [
8813+
{
8814+
"target": "com.amazonaws.connect#ConflictException"
8815+
},
88138816
{
88148817
"target": "com.amazonaws.connect#InternalServiceException"
88158818
},
@@ -8827,7 +8830,7 @@
88278830
}
88288831
],
88298832
"traits": {
8830-
"smithy.api#documentation": "<p>Adds a new participant into an on-going chat contact. For more information, see <a href=\"https://docs.aws.amazon.com/connect/latest/adminguide/chat-customize-flow.html\">Customize chat\n flow experiences by integrating custom participants</a>.</p>",
8833+
"smithy.api#documentation": "<p>Adds a new participant into an on-going chat contact or webRTC call. For more information, see <a href=\"https://docs.aws.amazon.com/connect/latest/adminguide/chat-customize-flow.html\">Customize chat\n flow experiences by integrating custom participants</a> \n or <a href=\"https://docs.aws.amazon.com/connect/latest/adminguide/enable-multiuser-inapp.html\">Enable multi-user web, in-app, and video calling</a>.</p>",
88318834
"smithy.api#http": {
88328835
"method": "POST",
88338836
"uri": "/contact/create-participant",
@@ -8848,7 +8851,7 @@
88488851
"ContactId": {
88498852
"target": "com.amazonaws.connect#ContactId",
88508853
"traits": {
8851-
"smithy.api#documentation": "<p>The identifier of the contact in this instance of Amazon Connect. Only contacts in the CHAT channel are supported.</p>",
8854+
"smithy.api#documentation": "<p>The identifier of the contact in this instance of Amazon Connect. Supports contacts in the CHAT channel and VOICE (WebRTC) channels. \n For WebRTC calls, this should be the initial contact ID that was generated when \n the contact was first created (from the StartWebRTCContact API) in the VOICE channel</p>",
88528855
"smithy.api#required": {}
88538856
}
88548857
},
@@ -8862,7 +8865,7 @@
88628865
"ParticipantDetails": {
88638866
"target": "com.amazonaws.connect#ParticipantDetailsToAdd",
88648867
"traits": {
8865-
"smithy.api#documentation": "<p>Information identifying the participant.</p>\n <important>\n <p>The only Valid value for <code>ParticipantRole</code> is <code>CUSTOM_BOT</code>. </p>\n <p>\n <code>DisplayName</code> is <b>Required</b>.</p>\n </important>",
8868+
"smithy.api#documentation": "<p>Information identifying the participant.</p>\n <important>\n <p>The only valid value for <code>ParticipantRole</code> is <code>CUSTOM_BOT</code> \n for chat contact and <code>CUSTOMER</code> for voice contact.</p>\n </important>",
88668869
"smithy.api#required": {}
88678870
}
88688871
}
@@ -19139,7 +19142,7 @@
1913919142
}
1914019143
],
1914119144
"traits": {
19142-
"smithy.api#documentation": "<p>Gets the real-time metric data from the specified Amazon Connect instance.</p>\n <p>For a description of each metric, see <a href=\"https://docs.aws.amazon.com/connect/latest/adminguide/metrics-definitions.html\">Metrics definitions</a> in the\n <i>Amazon Connect Administrator Guide</i>.</p>\n <note>\n <p>When you make a successful API request, you can expect the following metric values in the response:</p>\n <ol>\n <li>\n <p>\n <b>Metric value is null</b>: The calculation cannot be performed due to divide by zero or insufficient data</p>\n </li>\n <li>\n <p>\n <b>Metric value is a number (including 0) of defined type</b>: The number provided is the calculation result</p>\n </li>\n <li>\n <p>\n <b>MetricResult list is empty</b>: The request cannot find any data in the system</p>\n </li>\n </ol>\n <p>The following guidelines can help you work with the API:</p>\n <ul>\n <li>\n <p>Each dimension in the metric response must contain a value</p>\n </li>\n <li>\n <p>Each item in MetricResult must include all requested metrics</p>\n </li>\n <li>\n <p>If the response is slow due to large result sets, try these approaches:</p>\n <ul>\n <li>\n <p>Narrow the time range of your request</p>\n </li>\n <li>\n <p>Add filters to reduce the amount of data returned</p>\n </li>\n </ul>\n </li>\n </ul>\n </note>",
19145+
"smithy.api#documentation": "<p>Gets the real-time metric data from the specified Amazon Connect instance.</p>\n <p>For a description of each metric, see <a href=\"https://docs.aws.amazon.com/connect/latest/adminguide/metrics-definitions.html\">Metrics definitions</a> in the\n <i>Amazon Connect Administrator Guide</i>.</p>\n <note>\n <p>When you make a successful API request, you can expect the following metric values in the response:</p>\n <ol>\n <li>\n <p>\n <b>Metric value is null</b>: The calculation cannot be performed due to divide by zero or insufficient data</p>\n </li>\n <li>\n <p>\n <b>Metric value is a number (including 0) of defined type</b>: The number provided is the calculation result</p>\n </li>\n <li>\n <p>\n <b>MetricResult list is empty</b>: The request cannot find any data in the system</p>\n </li>\n </ol>\n <p>The following guidelines can help you work with the API:</p>\n <ul>\n <li>\n <p>Each dimension in the metric response must contain a value</p>\n </li>\n <li>\n <p>Each item in MetricResult must include all requested metrics</p>\n </li>\n <li>\n <p>If the response is slow due to large result sets, try these approaches:</p>\n <ul>\n <li>\n <p>Add filters to reduce the amount of data returned</p>\n </li>\n </ul>\n </li>\n </ul>\n </note>",
1914319146
"smithy.api#http": {
1914419147
"method": "POST",
1914519148
"uri": "/metrics/current/{InstanceId}",
@@ -28788,6 +28791,9 @@
2878828791
"traits": {
2878928792
"smithy.api#documentation": "<p>The display name of the participant.</p>"
2879028793
}
28794+
},
28795+
"ParticipantCapabilities": {
28796+
"target": "com.amazonaws.connect#ParticipantCapabilities"
2879128797
}
2879228798
},
2879328799
"traits": {

0 commit comments

Comments
 (0)